概览
输入关键词或雅虎日本地图(Yahoo!地図)页面链接,采集地图搜索结果中的地点条目:地点名称、类型、评分、评论数、地址、电话、营业时间、官方网站等。
⚠️ 关于输出字段的说明:上游八爪鱼模板 3419 声明的
outputSchema仍为评价类字段(商品名 / ID / 商品ページURL / レビュー 等),但模板实际采集并返回的字段是地图条目类(場所名_店名 / タイプ / レビュー点数 / アドレス 等)。本契约按 preflight 实测(用真实 URL 跑了一次任务并按 anchor 导出数据)的实际采集字段生成output_schema.json与field_map,确保 Data App 运行结果能正常返回非空数据。如上游模板outputSchema后续被修复为与实际字段一致,可重新生成契约对齐。
输入参数
| 参数 | 必填 | 说明 | 默认 |
|---|---|---|---|
| keyword_or_url | 是 | 搜索关键词(如「ラーメン」「東京駅」)或 Yahoo!地図 页面链接(map.yahoo.co.jp 域名) | - |
| max_pages | 否 | 最大采集页数(一页约 20 条) | 1 |
| max_collected_rows | 否 | 采集条数上限 | 3 |
两种输入模式任选其一,一次任务提交一条:
- 关键词模式:
"keyword_or_url": "東京駅" - URL 模式:
"keyword_or_url": "https://map.yahoo.co.jp/search?q=%E3%83%A9%E3%83%BC%E3%83%A1%E3%83%B3"
输出字段
| 字段 | 说明 |
|---|---|
| place_name | 地点/店铺名称(原始字段「場所名_店名」,日文原文) |
| place_type | 地点类型(原始字段「タイプ」,如「ラーメン」) |
| review_score | 用户评分(原始字段「レビュー点数」) |
| review_count | 评论条数(原始字段「クチコミ件数」) |
| place_url | 地点详情页链接(原始字段「URL」,作为唯一标识) |
| address | 地址(原始字段「アドレス」,日文原文) |
| business_hours | 营业时间(原始字段「営業時間帯」) |
| phone_number | 电话号码(原始字段「電話番号」) |
| official_website | 官方网站(原始字段「公式サイト」) |
| official_sns | 官方 SNS(原始字段「公式SNS」) |
使用示例
以搜索页链接为输入,翻 1 页、最多返回 3 条:
{
"keyword_or_url": "https://map.yahoo.co.jp/search?q=%E3%83%A9%E3%83%BC%E3%83%A1%E3%83%B3",
"max_pages": 1,
"max_collected_rows": 3
}
示例输出(preflight 实测):
| place_name | place_type | address |
|---|---|---|
| お父さんのラーメン | ラーメン | 静岡県静岡市葵区柚木 MARK IS 静岡 3F |
定价
按返回记录条数计费:0.0001 元/条(上游模板免费,按默认 record 事件单价折算)。
失败处理
- 任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成。
- 任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务。
- 任务失败属可重试错误,可原样重新提交。
适用边界
单次任务提交一个关键词或一条雅虎日本地图页面链接,返回地图搜索结果中的地点条目列表;条数上限默认 3 条、可上调(越大耗时与费用越高)。内容为页面展示的日文原文。
- 适合用于
- 需要按关键词批量获取雅虎日本地图上的地点条目(名称、地址、评分、评论数)时
- 做日本本地商户调研、门店分布梳理时
- 需要围绕某个地点页链接采集其周边或关联地点信息时
- 不要用于
- 需要中文翻译后的结果时——本 App 返回页面原始日文
- 需要 Google Maps、百度地图等其他地图平台数据时——本 App 只覆盖雅虎日本地图单一数据源
- 需要地图瓦片、经纬度轨迹等地理信息工程数据时——本 App 只返回搜索结果条目
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成
- 2任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务
- 3任务失败属可重试错误,可原样重新提交
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 关键词或 URL
keyword_or_url必填string雅虎日本地图(Yahoo!地図)的搜索词或页面链接。两种模式任选其一:1)关键词模式:直接填写搜索关键词(如「ラーメン」「東京駅」);2)URL 模式:粘贴完整的 Yahoo!地図 页面链接(map.yahoo.co.jp 域名,含 query 参数)。一次任务填写一条。示例https://map.yahoo.co.jp/search?q=%E3%83%A9%E3%83%BC%E3%83%A1%E3%83%B3 - 最大采集页数
max_pages选填integer在搜索结果中最多翻多少页后停止;不填默认 1 页。一页通常约 20 条地点。范围1–100默认值1 - 采集条数上限
max_collected_rows选填integer本次任务最多返回的数据条数;不填默认 3 条,数值越大耗时和费用越高。范围1–20000默认值3
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 地点名称
place_namestring雅虎日本地图搜索结果中的地点/店铺名称(原始字段「場所名_店名」,日文原文) - 类型
place_typestring地点分类,如「ラーメン」「レストラン」等(原始字段「タイプ」) - 评分
review_scorestring用户评分或点评分数(原始字段「レビュー点数」) - 评论数
review_countstring该地点的口コミ/评论条数(原始字段「クチコミ件数」)
调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/yahoo-japan-map",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。