Google Search Console MCP

Google Search Console MCP

英語 | ロシア語

A1 Google Search Console MCP は、AI アプリを Google Search Console に接続します。検索パフォーマンスの調査、URL がインデックスに登録されているかの確認、サイトマップの調査を行い、必要に応じてサイトマップを意図的に送信または削除できます。

Google アカウントからアクセスできるプロパティで動作します。重要なのは、Search Console のプロパティ値をそのまま使用することです。ドメイン プロパティと URL プレフィックス プロパティは別々のオブジェクトです。

• 18 個のツール。 7 個のツールでプロパティ、検索データ、サイトマップ、インデックス登録状況を読み取れます。2 個のツールでプロパティの追加またはサイトマップの送信を行えます。3 個のツールではデータを削除したり、任意の API メソッドを呼び出したりできます。
• 会話から接続できます。 「Google Search Console に接続して」と伝えると、サーバーが OAuth クライアントの設定を案内し、PKCE を使用して 127.0.0.1 への Google のリダイレクトを受け取り、トークンを自ら保持します。設定ファイルも再起動も必要ありません。
• プロパティ ID を正確に指定。 https://example.com/、https://www.example.com/、sc-domain:example.com はそれぞれ別のプロパティです。使用する値は list_sites で確認できます。
• コンテキスト付きの検索データ。 日付、ページ、クエリ、国、デバイス、検索での見え方ごとに、クリック数、表示回数、CTR、掲載順位を取得できます。
• インデックス登録の確認であり、公開ではありません。 URL 検査では Google の現在のステータスを確認できますが、ページのインデックス登録を強制することはできません。

読み取り専用の質問から始めましょう。

過去 28 日間のプロパティについて、クリック数と CTR を含め、検索クエリの上位 20 件を表示してください。

サーバーに接続 · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： https://example.com/pricing はインデックスに登録されていますか？ 登録されていない場合、その理由は何ですか？

アシスタント： URL を検査し、インデックス登録の判定、カバレッジ、クロール情報、正規 URL を表示します。何も変更されません。

あなた： 送信済みのサイトマップを確認し、エラーのあるサイトマップを再送信する準備をしてください。

アシスタント： サイトマップ、その警告とエラーを表示し、再送信する前に確認を求めます。

あなた： 確認します。

アシスタント： 選択したサイトマップを再送信します。ページのコンテンツは変更されず、インデックス登録が保証されることもありません。

目次

• クイックスタート
• できること
• Search Console のプロパティの仕組み
• 変更される可能性のあるもの
• アクセス権の取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20+ と Google アカウントが必要です。インストール時に認証情報は必要ありません。サーバーは会話から接続します。

1. AI アプリにサーバーを追加します。
2. 「Google Search Console に接続」と伝えると、設定ファイルを編集しなくても、アシスタントがOAuth クライアントの作成とアクセスの承認を案内します。
3. 上記の読み取り専用の質問から始めます。

codex mcp add google-search-console \
  -- npx -y mcp-google-search-console@latest
codex mcp list

claude mcp add \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

どのようなことを依頼できますか

検索機会を見つける

• 今月、最も多くのクリックを獲得したクエリとページはどれですか？
• 前の期間と比べてクリック数が減少したページはどれですか？
• 平均掲載順位が 10 未満で、mcp を含むクエリを表示してください。

インデックス登録状況とサイトマップを確認する

• この URL はインデックスに登録されていますか？カバレッジ、クロール、正規 URL の情報を表示してください。
• 送信済みのサイトマップのうち、エラーや警告があるものはどれですか？
• 現在のステータスを表示してから、このサイトマップを再送信してください。

プロパティを慎重に管理する

• アクセスできる Search Console プロパティを一覧表示してください。
• このプロパティ値をそのまま追加してください。所有権は別途確認します。
• 確認後、このプロパティをアカウントから削除してください。

Search Console プロパティの仕組み

URL プレフィックス プロパティには、プロトコルと末尾のスラッシュを含める必要があります。例：https://example.com/。ドメイン プロパティは sc-domain:example.com と記述します。値が少しでも異なると 403 または 404 が返されるため、list_sites が返す値をそのまま使用してください。

