概览
想快速拿到某个地区某类商家的名单和联系方式吗?给它一个搜索关键词,它会把地图上这个关键词下的商家一次性取回来,每条带名称、类别、地址、电话、官网、评分、评论数、营业时间和经纬度,可以直接导出成表格,接进你的客户系统或拓客名单。
做本地化拓客、门店盘点或渠道摸排时,最费时的往往是"一家家点开地图、把电话和地址抄下来"。这份数据把同一个关键词下的商家批量取回,电话、官网、地址和营业时间都带着,适合当作线索清洗、区域覆盖分析和电话拜访名单的原始底表。
数据说明
商家清单取自谷歌地图的公开搜索结果页,按该页原有的展示顺序返回,不做二次排序或去重。评分是商家在地图上展示的评分,满分 5 分;评论数是累计评价条数。电话与官网只在商家页展示时才有,部分商家没有这两项。营业时间按周一到周日逐日给出,每格同时带当天的日期;「当前状态」是取数当时商家的营业情况(如「Closed · Opens 7AM」)。经纬度是商家的实际位置,可用于地图标注或路线规划。「附加信息」是商家的经营属性标签(如女性经营、少数族裔经营),「无障碍设施」是轮椅可达的停车位或洗手间信息,两者都只有部分商家提供。只覆盖公开可见的商家,已关停或需登录才能看到的商家不在其中。数据为取数当时页面展示的快照,评分、评论数与营业状态会随时间变化。
结果长什么样
每条记录是一个商家:
| 商家名称 | 主类别 | 电话 | 评分 | 评论数 |
|---|---|---|---|---|
| 787 Coffee Co. | Coffee shop | (646) 454-0133 | 4.8 | 5858 |
| L B Coffee | Coffee shop | (646) 410-2818 | 4.9 | 391 |
另有「地址」「城市」「州/省」「官网」「营业时间(周一至周日)」「经纬度」「当前状态」等字段。
应用场景
- 做电话拓客时,用「电话」和「官网」拿到联系方式,按「城市」「州/省」分区域派单。
- 做区域覆盖分析时,把「纬度」「经度」投到地图上看商家分布疏密,判断哪片区域还是空白。
- 做门店选址参考时,用「评分」和「评论数」挑出人气旺的商圈,再看同类商家在旁边扎堆的情况。
- 做拜访排期时,按「营业时间」和「当前状态」避开休息日,把外勤路线排在同一天营业的商家上。
适用边界
单次任务处理 1 个搜索关键词,采集条数上限默认 3 条、可上调(越大耗时与费用越高);仅覆盖页面公开展示的商家信息,部分商家缺少官网、电话或附加信息。
- 适合用于
- 需要按关键词批量获取某地区某类商家的线索清单时
- 需要商家的名称、类别、地址、电话、官网、评分与营业时间做本地化拓客或门店盘点时
- 不要用于
- 需要按已知的地图链接采集而非按关键词搜索时——用按链接采集的地图应用
- 需要秒级返回结果时——本应用在后台执行采集,完成时间取决于商家数量与页数
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1部分数据获取是异步返回的:商家较多时,采集会耗时较长、无法立即返回;请耐心等待抓取完成,任务状态显示「运行中」表示仍在采集,并非异常
- 2任务失败属可重试错误,可原样重新提交
- 3返回空结果通常是关键词过于生僻或该地区无可采集商家,换成「品类 + 地点」的写法重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| keyword | 搜索关键词 | string | 是 | — | — | coffee shops in New York | 在地图上要搜索的关键词,建议写成「品类 + 地点」的形式,例如 coffee shops in New York;请填写真实可检索的关键词 |
| page_turns | 翻页次数 | integer | 否 | 1 | 1– | — | 在首个结果页之外继续向下翻页的次数,不填默认 1 次;次数越多耗时和费用越高 |
| max_collected_rows | 采集条数上限 | integer | 否 | 3 | 1– | — | 本次任务最多采集多少条商家线索,不填默认 3 条,数值越大耗时和费用越高 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| title | 商家名称 | string | 787 Coffee Co. | 商家在地图上展示的名称 |
| category_listing | 主类别 | string | Coffee shop | 商家在列表页展示的主要类别 |
| category_detail | 细分类别 | string | Coffee shop | 商家详情页展示的类别 |
| address | 地址 | string | 251 W 30th St, New York, NY 10001 | 商家的完整街道地址 |
| city | 城市 | string | New York | 商家所在城市 |
| state | 州/省 | string | New York | 商家所在的州或省级行政区 |
| country | 国家 | string | US | 商家所在国家或地区的代码 |
| phone | 电话 | string | (646) 454-0133 | 商家的联系电话,部分商家没有 |
| website | 官网 | string | http://www.787coffee.com/ | 商家官网链接,部分商家没有 |
| rating | 评分 | string | 4.8 | 商家在地图上展示的评分,5 分制 |
| review_count | 评论数 | string | 5858 | 商家的累计评价条数 |
| current_status | 当前状态 | string | Closed · Opens 7AM | 取数当时商家的营业状态,如「Closed · Opens 7AM」 |
| open_time_monday | 周一营业时间 | string | Monday 1 7AM–8PM 2026-9-14 | 周一当天的营业时间与日期 |
| open_time_tuesday | 周二营业时间 | string | Tuesday 2 7AM–8PM 2026-9-15 | 周二当天的营业时间与日期 |
| open_time_wednesday | 周三营业时间 | string | Wednesday 3 7AM–8PM 2026-9-16 | 周三当天的营业时间与日期 |
| open_time_thursday | 周四营业时间 | string | Thursday 4 7AM–8PM 2026-9-17 | 周四当天的营业时间与日期 |
| open_time_friday | 周五营业时间 | string | Friday 5 7AM–8PM 2026-9-11 | 周五当天的营业时间与日期 |
| open_time_saturday | 周六营业时间 | string | Saturday 6 7AM–8PM 2026-9-12 | 周六当天的营业时间与日期 |
| open_time_sunday | 周日营业时间 | string | Sunday 7 8AM–8PM 2026-9-13 | 周日当天的营业时间与日期 |
| plus_code | Plus Code | string | P2X4+P7 New York | 商家的 Plus Code 位置编码 |
| plus_code_url | Plus Code 链接 | string | https://plus.codes/P2X4+P7 New York | Plus Code 对应的定位链接 |
| google_id | Google ID | string | 0x89c259a171bd55e3:0x92a55ea34c9f9354 | 商家在地图上的标识,十六进制键值对形式 |
| place_id | 地点 ID | string | ChIJ41W9caFZwokRVJOfTKNepZI | 商家在地图上的唯一地点标识 |
| latitude | 纬度 | string | 40.7493629 | 商家所在地点的纬度 |
| longitude | 经度 | string | -73.9942691 | 商家所在地点的经度 |
| main_image | 主图 | string | https://lh3.googleusercontent.com/gps-cs-s/AHRPTWkOsZ8N7i_3JXSlnHI7HdfrJV8F8xhiFLPpXPHGaT7SOxF7-2lyUYcOabd4jijOkjicVFVmwdZXrs07nVepUJMQwjGcVyaS-E-yX8TWpAkkY6KxCOXZJQry1ItlYxvaydYBY8N1RQ=w426-h240-k-no | 商家在地图上展示的主图链接 |
| additional_info | 附加信息 | string | Identifies as Latino-owned,Identifies as LGBTQ+ owned | 商家页展示的属性标签,多个以逗号并列,部分商家没有 |
| accessibility | 无障碍设施 | string | Wheelchair accessible restroom | 商家的无障碍设施信息,如轮椅可达的停车位或洗手间,部分商家没有 |
记录 Schema
输出按记录逐条返回。记录主键为 place_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"title": {
"type": "string",
"title": "商家名称",
"description": "商家在地图上展示的名称",
"prefill": "787 Coffee Co."
},
"category_listing": {
"type": "string",
"title": "主类别",
"description": "商家在列表页展示的主要类别",
"prefill": "Coffee shop"
},
"category_detail": {
"type": "string",
"title": "细分类别",
"description": "商家详情页展示的类别",
"prefill": "Coffee shop"
},
"address": {
"type": "string",
"title": "地址",
"description": "商家的完整街道地址",
"prefill": "251 W 30th St, New York, NY 10001"
},
"city": {
"type": "string",
"title": "城市",
"description": "商家所在城市",
"prefill": "New York"
},
"state": {
"type": "string",
"title": "州/省",
"description": "商家所在的州或省级行政区",
"prefill": "New York"
},
"country": {
"type": "string",
"title": "国家",
"description": "商家所在国家或地区的代码",
"prefill": "US"
},
"phone": {
"type": "string",
"title": "电话",
"description": "商家的联系电话,部分商家没有",
"prefill": "(646) 454-0133"
},
"website": {
"type": "string",
"title": "官网",
"description": "商家官网链接,部分商家没有",
"prefill": "http://www.787coffee.com/"
},
"rating": {
"type": "string",
"title": "评分",
"description": "商家在地图上展示的评分,5 分制",
"prefill": "4.8"
},
"review_count": {
"type": "string",
"title": "评论数",
"description": "商家的累计评价条数",
"prefill": "5858"
},
"current_status": {
"type": "string",
"title": "当前状态",
"description": "取数当时商家的营业状态,如「Closed · Opens 7AM」",
"prefill": "Closed · Opens 7AM"
},
"open_time_monday": {
"type": "string",
"title": "周一营业时间",
"description": "周一当天的营业时间与日期",
"prefill": "Monday 1 7AM–8PM 2026-9-14"
},
"open_time_tuesday": {
"type": "string",
"title": "周二营业时间",
"description": "周二当天的营业时间与日期",
"prefill": "Tuesday 2 7AM–8PM 2026-9-15"
},
"open_time_wednesday": {
"type": "string",
"title": "周三营业时间",
"description": "周三当天的营业时间与日期",
"prefill": "Wednesday 3 7AM–8PM 2026-9-16"
},
"open_time_thursday": {
"type": "string",
"title": "周四营业时间",
"description": "周四当天的营业时间与日期",
"prefill": "Thursday 4 7AM–8PM 2026-9-17"
},
"open_time_friday": {
"type": "string",
"title": "周五营业时间",
"description": "周五当天的营业时间与日期",
"prefill": "Friday 5 7AM–8PM 2026-9-11"
},
"open_time_saturday": {
"type": "string",
"title": "周六营业时间",
"description": "周六当天的营业时间与日期",
"prefill": "Saturday 6 7AM–8PM 2026-9-12"
},
"open_time_sunday": {
"type": "string",
"title": "周日营业时间",
"description": "周日当天的营业时间与日期",
"prefill": "Sunday 7 8AM–8PM 2026-9-13"
},
"plus_code": {
"type": "string",
"title": "Plus Code",
"description": "商家的 Plus Code 位置编码",
"prefill": "P2X4+P7 New York"
},
"plus_code_url": {
"type": "string",
"title": "Plus Code 链接",
"description": "Plus Code 对应的定位链接",
"prefill": "https://plus.codes/P2X4+P7 New York"
},
"google_id": {
"type": "string",
"title": "Google ID",
"description": "商家在地图上的标识,十六进制键值对形式",
"prefill": "0x89c259a171bd55e3:0x92a55ea34c9f9354"
},
"place_id": {
"type": "string",
"title": "地点 ID",
"description": "商家在地图上的唯一地点标识",
"prefill": "ChIJ41W9caFZwokRVJOfTKNepZI"
},
"latitude": {
"type": "string",
"title": "纬度",
"description": "商家所在地点的纬度",
"prefill": "40.7493629"
},
"longitude": {
"type": "string",
"title": "经度",
"description": "商家所在地点的经度",
"prefill": "-73.9942691"
},
"main_image": {
"type": "string",
"title": "主图",
"description": "商家在地图上展示的主图链接",
"prefill": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWkOsZ8N7i_3JXSlnHI7HdfrJV8F8xhiFLPpXPHGaT7SOxF7-2lyUYcOabd4jijOkjicVFVmwdZXrs07nVepUJMQwjGcVyaS-E-yX8TWpAkkY6KxCOXZJQry1ItlYxvaydYBY8N1RQ=w426-h240-k-no"
},
"additional_info": {
"type": "string",
"title": "附加信息",
"description": "商家页展示的属性标签,多个以逗号并列,部分商家没有",
"prefill": "Identifies as Latino-owned,Identifies as LGBTQ+ owned"
},
"accessibility": {
"type": "string",
"title": "无障碍设施",
"description": "商家的无障碍设施信息,如轮椅可达的停车位或洗手间,部分商家没有",
"prefill": "Wheelchair accessible restroom"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"WW_Yang__google-maps-leads-keyword": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=WW_Yang/google-maps-leads-keyword",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。