Google Search Console MCP Server

Google Search Console MCP サーバー

このプロジェクトは、Claude AI（Claude Desktop アプリ経由）などから Google Search Console API を操作できる Model Context Protocol（MCP）サーバーを提供します。Claude のチャット（またはその他のチャット）から直接、パフォーマンスデータのクエリ、URL の検査、インデックス登録状況の確認などを行えます。

X @metehan777 をフォローしたり、ブログ https://metehan.ai をご覧ください。

機能

このプロジェクトで利用できる Google Search Console API エンドポイントに基づき、次の機能を提供します。

• サイト： Search Console アカウントでアクセスできるサイト／プロパティを一覧表示します。
• 検索アナリティクス： さまざまなフィルターやディメンションを使って、検索パフォーマンスデータ（クリック数、表示回数、CTR、掲載順位）を取得します。
• URL 検査： Google インデックスにおける特定の URL のステータスを検査し、インデックス登録状況を確認して、インデックス登録をリクエストします。
• サイトマップ： サイトに送信されたサイトマップを一覧表示します。
• （ヘルパー） 検索アナリティクスデータをもとに、サイト全体のパフォーマンス概要を取得します。

（注：URL Inspection API で取得できる情報を超えるインデックス登録の対象範囲の詳細やクロールエラーは、通常、Google Search Console API では公開されていません。）

Search Console API の機能とお知らせについては、こちらをご覧ください：https://developers.google.com/webmaster-tools/v1/api_reference_index

前提条件

• Python： バージョン 3.11 以降。
• pip： Python パッケージインストーラー（通常は Python に付属しています）。
• 仮想環境ツール： venv（推奨。Python 3 に組み込まれています）。
• Google アカウント： クエリ対象の Google Search Console プロパティにアクセスできること。
• Claude Desktop アプリ： インストールされ、起動していること。

セットアップ手順

1. クローンまたはダウンロード： プロジェクトファイルをローカルマシンに取得します。git を使用する場合：

   git clone https://github.com/metehan777/google-search-console-mcp.git
   cd search-console-mcp
   

2. 仮想環境の作成と有効化： 依存関係を管理するため、仮想環境の使用を強くおすすめします。

   # 仮想環境を作成します（前の手順と同じく、名前には 'fresh_env' を使用します）
   python3 -m venv fresh_env
   
   # 環境を有効化します
   # macOS/Linux の場合：
   source fresh_env/bin/activate
   # Windows の場合：
   # .\fresh_env\Scripts\activate
   

   （ターミナルのプロンプトの先頭に (fresh_env) が表示されます）

3. 依存関係のインストール： プロジェクト自体を編集可能モードでインストールし、必要な Python パッケージをインストールします。

   pip install -e .
   

4. Google Cloud のセットアップと認証情報：

   • API を有効化： Google Cloud Console にアクセスし、新しいプロジェクトを作成するか、既存のプロジェクトを選択します。プロジェクトで「Google Search Console API」を有効にします。
   • OAuth 認証情報を作成：
     • 「APIs & Services」→「Credentials」に移動します。
     • 「+ CREATE CREDENTIALS」→「OAuth client ID」をクリックします。
     • 指示が表示された場合は、「OAuth consent screen」を設定します（ユーザータイプとして「External」を選択し、「Claude GSC Tool」のようなアプリ名とメールアドレスを入力して保存します）。
     • 「Application type」で 「Desktop app」 を選択します。
     • 名前を入力します（例：「Claude Desktop GSC Tool」）。
     • 「Create」をクリックします。
   • credentials.json をダウンロード： 作成後、「DOWNLOAD JSON」をクリックします。このファイルをプロジェクトディレクトリのルート（search-console-mcp/）に直接保存し、ファイル名が正確に credentials.json であることを確認します。
   • 重要： 誤ってコミットしないよう、credentials.json が .gitignore ファイルに記載されていることを確認してください。

5. 初回認証：

   • 認証を必要とするツールを初めて実行すると（手動で実行する場合も、Claude 経由で実行する場合も）、Google OAuth フローが開始されます。
   • Search Console のプロパティにアクセスできる Google アカウントへのログインを求める画面が、ウェブブラウザーに表示されます。
   • 設定したアプリケーション（「Claude GSC Tool」）に、要求された権限を付与します。
   • 認証が成功すると、プロジェクトディレクトリに token.json ファイルが作成されます。このファイルにはアクセストークンが保存されます。このリポジトリをフォークして再度プッシュ／プルする場合は、token.json をコミットしないでください。

サーバーの実行（開発／テスト）

主な用途は Claude Desktop との連携ですが、stdio トランスポートを使ってサーバーを直接テストできます： サーバーが起動し、標準入力／出力で JSON-RPC メッセージを待ち受けます。Ctrl+C を押すと停止できます。ログは標準エラー出力に表示されます。

Claude Desktop との連携

Claude Desktop アプリでツールを利用できるようにするには：

1. 設定ファイルを探す： Claude Desktop の設定ファイルを探します。macOS では通常、次の場所にあります： ~/Library/Application Support/Claude/claude_desktop_config.json

2. 設定を編集する： テキストエディターでファイルを開きます。mcpServers セクションに、このツールのエントリを追加または変更します。仮想環境内の python3 実行ファイルへの絶対パスを指定してください。

   {
     "mcpServers": {
       "filesystem": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-filesystem",
           "/Users/username/Desktop",
           "/Users/username/Downloads"
         ]
       },
       "google-search-console": {
         "command": "/Users/username/Documents/search-console-mcp/fresh_env/bin/python3",
         "args": [
           "-m",
           "main"
         ],
         "cwd": "/Users/username/Cursor/search-console-mcp"
       }
     }
   }
   

   • 重要： command フィールドと cwd フィールドの両方で、/Users/username/Documents/search-console-mcp を、お使いのシステム上のプロジェクトディレクトリの実際の絶対パスに置き換えてください。
   • mcpServers にほかのサーバーがすでにある場合は、その隣に "google-search-console": { ... } ブロックを追加してください。

3. Claude Desktop を再起動する： 変更を反映するため、Claude Desktop アプリケーションを終了して再度開きます。

Claude での使用方法

設定と連携が完了したら、Claude にツールの使用を依頼できます。例：

• 「Google Search Console のサイト一覧を表示して。」
• 「過去 7 日間の example.com の検索パフォーマンスを、クエリ別に取得して。」
• 「サイト example.com の URL https://example.com/my-page を検査して。」
• 「example.com にモバイルユーザビリティの問題はある？」
• 「サイト example.com で https://example.com/new-article のインデックス登録をリクエストして。」

Claude は適切なツールを判断し、MCP サーバー経由で実行します。初回の認証フローで求められた場合は、権限を許可してください。

いつでも貢献や改善の提案をお寄せください！