mcp-gsc

オープンソースSEOツール群 DigestSEO の一部です。

• 製品: digestseo.com/gsc-mcp

• サポート: digestseo.com/support

• プライバシー: digestseo.com/privacy

セルフホスティング用ランチャーは @digestseo/mcp-gsc として利用できます:

npx -y @digestseo/mcp-gsc

Google OAuth と Cloudflare のデプロイ設定については、SETUP.md を参照してください。

30秒で接続

デプロイされた各インスタンスは同じエンドポイント形式を公開します:

https://<your-worker>.workers.dev/mcp

DigestSEO がホストするインスタンスは次の場所で利用できます:

https://mcp-gsc.digestseo.com/mcp

Claude Code

claude mcp add --transport http gsc https://<your-worker>.workers.dev/mcp

Cursor

ChatGPT — カスタムコネクタとして追加してください。下記の AIクライアントで接続 を参照してください。

自己ホスト可能な Model Context Protocol (MCP) サーバーで、Google Search Console 用です。Claude.ai、Cursor、ChatGPT、または MCP 互換の任意のクライアントに接続して、自分の Google アカウントから直接、サイトのオーガニック検索パフォーマンス（インプレッション、クリック、上位クエリ、インデックスステータス、サイトマップの健全性）について AI アシスタントに質問できます。

これは Cloudflare Workers 上で動作し、ワンクリックの Google OAuth オンボーディングを備えています。クライアントでサーバーに接続し、Google で一度サインインし、要求された Google Search Console の権限を許可するだけです。API キーをコピーしたり、サービスアカウントの JSON を管理する必要はありません。

セットアップ不要がお好みですか? ホスト版（毎週のメールダイジェストを自動で受信トレイにお届け）は digestseo.com にあります。このリポジトリは、自分で実行できるオープンソースのコアです。

ツール

デフォルト（GSC_ACCESS_MODE=readwrite）では、このサーバーは17個のツールを公開します。読み取り専用の分析・レポートツールは MCP の readOnlyHint でマークされています。以下の書き込みツールは、Search Console のプロパティ、サイトマップ、またはインデックス状態を変更できます。GSC_ACCESS_MODE=readonly に設定すると、Search Console の読み取り専用スコープのみを要求し、12個の読み取り専用ツールを公開します。

読み書きモードは、Google Search Console の読み書きスコープと Indexing API スコープを要求します。読み取り専用モードは https://www.googleapis.com/auth/webmasters.readonly（および openid と email）のみを要求し、5つの書き込みツールは登録しません。既存のデプロイメントが現在の動作を維持できるよう、読み書きがデフォルトのままです。ユーザーを接続する前にモードを選択するには、SETUP.md を参照してください。

indexing.request の対象条件。 Google の Indexing API は汎用のページ送信ツールではありません。本稿執筆時点では、Google の公式ドキュメントでは2つのコンテンツタイプに制限されています: JobPosting 構造化データを含むページ、および VideoObject 内にネストされた BroadcastEvent 構造化データを含むライブ配信ページです。送信前に、サーバーは対象 URL を取得し、その JSON-LD にこれら2つのタイプのいずれかが含まれているかを確認します。どちらも存在しない場合（またはページを取得できない場合）、Indexing API を呼び出さずに、URL が対象外である理由を説明するエラーを返します。送信が成功したとしても、それは Google が通知を受け取ったことを示すだけであり、URL がインデックス登録されることを保証するものではありません。

Related MCP server: gsc-mcp

質問できること

接続すると、アシスタントに次のようなことを質問できます:

• 「過去28日間のクリック数上位20クエリは？」

• 「example.com の今月と先月のインプレッションを比較して、どのページが落ちた？」

• 「https://example.com/pricing はインデックス登録されていますか？ 最後にクロールされたのはいつですか？」

• 「私のブログが5〜15位にランクインしているクエリは？ それがクイックウィンです。」

• 「今日で終わる sc-domain:example.com の週次ダイジェストをください。」

• 「私のサイトマップにエラーや警告はありますか？」

• 「クエリの正規表現を使ってクリックをブランドと非ブランドに分けてください。」

• 「私のサイトは Google Discover と通常のウェブ検索でどうですか？」

AIクライアントで接続

サーバーをデプロイしたら（SETUP.md を参照）、Worker の /mcp URL をクライアントに貼り付けて接続します:

https://<your-worker>.workers.dev/mcp

• Claude.ai — 設定 → コネクタ → カスタムコネクタを追加 → /mcp URL を貼り付けます。Client ID と Client Secret は空白のままにします。初回使用時に Claude が Google サインインフローを開くので、デプロイメントが要求するアクセスを許可すると、コネクタが緑色になります。

• Cursor — 同じ /mcp URL を指すカスタム MCP サーバーとして追加します。

• ChatGPT（コネクタ/MCP サポートあり）— /mcp URL を使用してカスタムコネクタを追加します。

MCP 互換のクライアントならどれでも動作します。すべて同じ /mcp エンドポイントを指し、同じ OAuth フローを共有します。

セットアップ

セルフホスティングとは、独自の Google OAuth 認証情報と Cloudflare アカウントを持ち込むことを意味します。コピー＆ペースト可能な完全な手順は SETUP.md にあります。Google の OAuth 検証と、アプリが未検証の間の7日間のリフレッシュトークン制限に関する重要な注意事項も含まれています。

概要:

git clone https://github.com/<you>/mcp-gsc.git
cd mcp-gsc
npm install
cp wrangler.example.jsonc wrangler.jsonc       # then paste in your KV ids
# set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET / TOKEN_ENCRYPTION_KEY as secrets
# choose GSC_ACCESS_MODE=readonly in wrangler.jsonc for a read-only deployment
npm run deploy

詳細な手順は SETUP.md を参照してください。

開発

npm install
npm test              # typecheck + offline unit tests (what CI runs)
npm run dev           # wrangler dev (local)
npm run test:smoke    # structural smoke tests against a deployment

コントリビューション歓迎です — CONTRIBUTING.md を参照してください。

ライセンス

MIT © 2026 DigestSEO.

Tomi Šeregi によって構築・保守されています。digestseo.com の製作者であり、非技術系サイトオーナー向けの週次 SEO ダイジェストを提供しています。