GridWhy

官方

Google Maps 本地 SEO 地理网格排名历史:查看扫描历史,询问排名变化的原因(竞争对手、评论、类别变更),获取可直接提供给客户的说明和后续步骤,并运行新的网格扫描。

你可以用 GridWhy MCP 做什么?

  • 查看扫描历史 — 查询已跟踪的位置和关键词及其最新扫描结果,包括前 20 名和前 3 名的网格计数、平均排名和最佳排名,以及剩余的手动扫描次数。
  • 解释排名变化 — 了解关键词在不同扫描间排名变化的原因,涵盖覆盖范围、竞争对手、评论增长速度、评分以及类别或名称变化,并提供可直接发给客户的说明。
  • 启动网格扫描 — 立即为一个已跟踪的关键词启动扫描,该扫描会计入手动扫描额度,并返回一个扫描 ID 供后续查询。
  • 通过 OAuth 或密钥连接 — 在 Claude 或 ChatGPT 中添加 https://gridwhy.com/mcp 并登录,或在 Claude Code、Cursor 和脚本中使用 gw_ 密钥。

托管 MCP 服务器

npx add-mcp 'https://gridwhy.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

一键连接

Claude 和 ChatGPT 只需要 URL https://gridwhy.com/mcp。它们会打开 GridWhy 页面,你可以像往常一样登录(通过电子邮件链接或 Google),并选择应用可以执行的操作:读取(地点、扫描历史记录、变化内容)和扫描(启动扫描,会消耗手动扫描额度)。无需复制密钥。

  1. Claude(claude.ai 和桌面应用,任何套餐):依次选择 Customize → Connectors → Add → Add custom connector。将名称设为 GridWhy,粘贴 https://gridwhy.com/mcp,点击 Continue,保留 Claude 标记为 Detected 的身份验证选项(它会自动注册自身),点击 Add,然后点击 Connect。对于 Team 和 Enterprise 套餐,由 Owner 在 Organization settings → Connectors 下添加,每位成员再进行连接。
  2. ChatGPT:打开 chatgpt.com/plugins,选择 +,然后选择 Add custom MCP server。在 Connection 下输入 GridWhy 并粘贴 https://gridwhy.com/mcp,选择 OAuth 进行身份验证,确认,然后选择 Create as a plugin。是否允许自定义服务器取决于工作区的策略。

已连接的应用会列在 Settings → API and MCP 下,你可以在此断开连接;断开后会立即停止工作。它们遵循与 API 密钥相同的限制(见下文)。试用期结束或订阅取消后,它们会返回明确的错误,直到你选择套餐。Claude 和 ChatGPT 中的菜单名称会不时变化;URL 保持不变。

1. 或使用密钥

登录后,打开 Settings → API and MCP 并创建密钥。密钥以 gw_ 开头,且只会显示一次。密钥对整个工作区生效;你可以随时在此撤销。

适用于 Claude Code、Cursor、脚本和 REST API。MCP 端点:https://gridwhy.com/mcp(Streamable HTTP)。将密钥作为 Authorization: Bearer gw_… 发送。支持此功能的客户端可使用 OAuth 发现:https://gridwhy.com/.well-known/oauth-protected-resource/mcp。

2. 连接客户端

Claude Code(终端)

claude mcp add --transport http gridwhy https://gridwhy.com/mcp \
  --header "Authorization: Bearer gw_your_key"

Claude Desktop:依次选择 Settings → Developer → Edit config (claude_desktop_config.json),然后重启

{
  "mcpServers": {
    "gridwhy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gridwhy.com/mcp", "--header", "Authorization:${GRIDWHY_AUTH}"],
      "env": { "GRIDWHY_AUTH": "Bearer gw_your_key" }
    }
  }
}

需要 Node.js。密钥存放在环境变量中,因此在 Windows 上,“Bearer”后面的空格也能保留。

Cursor:~/.cursor/mcp.json(或项目中的 .cursor/mcp.json)

{
  "mcpServers": {
    "gridwhy": {
      "url": "https://gridwhy.com/mcp",
      "headers": { "Authorization": "Bearer gw_your_key" }
    }
  }
}

通过 OpenAI Responses API 使用 ChatGPT 模型

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "tools": [{
      "type": "mcp",
      "server_label": "gridwhy",
      "server_url": "https://gridwhy.com/mcp",
      "headers": { "Authorization": "Bearer gw_your_key" },
      "require_approval": { "never": { "tool_names": ["get_history", "explain_change"] } }
    }],
    "input": "Which of my clients lost ground on Google Maps this week, and why?"
  }'

在 ChatGPT 应用中,请改用上面的一键连接方式;此处的 API 调用会直接使用密钥。

3. 工具

  • get_history 地点、已跟踪的关键词及其扫描结果,按最新优先:排名进入前 20 和前 3 的网格点数量、平均排名和最佳排名、一句话概述“变化内容”,以及报告链接。不带参数时:每个关键词及其最新扫描结果,以及剩余的手动扫描次数。 参数:location、keyword、keyword_id、limit(均为可选)
  • explain_change 说明某次扫描与前一次扫描之间排名变化的原因:发现(覆盖范围、排名上升或新出现的竞争对手、评论增长速度、评分、类别或名称变化),每项发现都附有一段可直接粘贴给客户的文字,以及后续步骤。传入 scan_id,或传入地点和关键词以获取其最近一次已完成的扫描。 参数:scan_id、location、keyword、keyword_id(均为可选)
  • run_scan 立即为一个已跟踪的关键词启动网格扫描(在计划扫描之外)。会计入账户的手动扫描次数(每日和每 30 天);关键词的首次扫描免费。需要 15-30 秒;完成后,使用返回的 scan_id 调用 explain_change。 参数:location、keyword、keyword_id(均为可选)

试试:“说明 Wilson Plumbing 的 ‘plumber’ 有什么变化,并为客户撰写更新内容。”

4. REST

相同的三种操作、相同的密钥、限制和响应(JSON)。

get_history

curl "https://gridwhy.com/api/v1/history?location=Wilson&keyword=plumber&limit=5" \
  -H "Authorization: Bearer gw_your_key"

explain_change

curl "https://gridwhy.com/api/v1/explain?scan_id=<scan id>" \
  -H "Authorization: Bearer gw_your_key"

run_scan(202 Accepted;扫描需要 15–30 秒)

curl -X POST "https://gridwhy.com/api/v1/scans" \
  -H "Authorization: Bearer gw_your_key" -H "Content-Type: application/json" \
  -d '{ "location": "Wilson Plumbing", "keyword": "plumber" }'

错误会以 { "error": "…" } 的形式返回,状态码为 400、401、403、404、409 或 429(附带 Retry-After)。

5. 限制

套餐每小时 API 调用次数run_scan(手动扫描)
Solo100每天 5 次,每 30 天 30 次
Agency500每天 20 次,每 30 天 100 次
Agency+2,000每天 50 次,每 30 天 250 次

计划扫描不受 API 限制。免费试用采用 Solo 套餐的限制。试用期结束或订阅取消后,密钥将停止工作。