Google Search Console MCP Server

Google Search Console MCP サーバー

MCP サーバーを使用すると、MCP Client ノードを介して n8n ワークフローで Google Search Console API を利用できます。

機能

• Search Console のすべてのサイトを一覧表示
• 検索アナリティクスデータを取得
• 上位の検索語句とページを表示
• URL のインデックス登録状況を確認
• サイトマップ情報を取得

インストール

1. サーバーに Python 3.7+ がインストールされていることを確認します

2. リポジトリをクローンします：

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

3. 仮想環境を作成し、依存関係をインストールします：

   python3 -m venv .venv
   source .venv/bin/activate  # Op Windows: .venv\Scripts\activate
   pip install -r requirements.txt
   

4. スクリプトを実行可能にします：

   chmod +x google_search_console_server.py
   chmod +x setup-credentials.sh
   

5. サービスアカウントの認証情報をセットアップします：

   ./setup-credentials.sh
   

   既存のサービスアカウント認証情報ファイルを使用するか、JSON を直接貼り付けることができます。

Google API の認証情報

既存のサービスアカウントを再利用する

すでにサービスアカウント（たとえば、Google Ads 用）がある場合は、Search Console でも同じアカウントを使用できます：

1. セットアップスクリプトを実行します：./setup-credentials.sh
2. オプション 1 または 2 を選択して、既存の認証情報を入力します
3. サービスアカウントに Search Console プロパティへのアクセス権を付与します：
   • Google Search Console に移動します
   • プロパティを選択します
   • 設定 > ユーザーと権限をクリックします
   • サービスアカウントのメールアドレスをユーザーとして追加します

新しいサービスアカウントを作成する

まだサービスアカウントがない場合：

1. Google Cloud Console に移動します
2. 新しいプロジェクトを作成するか、既存のプロジェクトを使用します
3. Google Search Console API を有効にします
4. サービスアカウントを作成します
5. JSON 認証情報ファイルをダウンロードします
6. セットアップスクリプトを使用して認証情報を設定します：./setup-credentials.sh

n8n での使用方法

1. n8n を開き、MCP Client (STDIO) ノードを追加します
2. 認証情報を設定します：
   • Command：/pad/naar/.venv/bin/python（例：/home/username/google-search-console-mcp/.venv/bin/python）
   • Arguments：/pad/naar/google_search_console_server.py（例：/home/username/google-search-console-mcp/google_search_console_server.py）
   • Environment：

     SERVICE_ACCOUNT_JSON=/pad/naar/service_account_credentials.json
     

例：上位の検索語句を取得する

1. ワークフローに MCP Client ノードを追加します
2. 操作「Execute Tool」を選択します
3. ツール「get_top_queries」を選択します
4. パラメーター：

   {
     "site_url": "sc-domain:example.com",
     "start_date": "2023-01-01",
     "end_date": "2023-01-31"
   }
   

利用可能なツール

• list_sites：Search Console のすべてのサイトを一覧表示
• get_search_analytics：サイトの検索アナリティクスデータを取得
• get_top_queries：サイトの上位検索語句を取得
• get_top_pages：サイトの上位ページを取得
• get_queries_for_url：特定の URL の検索語句を取得
• inspect_url：URL のインデックス登録状況を確認
• list_sitemaps：サイトのすべてのサイトマップを一覧表示

n8n ワークフローの例

例 1：すべてのサイトを一覧表示する

{
  "tool": "list_sites",
  "parameters": {}
}

例 2：過去 30 日間の上位 10 ページ

{
  "tool": "get_top_pages",
  "parameters": {
    "site_url": "sc-domain:example.com",
    "start_date": "2023-03-01",
    "end_date": "2023-03-31",
    "row_limit": 10
  }
}

例 3：URL のインデックス登録状況を確認する

{
  "tool": "inspect_url",
  "parameters": {
    "site_url": "sc-domain:example.com",
    "url": "https://example.com/pagina"
  }
}

自動インストール

完全に自動でインストールするには、install.sh スクリプトも使用できます：

chmod +x install.sh
./install.sh

セキュリティ

• サービスアカウントの認証情報はローカルに保存され、Git にプッシュされません（.gitignore による）
• credentials.json ファイルは必ず安全な場所に保管してください
• サービスアカウントには、必要な Search Console プロパティへのアクセス権のみを付与してください

ライセンス

MIT

コントリビューション

プルリクエストを歓迎します。大きな変更を行う場合は、変更内容について話し合うため、まず issue を作成してください。