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),並選擇應用程式可以執行的操作:讀取(地點、掃描記錄、變更內容)和掃描(啟動掃描,會使用你的手動掃描額度)。無需複製金鑰。

  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 的選單名稱偶爾會變更;網址則維持不變。

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 的限制。試用期結束或取消訂閱後,金鑰就會停止運作。