# Naver Map Scraper(by Keyword)

Scrape store/shop list(store, star rating, address, contact number, open, etc.) from Naver Map by Keyword.

- Template page: [https://www.octoparse.com/template/naver-map-scraper](https://www.octoparse.com/template/naver-map-scraper)
- Categories: Others
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$0.6/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## 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 general web pages.

## Output

The current workflow extracts 14 fields, including `가게이름`, `가까운교통`, `검색어`, `공유링크`, `방문자_리뷰수`, `방송출연`, `블로그_리뷰수`, `연락처`, `영업상태`, `영업시간`, `전체평점`, `주소`, `카테고리`, `편이점`.

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

## Input

### keyword(up to 20)

Required. 동대문 돈까스 홍대 백반집 Constraints: minItems=1; maxItems=5000; items.minLength=1; items.maxLength=10000.

## How to Use

# Naver Map Scraper (by Keyword)

Collects store/shop list (name, rating, address, contact, hours, etc.) from Naver Map by keyword. Data source: [NAVER](https://map.naver.com/).

## Input

- **keyword (up to 20)** (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 field above.
3. Run the task in the cloud.
4. Review the output rows and export or process the structured data.

## Output Fields

`공유링크`, `가게이름`, `카테고리`, `영업상태`, `전체평점`, `블로그 리뷰수`, `방문자 리뷰수`, `주소`, `가까운교통`, `영업시간`, `연락처`, `편이점`, `방송출연`, `검색어`

## Pricing

**$0.6 / 1,000 lines** – billed on the number of output lines produced by the task.

## Limitations

- Collects only fields listed in Output from search results pages; does not add data that NAVER does not display.
- Fields such as `편이점`, `방송출연`, and `검색어` may 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 the task.
- Use the most specific valid keyword (up to 20) to reduce unrelated or duplicate records.
- Use a stable identifier from `공유링크`, `가게이름`, or `주소` as a deduplication key when available.

## 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 Review Scraper](https://www.octoparse.com/template/naver-map-review-scraper)
- [Airbnb Scraper (by Keyword)](https://www.octoparse.com/template/airbnb-scraper-by-keyword)
- [Shein Scraper (Product Listing by Keyword)](https://www.octoparse.com/template/shein-scraper-product-listing-by-keyword)
- [eBay Spain Product Listing Scraper (by Keyword)](https://www.octoparse.com/template/ebay-listados-scraper)
- [Google Shopping Price Monitor (by Keyword)](https://www.octoparse.com/template/google-shopping-price-monitor-by-keyword)

## Input Schema

```json
{
  "title": "Naver Map Scraper(by Keyword) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "title": "keyword(up to 20)",
      "description": "동대문 돈까스\n홍대 백반집",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 5000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "keyword"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "keyword": [
    "동대문 돈까스",
    "홍대 백반집"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "가게이름": {
      "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 Scraper(by Keyword) 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
{
  "가게이름": "문숙이미나리식당 홍대본점",
  "가까운교통": "홍대입구역 9번 출구에서 569m",
  "검색어": "홍대 백반집",
  "공유링크": "https://map.naver.com/p/entry/place/36342218",
  "방문자_리뷰수": "2006",
  "방송출연": "생방송투데이 1735회, 연탄돼지불고기/고추장돼지불고기16.10.13.2016년 10월 13일 방영",
  "블로그_리뷰수": "0",
  "연락처": "0507-1416-2827",
  "영업상태": "영업 중",
  "영업시간": "영업 중 21:00에 영업 종료 매일 11:00-21:00",
  "전체평점": "4.55",
  "주소": "서울 마포구 잔다리로6길 34-5 1층",
  "카테고리": "백반,가정식",
  "편이점": "단체 이용 가능,무선 인터넷,포장,배달,예약,간편결제"
}
```

## 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-scraper",
  "taskName": "Naver Map Scraper(by Keyword)",
  "parameters": "{\"keyword\":[\"동대문 돈까스\",\"홍대 백반집\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"keyword\":[\"동대문 돈까스\",\"홍대 백반집\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "naver-map-scraper",
        "taskName": "Naver Map Scraper(by Keyword)",
        "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-scraper",
  "taskName": "Naver Map Scraper(by Keyword)",
  "parameters": "{\"keyword\":[\"동대문 돈까스\",\"홍대 백반집\"]}"
}
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-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-scraper.json)
- [Manifest](https://www.octoparse.com/templates/naver-map-scraper-manifest.json)
