# Naver Map Review Scraper

Scraper shop/store review(star rating, reviewer, follower, review content, etc.) from Naver Map by shop/store URL.

- Template page: [https://www.octoparse.com/template/naver-map-review-scraper](https://www.octoparse.com/template/naver-map-review-scraper)
- Categories: Maps
- 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 review pages.

## Output

The current workflow extracts 16 fields, including `가게이름`, `도입_URL`, `리뷰내용`, `리뷰작성수`, `리뷰작성자`, `리뷰작성자링크`, `방문시간`, `방문인증`, `방문자리뷰`, `방분횟수`, `블로그리뷰`, `이런_점이_좋아요`, `전체평점`, `첨부이미지`, `카테고리`, `팔로워`.

## 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 URLs(up to 100) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs(up to 100)

Required. Naver Map URL Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=5000.

## How to Use

# Naver Map Review Scraper Template Guide

## Overview
Collects shop/store reviews from Naver Map by store URL. Data is collected from [NAVER](https://m.place.naver.com/).

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

## Output
Returns structured store and review fields, including store name, category, overall rating, visitor review count, blog review count, reviewer name/link, review count, follower count, attached images, review content, positive highlights, visit time, visit count, and visit verification. Fields may be empty when the source record does not provide them.

## Input
- `URLs(up to 100)` (required): Enter one or more values, one per line.

## How to Use
1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Run the task locally.
4. Review the output rows and export or process the structured data.

## Running and Exporting
- Run locally with the Octoparse desktop app; keep your computer and Octoparse open while the task runs.
- Export rows to CSV, Excel, JSON, databases, or cloud storage, or send them to reporting and AI workflows through Octoparse APIs.
- Schedule recurring runs via Octoparse OpenAPI 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
- The scraper runs locally, so keep your computer and Octoparse open until the task is complete.
- Fields such as `방문시간`, `방분횟수`, and `방문인증` can be empty when the source record does not provide them.

## Tips
- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid URLs (up to 100) to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the returned fields as the deduplication key when available.

## Notes

로컬 디바이스 실행만 지원합니다.

## 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

- [Naver Map Scraper(by Keyword)](https://www.octoparse.com/template/naver-map-scraper)
- [Kakao Map Review Scraper](https://www.octoparse.com/template/kakao-map-review-scraper)
- [Kakao Map Shop List Scraper](https://www.octoparse.com/template/kakao-map-store-list-scraper)
- [Yahoo!Japan Map Scraper](https://www.octoparse.com/template/yahoo-japan-map-scraper)
- [Naver Search Scraper](https://www.octoparse.com/template/naver-news-scraper-keyword)

## Input Schema

```json
{
  "title": "Naver Map Review Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs": {
      "title": "URLs(up to 100)",
      "description": "Naver Map URL",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRLs": [
    "https://map.naver.com/p/search/%EC%BF%A0%EC%9A%B0%EC%BF%A0%EC%9A%B0%20%EA%B3%A8%EB%93%9C/place/1329885324?placePath=?entry=pll&from=nx&fromNxList=true&searchType=place"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "가게이름": {
      "type": "string",
      "description": ""
    },
    "도입_URL": {
      "type": "string",
      "description": ""
    },
    "리뷰내용": {
      "type": "string",
      "description": ""
    },
    "리뷰작성수": {
      "type": "string",
      "description": ""
    },
    "리뷰작성자": {
      "type": "string",
      "description": ""
    },
    "리뷰작성자링크": {
      "type": "string",
      "description": ""
    },
    "방문시간": {
      "type": "string",
      "description": ""
    },
    "방문인증": {
      "type": "string",
      "description": ""
    },
    "방문자리뷰": {
      "type": "string",
      "description": ""
    },
    "방분횟수": {
      "type": "string",
      "description": ""
    },
    "블로그리뷰": {
      "type": "string",
      "description": ""
    },
    "이런_점이_좋아요": {
      "type": "string",
      "description": ""
    },
    "전체평점": {
      "type": "string",
      "description": ""
    },
    "첨부이미지": {
      "type": "string",
      "description": ""
    },
    "카테고리": {
      "type": "string",
      "description": ""
    },
    "팔로워": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Naver Map Review 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
{
  "가게이름": "",
  "도입_URL": "https://map.naver.com/p/search/%EC%BF%A0%EC%9A%B0%EC%BF%A0%EC%9A%B0%20%EA%B3%A8%EB%93%9C/place/1329885324?placePath=?entry=pll&from=nx&fromNxList=true&searchType=place",
  "리뷰내용": "스시뿐만 아니라 핫푸드 코너, 바비큐, 피자, 그리고 디저트와 와플까지 먹을 게 너무 많아서 다 맛보지도 못하고 온 게 아쉽네요 ㅎㅎ 매장 내부도 넓고 깔끔해서 모임이나 가족 외식 장소로 제격입니다. 직원분들도 친절하시고 빈 접시를 바로바로 치워주셔서 편하게 잘 먹고 갑니다. 재방문 의사 200%예요!",
  "리뷰작성수": "113",
  "리뷰작성자": "식당reviewer",
  "리뷰작성자링크": "",
  "방문시간": "11.14.토",
  "방문인증": "인증 수단영수증",
  "방문자리뷰": "7,149",
  "방분횟수": "2번째 방문",
  "블로그리뷰": "",
  "이런_점이_좋아요": "",
  "전체평점": "",
  "첨부이미지": "",
  "카테고리": "",
  "팔로워": "2"
}
```

## 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": "naver-map-review-scraper",
  "taskName": "Naver Map Review Scraper",
  "parameters": "{\"uRLs\":[\"https://map.naver.com/p/search/%EC%BF%A0%EC%9A%B0%EC%BF%A0%EC%9A%B0%20%EA%B3%A8%EB%93%9C/place/1329885324?placePath=?entry=pll&from=nx&fromNxList=true&searchType=place\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"uRLs\":[\"https://map.naver.com/p/search/%EC%BF%A0%EC%9A%B0%EC%BF%A0%EC%9A%B0%20%EA%B3%A8%EB%93%9C/place/1329885324?placePath=?entry=pll&from=nx&fromNxList=true&searchType=place\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "naver-map-review-scraper",
        "taskName": "Naver Map Review 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": "naver-map-review-scraper",
  "taskName": "Naver Map Review Scraper",
  "parameters": "{\"uRLs\":[\"https://map.naver.com/p/search/%EC%BF%A0%EC%9A%B0%EC%BF%A0%EC%9A%B0%20%EA%B3%A8%EB%93%9C/place/1329885324?placePath=?entry=pll&from=nx&fromNxList=true&searchType=place\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `naver-map-review-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/naver-map-review-scraper.json)
- [Manifest](https://www.octoparse.com/templates/naver-map-review-scraper-manifest.json)
