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),并选择应用可以执行的操作:读取(地点、扫描历史记录、变化内容)和扫描(启动扫描,会消耗手动扫描额度)。无需复制密钥。
- 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 下添加,每位成员再进行连接。 - 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(手动扫描) |
|---|---|---|
| Solo | 100 | 每天 5 次,每 30 天 30 次 |
| Agency | 500 | 每天 20 次,每 30 天 100 次 |
| Agency+ | 2,000 | 每天 50 次,每 30 天 250 次 |
计划扫描不受 API 限制。免费试用采用 Solo 套餐的限制。试用期结束或订阅取消后,密钥将停止工作。