serpgrab: Google Search and Maps

serpgrab MCP server

一个托管的 MCP 服务，可通过 serpgrab 为 AI Agent 提供实时 Google 搜索和 Google 地图结果。无需安装任何内容：只需向 MCP 客户端添加一个 URL。

https://api.serpgrab.com/mcp

此仓库包含设置文档和客户端配置示例。服务本身运行在我们的基础设施上，并非开源。它已列入官方 MCP 注册表，名称为 com.serpgrab/google-search。

工具

• google_search：Google 网页搜索结果（标题、URL、日期、摘要），以及 Google 显示的 AI 概览、答案框、知识面板、本地商家列表、广告和“大家还在问”。
• google_maps_search：Google 地图中的商家和地点，每页 20 条，包含评分、评论、价格、地址、电话、营业时间、网站、坐标和 place_id。

结果会以适合模型上下文的精简文本返回，而非原始 JSON。

google_search

参数	默认值
query	（必填）	输入 Google 的搜索内容
pages	1	要读取的结果页数，1-3 页（每页约 10 条结果）
country	us	Google 搜索所用的两字母国家代码（gl）
language	en	界面语言（hl）
location		模拟从某个地点进行搜索，例如 Austin, Texas, United States
time		hour、day、week、month 或 year：仅返回近期结果

google_maps_search

参数	默认值
query	（必填）	要查找的内容，例如 pizza in austin tx
ll		地图位置，@latitude,longitude,zoomz，例如 @30.2672,-97.7431,14z
page	1	结果页，每页 20 个地点
country	us	两字母国家代码（gl）
language	en	界面语言（hl）

获取密钥

免费：每月 250 次搜索，通过电子邮件注册，无需信用卡：https://serpgrab.com/#signup

连接并列出工具无需密钥；运行工具则需要密钥。Agent 读取的每个结果页都算一次搜索。

设置

将 YOUR_KEY 替换为你的 serpgrab 密钥。

Claude Code

claude mcp add --transport http serpgrab https://api.serpgrab.com/mcp \
  --header "X-API-Key: YOUR_KEY"

Cursor

在 ~/.cursor/mcp.json 或项目中的 .cursor/mcp.json 文件里：

{
  "mcpServers": {
    "serpgrab": {
      "url": "https://api.serpgrab.com/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

VS Code

在 .vscode/mcp.json 文件里，或运行 MCP: Open User Configuration：

{
  "servers": {
    "serpgrab": {
      "type": "http",
      "url": "https://api.serpgrab.com/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

Windsurf

在 Cascade 的 MCP 菜单中，选择 Open MCP config file 并添加：

{
  "mcpServers": {
    "serpgrab": {
      "serverUrl": "https://api.serpgrab.com/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

Codex

在 ~/.codex/config.toml 文件里：

[mcp_servers.serpgrab]
url = "https://api.serpgrab.com/mcp"
http_headers = { "X-API-Key" = "YOUR_KEY" }

Claude.ai、Claude Desktop、ChatGPT 和其他仅接受 URL 的客户端

将密钥放入 URL，并选择不进行身份验证：

https://api.serpgrab.com/mcp?api_key=YOUR_KEY

• Claude.ai 和 Claude Desktop： 设置 › 连接器 › 添加自定义连接器。
• ChatGPT： 开启开发者模式，然后进入设置 › 连接器 › 创建。

我们不会记录通过 URL 发送的密钥，但客户端会将 URL 存储在设置中，因此请像保护密钥一样妥善保管它。

仅支持 stdio 的客户端

通过 mcp-remote 连接：

{
  "mcpServers": {
    "serpgrab": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.serpgrab.com/mcp", "--header", "X-API-Key:YOUR_KEY"]
    }
  }
}

RapidAPI Pro 套餐

Pro 套餐每月 15 美元，可进行 5,000 次搜索，详见 RapidAPI。 订阅用户通过 RapidAPI 网关使用自己的 RapidAPI 密钥进行连接：

claude mcp add --transport http serpgrab https://google-serp-search-results-json.p.rapidapi.com/mcp \
  --header "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  --header "X-RapidAPI-Host: google-serp-search-results-json.p.rapidapi.com"

RapidAPI 会统计对服务的每次请求，因此连接约占用套餐额度中的三次请求，每次工具调用则额外占用一次。

传输

Streamable HTTP，无状态，返回 JSON 响应（无 SSE 流）。仅使用 POST。

底层 API

serpgrab 以 SerpApi 的 JSON 格式返回 Google 结果，因此同一个密钥也可用于你自己的代码：请参阅迁移指南和 OpenAPI 规范。

帮助

设置页面：https://serpgrab.com/mcp。如有问题或希望添加某个工具，请联系：[email protected]。

许可证

此仓库中的文档和示例采用 MIT 许可证。