# Yahoo!Japan Map Scraper

This is a template for extracting location names, addresses, business hours, and more from Yahoo! Maps.

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

## 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 detail pages.

## Output

The current workflow extracts 10 fields, including `URL`, `アドレス`, `クチコミ件数`, `タイプ`, `レビュー点数`, `公式SNS`, `公式サイト`, `営業時間帯`, `場所名_店名`, `電話番号`.

## 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 Search Keywords or URLs (up to 1,000 per run), Max Pages to Scrape (Optional) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Search Keywords or URLs (up to 1,000 per run)

Required. Search Keywords or URLs Constraints: minItems=1; maxItems=1000.

### Max Pages to Scrape (Optional)

Optional. Max Pages to Scrape (Optional) Constraints: minimum=, maximum=2000.

## How to Use

## Yahoo! Japan Map Scraper

Scrapes [Yahoo! Maps Japan](https://map.yahoo.co.jp/) search results by keyword or URL. Returns place names, business types, ratings, review counts, addresses, opening hours, phone numbers, official websites, social links, and source URLs.

### Input

- **Search Keywords or URLs** (required)  
  Enter up to 1,000 Yahoo! Maps keywords or full search-results URLs, one per line.

- **Max Pages to Scrape (Optional)**  
  Enter a number up to 2,000. Leave blank to scrape all available pages.

### Output Fields

- `場所名_店名` – Place / store name  
- `タイプ` – Business type  
- `レビュー点数` – Rating score  
- `クチコミ件数` – Review count  
- `URL` – Source URL  
- `アドレス` – Address  
- `営業時間帯` – Business hours  
- `電話番号` – Phone number  
- `公式サイト` – Official website  
- `公式SNS` – Official social media link

### Limitations

- Collects only public place/business information from Yahoo! Maps Japan search results; no route directions or navigation data.
- Some fields (ratings, review counts, hours, phone, website, social links) may be empty if the listing does not publish them.
- Maximum 1,000 search keywords/URLs per run; Max Pages to Scrape cannot exceed 2,000.
- Search coverage and returned listings may change as Yahoo! Maps Japan updates its results and layout.

### How to Use

1. Open the template and select **Try it** or **Start**.
2. Enter your search keywords or URLs and optionally set the max pages.
3. Run the task in the cloud.
4. Review the output rows. Export to CSV, Excel, JSON, databases, or cloud storage, or send to reporting/AI workflows via Octoparse APIs (including [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates)). Scheduling and API access may require a paid Octoparse plan.

### Tips

- Use location-qualified keywords (e.g., service + city) to reduce unrelated results.
- Start with a small page limit to confirm the returned categories before scaling.
- Deduplicate records by source URL, phone number, or official website when different searches return the same business.

## 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)
- [Kakao Map Shop List Scraper](https://www.octoparse.com/template/kakao-map-store-list-scraper)
- [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)
- [Yahoo Search Scraper](https://www.octoparse.com/template/yahoo-search-scraper)

## Input Schema

```json
{
  "title": "Yahoo!Japan Map Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "search_Keywords_or_URLs": {
      "title": "Search Keywords or URLs (up to 1,000 per run)",
      "description": "Search Keywords or URLs",
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "max_Pages_to_Scrape": {
      "title": "Max Pages to Scrape (Optional)",
      "description": "Max Pages to Scrape (Optional)",
      "type": "integer",
      "maximum": 2000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "search_Keywords_or_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "search_Keywords_or_URLs": [
    "渋谷 カフェ"
  ]
}
```

Example 2

```json
{
  "search_Keywords_or_URLs": [
    "https://map.yahoo.co.jp/search?q=%E7%B5%A6%E6%B9%AF%E5%99%A8%20%E6%A8%AA%E6%B5%9C%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E7%B5%A6%E6%B9%AF%E5%99%A8%20%E5%A4%A7%E9%98%AA%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E7%B5%A6%E6%B9%AF%E5%99%A8%20%E5%90%8D%E5%8F%A4%E5%B1%8B%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E7%B5%A6%E6%B9%AF%E5%99%A8%20%E6%9C%AD%E5%B9%8C%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E7%B5%A6%E6%B9%AF%E5%99%A8%20%E7%A5%9E%E6%88%B8%E5%B8%82"
  ]
}
```

Example 3

```json
{
  "max_Pages_to_Scrape": 1,
  "search_Keywords_or_URLs": [
    "東京 ラーメン"
  ]
}
```

Example 4

```json
{
  "search_Keywords_or_URLs": [
    "https://map.yahoo.co.jp/search?q=%E3%83%90%E3%83%AC%E3%82%A8%E6%95%99%E5%AE%A4%20%E6%A8%AA%E6%B5%9C%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%90%E3%83%AC%E3%82%A8%E6%95%99%E5%AE%A4%20%E5%A4%A7%E9%98%AA%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%90%E3%83%AC%E3%82%A8%E6%95%99%E5%AE%A4%20%E5%90%8D%E5%8F%A4%E5%B1%8B%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%90%E3%83%AC%E3%82%A8%E6%95%99%E5%AE%A4%20%E6%9C%AD%E5%B9%8C%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%90%E3%83%AC%E3%82%A8%E6%95%99%E5%AE%A4%20%E7%A5%9E%E6%88%B8%E5%B8%82"
  ]
}
```

Example 5

```json
{
  "search_Keywords_or_URLs": [
    "https://map.yahoo.co.jp/search?q=%E3%83%95%E3%82%A9%E3%83%88%E3%82%B9%E3%82%BF%E3%82%B8%E3%82%AA%20%E6%A8%AA%E6%B5%9C%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%95%E3%82%A9%E3%83%88%E3%82%B9%E3%82%BF%E3%82%B8%E3%82%AA%20%E5%A4%A7%E9%98%AA%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%95%E3%82%A9%E3%83%88%E3%82%B9%E3%82%BF%E3%82%B8%E3%82%AA%20%E5%90%8D%E5%8F%A4%E5%B1%8B%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%95%E3%82%A9%E3%83%88%E3%82%B9%E3%82%BF%E3%82%B8%E3%82%AA%20%E6%9C%AD%E5%B9%8C%E5%B8%82",
    "https://map.yahoo.co.jp/search?q=%E3%83%95%E3%82%A9%E3%83%88%E3%82%B9%E3%82%BF%E3%82%B8%E3%82%AA%20%E7%A5%9E%E6%88%B8%E5%B8%82"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "URL": {
      "type": "string",
      "description": ""
    },
    "アドレス": {
      "type": "string",
      "description": ""
    },
    "クチコミ件数": {
      "type": "string",
      "description": ""
    },
    "タイプ": {
      "type": "string",
      "description": ""
    },
    "レビュー点数": {
      "type": "string",
      "description": ""
    },
    "公式SNS": {
      "type": "string",
      "description": ""
    },
    "公式サイト": {
      "type": "string",
      "description": ""
    },
    "営業時間帯": {
      "type": "string",
      "description": ""
    },
    "場所名_店名": {
      "type": "string",
      "description": ""
    },
    "電話番号": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Yahoo!Japan Map 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.yahoo.co.jp/v3/place/dXDZz6d2pxE",
  "アドレス": "東京都渋谷区渋谷2-23-16 東口地下広場 B2F",
  "クチコミ件数": "169",
  "タイプ": "カフェ・喫茶",
  "レビュー点数": "3.94",
  "公式SNS": "https://www.instagram.com/uplight_coffee",
  "公式サイト": "https://transitoperationservice.com/our_brands/uplight-coffee/",
  "営業時間帯": "[月] 09:00-21:00（L.O. 20:30） / [火] 09:00-21:00（L.O. 20:30） / [水] 09:00-21:00（L.O. 20:30） / [木] 09:00-21:00（L.O. 20:30） / [金] 09:00-21:00（L.O. 20:30） / [土] 09:00-21:00（L.O. 20:30） / [日] 09:00-21:00（L.O. 20:30）",
  "場所名_店名": "UPLIGHT COFFEE",
  "電話番号": "03-6324-2739"
}
```

Example 2

```json
{
  "URL": "https://map.yahoo.co.jp/v3/place/ADS3nU68ghM",
  "アドレス": "北海道札幌市手稲区前田十条19-2-13",
  "クチコミ件数": "1",
  "タイプ": "リフォーム業",
  "レビュー点数": "3",
  "公式SNS": "https://line.me/R/ti/p/@769bxbav",
  "公式サイト": "http://houseplan-m.com/",
  "営業時間帯": "火 9:00-18:00 / 水 9:00-18:00 / 木 9:00-18:00 / 金 9:00-18:00 / 土 9:00-18:00 / 月 9:00-18:00",
  "場所名_店名": "株式会社ハウスプラン",
  "電話番号": "011-681-1037"
}
```

Example 3

```json
{
  "URL": "https://map.yahoo.co.jp/v3/place/P2EwCkPbeyw",
  "アドレス": "東京都港区赤坂５丁目３－１",
  "クチコミ件数": "35",
  "タイプ": "ラーメン",
  "レビュー点数": "3.85",
  "公式SNS": "",
  "公式サイト": "https://ramenmozu.group/",
  "営業時間帯": "[月] 11:00-23:00（L.O. 22:30） / [火] 11:00-23:00（L.O. 22:30） / [水] 11:00-23:00（L.O. 22:30） / [木] 11:00-23:00（L.O. 22:30） / [金] 11:00-23:00（L.O. 22:30） / [土] 11:00-23:00（L.O. 22:30） / [日] 11:00-23:00（L.O. 22:30） / [祝日] 11:00-23:00（L.O. 22:30） / [祝前日] 11:00-23:00（L.O. 22:30） / [祝後日] / 11:00-23:00（L.O. 22:30）",
  "場所名_店名": "ラーメン百舌鳥",
  "電話番号": "03-6277-8238"
}
```

Example 4

```json
{
  "URL": "https://map.yahoo.co.jp/v3/place/P51Dq0nvGI2",
  "アドレス": "神奈川県横浜市港南区港南台４丁目２４－９",
  "クチコミ件数": "0",
  "タイプ": "バレエ教室",
  "レビュー点数": "4.25",
  "公式SNS": "",
  "公式サイト": "http://www.kimika-ballet.com",
  "営業時間帯": "OPEN: 10:00-21:00（定休日：火・祝）",
  "場所名_店名": "アトリエ・ドゥ・バレエ木村公香",
  "電話番号": "045-833-0571"
}
```

Example 5

```json
{
  "URL": "https://map.yahoo.co.jp/v3/place/9OlzHmlSxHw",
  "アドレス": "神奈川県横浜市港北区新横浜3-1-4 プラスタリアビル 6F",
  "クチコミ件数": "67",
  "タイプ": "写真館",
  "レビュー点数": "4.96",
  "公式SNS": "https://www.instagram.com/cocoashinyokohama / https://twitter.com/cocoashinyoko / https://www.facebook.com/cocoayokohamakonan / https://www.tiktok.com/@studiococoa_official / https://youtube.com/studiococoaTV / https://line.me/R/ti/p/@cocoa",
  "公式サイト": "https://studio-cocoa.com/studio/shin-yokohama/index.html",
  "営業時間帯": "月 10:00-19:00 / 火 定休日 / 水 定休日 / 木 10:00-19:00 / 金 10:00-19:00 / 土 10:00-19:00 / 日 10:00-19:00 / 祝日 10:00-19:00 / 祝前日 10:00-20:00 / 毎週火曜日・水曜日は定休日となります。 / 定休日が祝日にあたる日は営業日となり、営業時間は10:00-19:00となります。 / 他、店舗により不定期にて臨時休業あるいは、臨時営業日を設けております。 / 詳細は最寄りのフォトスタジオCocoaへお問い合わせください。",
  "場所名_店名": "スタジオCocoa 新横浜店",
  "電話番号": "045-620-4358"
}
```

## 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": "yahoo-japan-map-scraper",
  "taskName": "Yahoo!Japan Map Scraper",
  "parameters": "{\"search_Keywords_or_URLs\":[\"渋谷 カフェ\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"search_Keywords_or_URLs\":[\"渋谷 カフェ\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "yahoo-japan-map-scraper",
        "taskName": "Yahoo!Japan Map 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": "yahoo-japan-map-scraper",
  "taskName": "Yahoo!Japan Map Scraper",
  "parameters": "{\"search_Keywords_or_URLs\":[\"渋谷 カフェ\"]}"
}
JSON
```

## MCP Setup

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