# LIPSCOSME Comments Scraper

Template to extract product comment information (Review tag, Number of likes, Review brief, etc.) from LIPSCOSME via URLs.

- Template page: [https://www.octoparse.com/template/lipscosme-comments-scraper](https://www.octoparse.com/template/lipscosme-comments-scraper)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from comment pages.

## Output

The current workflow extracts 11 fields, including `Number_of_likes`, `Number_of_quote`, `Picture_URL_1`, `Picture_URL_2`, `Picture_URL_3`, `Publishing_date`, `Review_URL`, `Review_brief`, `Reviewer_tag_1`, `Reviewer_tag_2`, `Reviewer_tag_3`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete URL(up to 10,000 per run), Number of pages (1~100) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URL(up to 10,000 per run)

Required. 评论页URL，上限10000条/次，换行区分 Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=5000.

### Number of pages (1~100)

Optional. 设定评论页的翻页次数，每页采集50条，如不填采集全部

## How to Use

# LIPSCOSME Comments Scraper Usage Guide

## Overview
Collects product comment information from LIPSCOSME via URLs: review tags, number of likes, review brief, publishing date, review URL, and picture URLs.

Data source: [Lipscosme](https://cloudflare.lipscosme.com/)

## Pricing
This template currently has no per-line charge. Octoparse plan or resource limits may still apply.

## Output
Returns fields including:

- `Reviewer_tag_1`
- `Reviewer_tag_2`
- `Reviewer_tag_3`
- `Number_of_likes`
- `Number_of_quote`
- `Publishing_date`
- `Review_brief`
- `Review_URL`
- `Picture_URL_1`
- `Picture_URL_2`
- `Picture_URL_3`

`Picture_URL_1`, `Picture_URL_2`, and `Picture_URL_3` can be empty when the source record does not provide them.

## Input
- **URL (up to 10,000 per run)** (required): Enter one or more values, one per line.
- **Number of pages (1~100)** (optional): Enter a number.

## How to Use
1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

## Scheduling and API Access
- Schedule recurring runs locally or in the cloud.
- Keep your computer and Octoparse open for local scheduled runs.
- Export rows to CSV, Excel, JSON, databases, or cloud storage.
- Send data to reporting and AI workflows through Octoparse APIs or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).
- Scheduling and API access may require a paid Octoparse plan.

## Limitations
- Collects only the fields listed from comments pages; it does not add data that Lipscosme does not display.
- Picture URL fields may be empty when unavailable.

## Tips
- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid URL to reduce unrelated or duplicate records.
- When available, use a stable URL or identifier as the deduplication key.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [LIPSCOSME Product Info Scraper](https://www.octoparse.com/template/lipscosme-product-info-scraper)
- [YouTube Details & Comments Scraper (Free)](https://www.octoparse.com/template/youtube-details-comments-scraper-free)
- [Twitter (X) Comments Scraper](https://www.octoparse.com/template/tweets-comments-scraper-by-search-result-url)
- [TikTok Video Details & Comments Scraper](https://www.octoparse.com/template/tiktok-video-comments-scraper)
- [YouTube Comments & Replies Scraper](https://www.octoparse.com/template/youtube-comments-replies-scraper)

## Input Schema

```json
{
  "title": "LIPSCOSME Comments Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRL": {
      "title": "URL(up to 10,000 per run)",
      "description": "评论页URL，上限10000条/次，换行区分",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_pages": {
      "title": "Number of pages (1~100)",
      "description": "设定评论页的翻页次数，每页采集50条，如不填采集全部",
      "type": "integer",
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRL"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "number_of_pages": 2,
  "uRL": [
    "https://lipscosme.com/products/497682/review"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Number_of_likes": {
      "type": "string",
      "description": ""
    },
    "Number_of_quote": {
      "type": "string",
      "description": ""
    },
    "Picture_URL_1": {
      "type": "string",
      "description": ""
    },
    "Picture_URL_2": {
      "type": "string",
      "description": ""
    },
    "Picture_URL_3": {
      "type": "string",
      "description": ""
    },
    "Publishing_date": {
      "type": "string",
      "description": ""
    },
    "Review_URL": {
      "type": "string",
      "description": ""
    },
    "Review_brief": {
      "type": "string",
      "description": ""
    },
    "Reviewer_tag_1": {
      "type": "string",
      "description": ""
    },
    "Reviewer_tag_2": {
      "type": "string",
      "description": ""
    },
    "Reviewer_tag_3": {
      "type": "string",
      "description": ""
    }
  },
  "title": "LIPSCOSME Comments Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Number_of_likes": "119",
  "Number_of_quote": "3",
  "Picture_URL_1": "https://cloudflare.lipscosme.com/image/bd0ad18928f0d2beb6d3fa2d-1721341773.png?auto=avif%2Cwebp&fio=1&orient=1&width=430",
  "Picture_URL_2": "https://cloudflare.lipscosme.com/image/f5e4aa3c45dc5200720851d5-1721341773.png?auto=avif%2Cwebp&fio=1&orient=1&width=430",
  "Picture_URL_3": "https://cloudflare.lipscosme.com/image/4ffc20d496256c8d9a0c73d0-1721341773.png?auto=avif%2Cwebp&fio=1&orient=1&width=430",
  "Publishing_date": "2024.07.19",
  "Review_URL": "https://lipscosme.com/products/497682/review",
  "Review_brief": "79%水分ベース🚰 緩めのテクスチャーで伸びがよく、白浮きもないから使いやすいです。 鎮静と水分なので敏感肌や乾燥肌の人に特にオススメな毎日使いやすい日焼け止めです☘️ 私はからだ用です。 ハーブのような爽やかな香り付きです。",
  "Reviewer_tag_1": "珈琲豆♡",
  "Reviewer_tag_2": "乾燥肌",
  "Reviewer_tag_3": "ブルベ夏"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "lipscosme-comments-scraper",
  "taskName": "LIPSCOSME Comments Scraper",
  "parameters": "{\"number_of_pages\":2,\"uRL\":[\"https://lipscosme.com/products/497682/review\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"number_of_pages\":2,\"uRL\":[\"https://lipscosme.com/products/497682/review\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "lipscosme-comments-scraper",
        "taskName": "LIPSCOSME Comments Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "lipscosme-comments-scraper",
  "taskName": "LIPSCOSME Comments Scraper",
  "parameters": "{\"number_of_pages\":2,\"uRL\":[\"https://lipscosme.com/products/497682/review\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `lipscosme-comments-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/lipscosme-comments-scraper.json)
- [Manifest](https://www.octoparse.com/templates/lipscosme-comments-scraper-manifest.json)
