概览
想快速拿到某个地区某类商家的名单吗?给它一条谷歌地图的搜索页链接,它会把该页展示的商家的名称、地址、城市、州省、国家、经纬度、评分、官网与详情链接整理成一份线索清单,可以直接导出成表格,接进表格或你自己的客户系统里。
做本地化拓客、门店盘点或竞品摸底时,最费时的往往是"一家家点开地图、把名称地址抄下来"。这份数据把这个地区搜索结果页上的商家一次性取回,每条都带可点开的详情链接和经纬度,适合当作线索清洗、区域覆盖分析和地图标注的原始底表。
数据说明
商家清单取自谷歌地图的公开搜索结果页,按该页原有的展示顺序返回,不做二次排序或去重。评分是商家在地图上展示的评分,满分 5 分。经纬度是商家所在地点的坐标,可用于地图标注或距离计算。官网与附加信息只在商家页展示时才有,部分商家没有这两项。只覆盖公开可见的商家,需要登录才能看到的或已关停的商家不在其中。数据为取数当时页面展示的快照,评分和商家信息会随时间变化。本应用只提供商家的基础档案信息,不含电话、营业时间与逐条评价。
结果长什么样
每条记录是一个商家:
| 商家名称 | 城市 | 地址 | 评分 | 国家 |
|---|---|---|---|---|
| The Landing | New York | 1 Pennsylvania Plaza, New York, NY 10119 | 4.6 | US |
| La Grande Boucherie | New York | 145 W 53rd St, New York, NY 10019 | 4.6 | US |
另有「州/省」「经纬度」「官网」「详情链接」「附加信息」「主图」等字段。
应用场景
- 做本地化拓客时,按「城市」「州/省」「国家」筛出目标区域的商家,再用「官网」和「详情链接」逐家联系或调研。
- 做区域覆盖分析时,把「纬度」「经度」投到地图上看商家分布疏密,判断哪片区域还是空白。
- 做线索清洗时,用「地点 ID」或「详情链接」给商家去重,避免同一家店重复入库。
- 做竞品摸底时,用「评分」横向对比同类商家的口碑高低,优先挑出评分领先的对手深看。
适用边界
单次任务处理 1 个谷歌地图搜索或列表页链接,采集条数上限默认 3 条、可上调(越大耗时与费用越高);仅覆盖页面公开展示的商家信息,部分商家缺少官网或附加信息。
- 适合用于
- 需要按地图搜索页链接批量获取某个地区某类商家的线索清单时
- 需要商家的名称、地址、经纬度、官网与详情链接做本地化拓客或门店盘点时
- 不要用于
- 需要商家的电话、营业时间、评价条数等本应用不提供的字段时——改用相应的商家详情类应用
- 需要秒级返回结果时——本应用在后台执行采集,完成时间取决于商家数量与页数
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1部分数据获取是异步返回的:参数较大或商家较多时,采集会耗时较长、无法立即返回;请耐心等待抓取完成,任务状态显示「运行中」表示仍在采集,并非异常
- 2任务失败属可重试错误,可原样重新提交
- 3返回空结果通常是链接不是谷歌地图的搜索或列表页,或该页当前无可采集商家,请核对链接后重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| map_url | 地图搜索页链接 | string | 是 | — | — | https://www.google.com/maps/search/restaurants+in+new+ycork/@40.7376352,-74.0376034,13z/data=!3m1!4b1!4m4!2m3!5m1!4e9!6e5?entry=ttu&g_ep=EgoyMDI2MDUxMy4wIKXMDSoASAFQAw%3D%3D | 要采集的谷歌地图搜索或列表页完整链接,例如 https://www.google.com/maps/search/restaurants+in+new+york/ ;请填写真实可访问的链接 |
| page_turns | 翻页次数 | integer | 否 | 1 | 1– | — | 在首个列表页之外继续向下翻页的次数,不填默认 1 次;次数越多耗时和费用越高 |
| max_collected_rows | 采集条数上限 | integer | 否 | 3 | 1– | — | 本次任务最多采集多少条商家线索,不填默认 3 条,数值越大耗时和费用越高 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| title | 商家名称 | string | The Landing | 商家在地图上展示的名称 |
| address | 地址 | string | 1 Pennsylvania Plaza, New York, NY 10119 | 商家的完整街道地址 |
| city | 城市 | string | New York | 商家所在城市 |
| state | 州/省 | string | New York | 商家所在的州或省级行政区 |
| country | 国家 | string | US | 商家所在国家或地区的代码 |
| rating | 评分 | string | 4.6 | 商家在地图上展示的评分,5 分制 |
| website | 官网 | string | https://www.thelanding.nyc/ | 商家官网链接,部分商家没有 |
| detail_url | 详情链接 | string | https://www.google.com/maps/place/The+Landing/data=!4m5!3m4!1s0x89c259bfc3e29bd5:0x71e84703e2c37e4c!8m2!3d40.7511917!4d-73.9921436?authuser=0&hl=en-US&rclk=1 | 该商家在地图上的详情页链接 |
| place_id | 地点 ID | string | ChIJ1Zviw79ZwokRTH7D4gNH6HE | 商家在地图上的唯一地点标识 |
| google_id | Google ID | string | 0x89c259bfc3e29bd5:0x71e84703e2c37e4c | 商家在地图上的另一标识,十六进制键值对形式 |
| attributes | 附加信息 | string | LGBTQ+ friendly | 商家页展示的属性标签,多个以逗号并列,部分商家没有 |
| latitude | 纬度 | string | 40.7511917 | 商家所在地点的纬度 |
| longitude | 经度 | string | -73.9921436 | 商家所在地点的经度 |
| main_image | 主图 | string | https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmX6zX6PT4GLeY9-rc6qFYSa8YMzYLFvGp7wYM1nVcihcPQDNsjTRl4pV_sqfi9JJTFSZOmecMwiRS_gnRNr9VYKex3DWC85tC0r8otGF3RkEKizfkvs5FeCoBRb6zxAhXeRklu=w408-h272-k-no | 商家在地图上展示的主图链接 |
| source_url | 来源链接 | string | https://www.google.com/maps/search/restaurants+in+new+ycork/@40.7376352,-74.0376034,13z/data=!3m1!4b1!4m4!2m3!5m1!4e9!6e5?entry=ttu&g_ep=EgoyMDI2MDUxMy4wIKXMDSoASAFQAw%3D%3D&hl=en | 该商家所属的地图搜索页链接 |
记录 Schema
输出按记录逐条返回。记录主键为 place_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"title": {
"type": "string",
"title": "商家名称",
"description": "商家在地图上展示的名称",
"prefill": "The Landing"
},
"address": {
"type": "string",
"title": "地址",
"description": "商家的完整街道地址",
"prefill": "1 Pennsylvania Plaza, New York, NY 10119"
},
"city": {
"type": "string",
"title": "城市",
"description": "商家所在城市",
"prefill": "New York"
},
"state": {
"type": "string",
"title": "州/省",
"description": "商家所在的州或省级行政区",
"prefill": "New York"
},
"country": {
"type": "string",
"title": "国家",
"description": "商家所在国家或地区的代码",
"prefill": "US"
},
"rating": {
"type": "string",
"title": "评分",
"description": "商家在地图上展示的评分,5 分制",
"prefill": "4.6"
},
"website": {
"type": "string",
"title": "官网",
"description": "商家官网链接,部分商家没有",
"prefill": "https://www.thelanding.nyc/"
},
"detail_url": {
"type": "string",
"title": "详情链接",
"description": "该商家在地图上的详情页链接",
"prefill": "https://www.google.com/maps/place/The+Landing/data=!4m5!3m4!1s0x89c259bfc3e29bd5:0x71e84703e2c37e4c!8m2!3d40.7511917!4d-73.9921436?authuser=0&hl=en-US&rclk=1"
},
"place_id": {
"type": "string",
"title": "地点 ID",
"description": "商家在地图上的唯一地点标识",
"prefill": "ChIJ1Zviw79ZwokRTH7D4gNH6HE"
},
"google_id": {
"type": "string",
"title": "Google ID",
"description": "商家在地图上的另一标识,十六进制键值对形式",
"prefill": "0x89c259bfc3e29bd5:0x71e84703e2c37e4c"
},
"attributes": {
"type": "string",
"title": "附加信息",
"description": "商家页展示的属性标签,多个以逗号并列,部分商家没有",
"prefill": "LGBTQ+ friendly"
},
"latitude": {
"type": "string",
"title": "纬度",
"description": "商家所在地点的纬度",
"prefill": "40.7511917"
},
"longitude": {
"type": "string",
"title": "经度",
"description": "商家所在地点的经度",
"prefill": "-73.9921436"
},
"main_image": {
"type": "string",
"title": "主图",
"description": "商家在地图上展示的主图链接",
"prefill": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmX6zX6PT4GLeY9-rc6qFYSa8YMzYLFvGp7wYM1nVcihcPQDNsjTRl4pV_sqfi9JJTFSZOmecMwiRS_gnRNr9VYKex3DWC85tC0r8otGF3RkEKizfkvs5FeCoBRb6zxAhXeRklu=w408-h272-k-no"
},
"source_url": {
"type": "string",
"title": "来源链接",
"description": "该商家所属的地图搜索页链接",
"prefill": "https://www.google.com/maps/search/restaurants+in+new+ycork/@40.7376352,-74.0376034,13z/data=!3m1!4b1!4m4!2m3!5m1!4e9!6e5?entry=ttu&g_ep=EgoyMDI2MDUxMy4wIKXMDSoASAFQAw%3D%3D&hl=en"
}
},
"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": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=WW_Yang/google-maps-leads",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。