GridWhy
公式ローカルSEO向けのGoogle Mapsジオグリッド順位履歴:スキャン履歴を確認し、順位が変動した理由(競合、レビュー、カテゴリの変更)をクライアント向けの説明文と次のステップとともに尋ね、新しいグリッドスキャンを実行できます。
GridWhy MCPで何ができますか?
- スキャン履歴を確認 — 追跡中のロケーションとキーワードについて、最新のスキャン結果を確認できます。トップ20とトップ3のグリッド件数、平均順位と最高順位、残りの手動スキャン回数も含まれます。
- 順位変動の理由を説明 — スキャン間でキーワードの順位が変動した理由を、カバレッジ、競合、レビューの増加ペース、評価、カテゴリや名称の変更を踏まえて確認できます。クライアント向けの説明文も取得できます。
- グリッドスキャンを開始 — 追跡中のキーワードを1つ指定して、今すぐスキャンを実行できます。手動スキャンの利用枠が消費され、後から結果を確認するためのスキャン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 だけが必要です。サインインページが開くので、通常どおり(メールリンクまたは 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 を選択します。GridWhy と入力し、Connection の下に
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 位にランクインしたグリッドポイント数、平均順位と最高順位、1 行の「変更内容」、レポートへのリンクを確認できます。引数を指定しない場合は、すべてのキーワードの最新スキャンと、残りの手動スキャン数を表示します。 引数: location、keyword、keyword_id、limit(すべて省略可能)explain_changeスキャンとその直前のスキャンの間で順位が変化した理由を説明します。調査結果(カバレッジ、順位が上昇または新たに出現した競合他社、レビューの増加ペース、評価、カテゴリや名前の変更)と、それぞれクライアントに貼り付けられる一文、および次のステップを提示します。scan_id を指定するか、location と keyword を指定すると、その最新の完了済みスキャンを対象にします。 引数: scan_id、location、keyword、keyword_id(すべて省略可能)run_scan追跡中のキーワード 1 つについて、今すぐグリッドスキャンを開始します(スケジュールとは別に実行)。アカウントの手動スキャン数(1 日あたりおよび 30 日あたり)に加算されます。キーワードの初回スキャンは無料です。所要時間は 15~30 秒です。完了後、返された scan_id を指定して explain_change を呼び出してください。 引数: location、keyword、keyword_id(すべて省略可能)
お試しください: 「Wilson Plumbing の『plumber』について変更内容を説明し、クライアント向けの更新文を書いてください。」
4. REST
同じ 3 つの操作、同じキー、制限、応答(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. 制限
| プラン | 1 時間あたりの API 呼び出し数 | run_scan(手動スキャン) |
|---|---|---|
| Solo | 100 | 1 日あたり 5 回、30 日あたり 30 回 |
| Agency | 500 | 1 日あたり 20 回、30 日あたり 100 回 |
| Agency+ | 2,000 | 1 日あたり 50 回、30 日あたり 250 回 |
スケジュールされたスキャンは API の制限を受けません。無料トライアルには Solo の制限が適用されます。トライアル終了時またはサブスクリプション解約時に、キーは使えなくなります。