add_site はプロパティを登録するだけです。確認は Search Console の UI または Site Verification API で行います。検索データには太平洋時間が使用されます。end_date は指定日を含み、確定した分析データには通常 2～3 日の遅延があります。data_state: "all" を指定すると、より新しい、まだ変化する可能性のある行が含まれる場合があります。

変更される内容

確認プロンプトは AI クライアントが制御します。サーバーは読み取り、書き込み、破壊的な呼び出しを区別できるようにマークするため、クライアントは調査と実際の変更を見分けられます。

アクセスの取得

Google Search Console では OAuth 2.0 が必要です。API キーだけでは不十分です。アクセス方法は 2 つあり、最初の方法では設定ファイルは不要です。

チャットから接続する（推奨）

「connect Google Search Console」と伝えると、アシスタントが一緒に手順を進めます。

1. setup_instructions を実行すると、チェックリストが表示されます。Google Cloud プロジェクトを作成または選択し、Google Search Console API を有効にして、同意画面を設定し、Desktop app の OAuth クライアントを作成します。
2. そのクライアントの JSON（「Download JSON」）をダウンロードし、アシスタントにそのパスを伝えます。set_client が所有者のみアクセスできるよう保存します。シークレットが会話を経由することはありません。
3. start_login を実行すると、Google の同意リンクが返されます。このマシン上でリンクを開いて承認してください。コードは 127.0.0.1 のワンショットリスナーに返されます（PKCE）。チャットを経由することはありません。
4. finish_login がコードを交換し、トークンを ~/.config/mcp-google-search-console/credentials.json（モード 0600）に保存して、実際に Google Search Console API を呼び出してトークンを検証します。そのため、API がまだ有効になっていない場合も、その場で検出されます。

トークンは呼び出しのたびに再読み込みされるため、AI アプリを再起動せずにすぐ接続が機能します。auth_status で接続状況を確認でき、logout で認証を取り消してトークンを削除できます。

環境変数（CI、自動化されたインストール）

1. Google Cloud プロジェクトを作成または選択し、Google Search Console API を有効にします。
2. OAuth 同意画面を設定し、Desktop app の OAuth クライアントを作成します。
3. OAuth 2.0 Playground で Use your own OAuth credentials を選択し、プロパティにアクセスできる Google アカウントを認証して、更新トークンを取得します。
4. サイトマップとプロパティの変更を含めるには https://www.googleapis.com/auth/webmasters を使用します。読み取り専用アクセスが意図的に必要な場合に限り、https://www.googleapis.com/auth/webmasters.readonly を使用してください。

テストモードの更新トークンは、7 日後に期限切れになる場合があります。長期間アクセスするには、OAuth アプリを公開するか、Internal Workspace アプリを使用してください。クライアントシークレットと更新トークンはパスワードとして扱ってください。

設定

すべての変数は省略可能です。変数を何も設定しない場合、サーバーはチャットから接続します。

* OAuth の 3 つの値、またはアクセストークンのいずれかを指定してください。

データ、制限、バックグラウンド処理

• プライバシー。 ローカルサーバーは Google にリクエストを送信し、インストール ID、バージョン、ツール名を含む匿名のテレメトリを送信します。OAuth トークン、プロパティデータ、ツールの引数、プロンプトは送信しません。オプトアウトするには、ASKADS_TELEMETRY=0 を設定してください。
• API の制限。 URL 検査は、プロパティごとに 1 日 2,000 件、1 分あたり 600 件までです。アナリティクスで返されるのは、リクエストごとに最大 25,000 行です。匿名化されたロングテールクエリは返されません。ページネーションを使用し、サイト全体の URL を 1 件ずつ検査することは避けてください。
• バックグラウンド監視はありません。 サーバーは呼び出されたときにのみ動作します。AI アプリがスケジュールされたタスクに対応している場合は、サイトマップや重要な URL を定期的に確認できます。

技術ドキュメント

• MCP 機能カタログ — 各ツールのタスク別ページ。
• すべてのツールと入力
• 開発ドキュメント
• 公開ドキュメント
• Google Search Console API

サポート

バグを見つけた場合や、必要なシナリオがある場合は、issue を作成するか、Telegramにご連絡ください。

最後までご覧いただき、ありがとうございます！