GridWhy
官方Google Maps 地理網格排名歷史,適用於在地 SEO:查看掃描歷史記錄,詢問排名變動的原因(競爭對手、評論、類別變更),取得可直接提供給客戶的說明和後續步驟,並執行新的網格掃描。
你可以用 GridWhy MCP 做什麼?
- 檢視掃描記錄 — 查詢已追蹤地點和關鍵字的最新掃描結果,包括前 20 名和前 3 名的網格數、平均排名和最佳排名,以及剩餘的手動掃描次數。
- 說明排名變化 — 取得關於關鍵字在不同掃描間排名變動原因的分析,涵蓋覆蓋範圍、競爭對手、評論速度、評分,以及類別或名稱變更,並提供可直接提供給客戶的說明。
- 開始網格掃描 — 立即為一個已追蹤的關鍵字啟動掃描,這會計入手動掃描額度,並傳回供後續查詢的掃描 ID。
- 透過 OAuth 或金鑰連線 — 在 Claude 或 ChatGPT 中新增
https://gridwhy.com/mcp並登入,或使用gw_金鑰搭配 Claude Code、Cursor 和指令碼。
託管 MCP 伺服器
npx add-mcp 'https://gridwhy.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
一鍵連線
Claude 和 ChatGPT 只需要網址 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 的選單名稱偶爾會變更;網址則維持不變。
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 的限制。試用期結束或取消訂閱後,金鑰就會停止運作。