GSC MCPでGoogle Search Consoleをアシスタントへ。
mcp-gscはGoogle Search ConsoleをClaude、ChatGPT、CursorなどのMCPクライアントに接続します。Google OAuthでクエリ、ページ、パフォーマンス、サイトマップ、URL検査を確認できます。
- 推奨モード
- Read-only
- 認証方式
- Google OAuth
- 実行方法
- npm / Worker
- ライセンス
- MIT
npm · Google Search Console MCP
npm で GSC MCP をローカルにインストール
npm は同じパソコン上で Streamable HTTP サーバーを起動します。実行前に Google OAuth と認証情報の設定が必要で、ワンクリック接続ではありません。
1. Google のアクセスを準備
Node.js ^22.18.0 / >=24.11.0+npm- 分析対象の Search Console プロパティにアクセスできる Google アカウントを用意します。
- Google Cloud で OAuth クライアントを作成し、必要な API を有効にして、正確なローカル リダイレクト URI を登録します。
- このバージョンの設定ガイドに沿って 3 つの環境変数を設定します。TOKEN_ENCRYPTION_KEY はランダムな 32 バイトを正しく base64 エンコードした値にしてください。
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Google Cloud にこの URI を正確に登録してください。ホスト、ポート、パスは完全一致が必要で、localhost と 127.0.0.1 は別のホストです。
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. ローカルサーバーを起動
ターミナルで認証情報を設定してから npm を実行します。分析のみなら、使用するシェルに合った読み取り専用設定を選びます。
初期設定は readwrite です。分析専用なら Google 認証前に readonly にすると、変更用ツールは登録されません。
Bash / zsh のコマンド
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gscローカル接続先 · Streamable HTTP
http://127.0.0.1:8080/mcp 3. MCP クライアントを接続
ランチャーを起動したまま、同じパソコンのクライアントからローカル Streamable HTTP エンドポイントに接続します。stdio ではありません。
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcpCodex CLI / IDE を接続
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
Cursor では gsc という名前の Streamable HTTP MCP サーバーとしてこの URL を追加します（ローカル版のみ）。
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
クラウド上の ChatGPT や Claude からパソコンの 127.0.0.1 には接続できません。利用資格に応じて独自の HTTPS Worker または対応する安全な MCP トンネルを使用してください。
リモート接続が必要ですか？リモート接続が必要ですか？
Cloudflare Workers のセルフホスト方式も利用できます。Cloudflare と Google OAuth の設定が必要です。下の例は Bash 用です。詳しくは SETUP.md を参照してください。
概要
mcp-gscとは？
mcp-gscは、AIクライアントを公式のGoogle Search Console APIへ直接つなぐ、セルフホスト可能なModel Context Protocolサーバーです。
npm パッケージはローカルのループバック HTTP で実行できます。リモート HTTPS が必要なら独自の Cloudflare Worker を配置できます。どちらも Google OAuth を使用します。
ローカル版の暗号化されたセッション状態は標準で ~/.mcp-gsc/state に保存されます。Worker は自分の Cloudflare アカウントのストレージを使用し、DigestSEO が管理する接続サービスではありません。
Search Console の「ウェブ：マルチモーダル」書き出しを読み込み、ページ単位の表示回数とクリック数を確認します。画像認識ツールではありません。 Googleレンズ・マルチモーダル検索の分析ツール.
自分が管理するSNSアカウントのGoogle検索での発見状況を比較します。SNS内の再生数や「いいね」は測定しません。 SNSのGoogle検索パフォーマンス比較ツール.
ツール
サーバーの機能
分析、URL検査、サイトマップ、インデックス登録、SEO診断、週次レポートのためのツールを提供します。
一覧にはオプションの書き込みツールも含まれます。GSC_ACCESS_MODE=readonly では読み取り系ツールのみ登録され、Google Indexing API は対象コンテンツが制限されます。
get_capabilities利用できる機能と認証状態を一覧表示します。
list_sites接続したアカウントがアクセスできるSearch Consoleプロパティを一覧表示します。
query_search_analytics指定した期間のクリック数、表示回数、CTR、掲載順位を取得します。
inspect_urlライブURL検査レポートとインデックス登録の詳細を取得します。
list_sitemaps送信したサイトマップとクロール状態、警告を一覧表示します。
add_siteSearch Consoleプロパティを接続したアカウントに追加します。
delete_siteSearch Consoleプロパティをアカウントから削除します。
submit_sitemapSearch Consoleプロパティにサイトマップを送信します。
delete_sitemap送信済みサイトマップをプロパティから削除します。
get_sitemap送信済みサイトマップの詳細な状態を取得します。
identify_quick_wins表示回数が多く、掲載順位8〜20位のクエリを見つけます。
detect_cannibalization複数ページが競合しているクエリを見つけます。
detect_content_decay検索クリックの減少が大きいページを特定します。
request_indexingGoogleのIndexing APIを通じてインデックス登録をリクエストします。このAPIは現在、JobPosting構造化データを含むページ、またはVideoObject内にBroadcastEventを含むライブ配信ページに限定されており、一般的なWebページの送信には利用できません。
list_indexed_pagesSearch Consoleで表示回数が発生したページを一覧表示します。
compare_performance期間ごとのクリック、表示回数、CTR、掲載順位を比較します。
weekly_digest分かりやすい言葉で週次SEOレポートを作成します。
デプロイ
リモート接続が必要ですか？
Cloudflare Workers のセルフホスト方式も利用できます。Cloudflare と Google OAuth の設定が必要です。下の例は Bash 用です。詳しくは SETUP.md を参照してください。
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deployリポジトリにスターを付け、Search ConsoleをClaudeで使う。
オープンソースのセルフホスト型です。Google OAuth の設定ガイドを確認するか、独自の Worker を配置してください。