Google Maps 数据 / MCP 服务器

在您的 AI 工作流中使用 Google Maps 数据。

通过 Claude Code、Cursor、VS Code 或 Codex 查找商户、阅读公开评价、浏览地点相册。三个远程工具,同一把 API 密钥。

适用于您的 MCP 客户端

远程 Streamable HTTP · 私有 API 密钥 · 免费与付费 API 套餐

三个工具 / 一次连接

从商户发现到地点详情。

每个工具直接返回结果。选择任务所需的操作,并明确指定所需页数。

查找商户

search_google_maps

搜索某个类别和地点。接收最多 20 家商户,包含可用的列表、联系方式、评分和评价数字段。

q · page · extra

探索 Search API

阅读公开评价

get_google_maps_reviews

使用地点的 feature ID 请求最多 10 条评价。可选相关性、最新、最高评分或最低评分。

fid · page · sort_by

探索 Reviews API

浏览相册媒体

get_google_maps_photos

获取某个地点最多 20 条照片和视频元数据记录。读取返回的媒体 URL 和分页标志。

fid · page

探索 Photos API

Reviews 和 Photos 接受来自搜索结果 place.dataId 的 Maps feature ID。Search 使用第 1–10 页;媒体工具返回 next,供您的智能体判断是否需要下一页。

MCP 连接

一个端点,您的 API 工作区。

您的客户端负责初始化和工具发现,然后在每个请求中携带您的 API 密钥。

远程 MCP 连接
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 额度后再切换到正式密钥。

01

准备您的工作区

选择 API 产品并创建带 scrapes:write 的测试密钥。您的 API 套餐必须允许 MCP;在线抓取工具和浏览器扩展有独立额度。

创建密钥
02

发现并调用一个工具

连接您的客户端,查看 search_google_maps,并请求一页数据。为新任务生成新的请求 ID,重试同一请求时保留该 ID。

查看客户端设置
03

使用返回的商户

读取 structuredContent.businesses 和 total。将测试结果标记为模拟数据,保留缺失值,并在所请求的页面处停止。

了解这些字段
调用 search_google_maps

每次新搜索都替换请求 ID。此示例不会在页面上执行请求。

{
  "q": "coffee shops in Seattle",
  "page": 1,
  "hl": "en",
  "extra": false,
  "client_request_id": "replace-with-a-fresh-uuid"
}

返回的内容

结构化记录,在同一个工具响应中。

businesses
最多 20 家返回商户;字段可能缺失。
params + total
规范化后的查询以及本页数量。
simulated + usage metadata
测试响应标识为模拟数据,消耗 0 个正式请求单位。
isError
在报告工具成功之前,先检查错误。

结果直接返回,无需任务轮询。将 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 额度。

免费和付费 API 套餐均可使用 MCP。每个成功的正式来源页(包括空页)消耗一个 API 请求单位。

01

测试不消耗正式用量

测试密钥返回模拟数据,消耗 0 个请求单位。它们用于验证您的集成,而不是产出真实的潜在客户。

管理 API 密钥
02

让请求保持有边界

只请求任务所需的页面和地点。新任务使用新的请求 ID;对不确定的请求用相同输入和 ID 重试。

阅读用量指引
03

添加可复用的说明

Google Maps Data Agent Skill 为同样的工具增加工作流指引、操作参考和 REST 备用方案。

探索 Agent Skill

探索 API 中心 → 在线抓取工具和浏览器扩展套餐有各自的额度。

连接帮助

走到下一个成功的请求。

根据连接状态和返回的错误选择下一步。

客户端已连接但没有出现工具
确认端点为 /api/mcp,且您的客户端支持带私有 Authorization 请求头的远程 Streamable HTTP。重新加载连接,并检查其进程能否读取配置的密钥。
401 或 403
检查密钥过期时间、允许的 IP、有效的工作区访问权限、scrapes:write 权限范围,以及允许使用 MCP 的 API 套餐。浏览器登录 Cookie 无法认证该端点。
invalid_request
阅读所选工具的 schema。提供 16–128 个字符的唯一 client_request_id;评价和照片还需要来自 place.dataId 的 FID,而不是商户名称或其他地点标识符。
rate_limited 或 quota_exceeded
速率限制请遵守 retry_after。API 额度耗尽时请停止并检查您的 API 用量;再创建密钥不会增加额度。
capability_unavailable 或来源故障
检查服务状态和返回的错误。可用性由服务器决定。在结果中明确标记缺失或不可用的数据。
超时或 isError: true
即使 HTTP 连接成功也要检查工具错误。对可重试的失败,在任务截止时间内使用相同输入和请求 ID。开始新尝试前请遵循终止性错误指引。

服务状态 错误与重试指引

常见问题

Google Maps MCP 服务器能做什么?

它提供 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 有单独的额度吗?

MCP 与 REST API 共享额度,免费和付费 API 套餐均可使用。一个成功的正式页消耗一个请求单位,包括空页。测试凭据返回模拟数据,消耗 0 个单位。在线抓取工具和浏览器扩展的额度是独立的。

我还需要 Agent Skill 吗?

MCP 服务器可以独立工作。可选的 Google Maps Data Agent Skill 会额外提供可复用说明、操作参考,以及在您配置的 MCP 连接不可用时用于 REST 备用方案的辅助工具。

迈出下一步

把 Google Maps 数据带入您的下一次对话。

创建 API 密钥,连接您喜欢的客户端,并测试一次聚焦的商户搜索。