查找商户
search_google_maps搜索某个类别和地点。接收最多 20 家商户,包含可用的列表、联系方式、评分和评价数字段。
q · page · extra
探索 Search API三个工具 / 一次连接
每个工具直接返回结果。选择任务所需的操作,并明确指定所需页数。
search_google_maps搜索某个类别和地点。接收最多 20 家商户,包含可用的列表、联系方式、评分和评价数字段。
q · page · extra
探索 Search APIget_google_maps_reviews使用地点的 feature ID 请求最多 10 条评价。可选相关性、最新、最高评分或最低评分。
fid · page · sort_by
探索 Reviews APIget_google_maps_photos获取某个地点最多 20 条照片和视频元数据记录。读取返回的媒体 URL 和分页标志。
fid · page
探索 Photos APIReviews 和 Photos 接受来自搜索结果 place.dataId 的 Maps feature ID。Search 使用第 1–10 页;媒体工具返回 next,供您的智能体判断是否需要下一页。
MCP 连接
您的客户端负责初始化和工具发现,然后在每个请求中携带您的 API 密钥。
POST https://gmapscrawl.com/api/mcp
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream客户端设置
创建 API 密钥,然后复制对应客户端的配置。将密钥保存在其环境或受保护的 input 设置中。
将此服务器添加到 .mcp.json。确保 GMSCRAPER_API_KEY 在启动 Claude Code 的环境中可用。
{
"mcpServers": {
"google-maps-data": {
"type": "http",
"url": "https://gmapscrawl.com/api/mcp",
"headers": {
"Authorization": "Bearer ${GMSCRAPER_API_KEY}"
}
}
}
}保存配置后,重新连接并确认出现这三个工具。按照分步设置指南操作。
您的第一个工作流
先用测试密钥和模拟数据开始。准备好使用 API 额度后再切换到正式密钥。
选择 API 产品并创建带 scrapes:write 的测试密钥。您的 API 套餐必须允许 MCP;在线抓取工具和浏览器扩展有独立额度。
创建密钥连接您的客户端,查看 search_google_maps,并请求一页数据。为新任务生成新的请求 ID,重试同一请求时保留该 ID。
查看客户端设置读取 structuredContent.businesses 和 total。将测试结果标记为模拟数据,保留缺失值,并在所请求的页面处停止。
了解这些字段每次新搜索都替换请求 ID。此示例不会在页面上执行请求。
{
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false,
"client_request_id": "replace-with-a-fresh-uuid"
}返回的内容
结果直接返回,无需任务轮询。将 JSON 转成表格或报告时,请保留来源观测日期。
示例提示词
连接后使用这些提示词。需要时提供真实的 feature ID,并让您的智能体将测试结果标记为模拟数据。
“对西雅图的咖啡店使用一次 search_google_maps,第 1 页,extra 为 false。返回商户的名称、网站、电话号码、评分和评价数。缺失字段留空并显示观测日期。处理完本页后停止。”
预期结果
一张最多 20 家返回商户的表格,保留来源时间戳和缺失值。
“对于我选定的商户,将其 place.dataId 作为 fid。用 sort_by 2 请求 get_google_maps_reviews 的第 1 页。只总结这些返回评价中的主题并注明日期。不要获取额外页面。”
预期结果
一份基于最多 10 条评价的有边界总结,不会把一页数据当作所有客户的体验。
“对这个提供的 feature ID 使用 get_google_maps_photos,仅第 1 页。列出返回的 photoUrl 和可选 videoUrl 字段,并报告 next 是否为 true。不要下载文件或获取下一页。”
预期结果
最多 20 条相册记录以及返回的分页状态,供您自己的应用检查。
REST + MCP
免费和付费 API 套餐均可使用 MCP。每个成功的正式来源页(包括空页)消耗一个 API 请求单位。
测试密钥返回模拟数据,消耗 0 个请求单位。它们用于验证您的集成,而不是产出真实的潜在客户。
管理 API 密钥只请求任务所需的页面和地点。新任务使用新的请求 ID;对不确定的请求用相同输入和 ID 重试。
阅读用量指引Google Maps Data Agent Skill 为同样的工具增加工作流指引、操作参考和 REST 备用方案。
探索 Agent Skill探索 API 中心 → 在线抓取工具和浏览器扩展套餐有各自的额度。
连接帮助
根据连接状态和返回的错误选择下一步。
它提供 search_google_maps、get_google_maps_reviews 和 get_google_maps_photos。Search 每页最多返回 20 家商户;评价最多返回 10 条记录,照片最多返回 20 条相册记录。这些工具直接返回结构化数据。
使用支持远程 Streamable HTTP 和私有 Authorization 请求头的 Claude Code、Cursor、VS Code、Codex 或其他 MCP 客户端版本。上面四种客户端配置使用同一端点和 API 工作区密钥。
在您的 API 工作区创建带 scrapes:write 的 API 密钥,并将其以私有方式配置为 Bearer 请求头。浏览器 Cookie 无法认证 MCP。请将密钥放在提示词、URL 和已提交的源代码之外。
将 Maps feature ID 作为 fid 传入。您可以使用返回商户中的 place.dataId。评价还接受 sort_by:1 表示相关性,2 表示最新,3 表示最高评分,4 表示最低评分。在考虑下一页媒体数据前先读取 next。
MCP 与 REST API 共享额度,免费和付费 API 套餐均可使用。一个成功的正式页消耗一个请求单位,包括空页。测试凭据返回模拟数据,消耗 0 个单位。在线抓取工具和浏览器扩展的额度是独立的。
MCP 服务器可以独立工作。可选的 Google Maps Data Agent Skill 会额外提供可复用说明、操作参考,以及在您配置的 MCP 连接不可用时用于 REST 备用方案的辅助工具。