Google Search Console MCP Server Ns9

🚀 Google 検索コンソール MCP サーバー

Google Search Console API を提供する MCP サーバーです。n8n ワークフローの MCP クライアントノードで使用できます。

🚀 クイックスタート

このサーバーは、Google Search Console API を提供し、n8n ワークフローの MCP クライアントノードで使用することができます。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• すべての検索コンソールサイトをリストする
• 検索分析データを取得する
• トップの検索キーワードとページを表示する
• 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  # 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 などの既存のサービスアカウントがある場合は、それを再利用して検索コンソールを処理することができます。

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

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

サービスアカウントがない場合は、次の手順で新しいサービスアカウントを作成します。

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

n8n との連携

1. n8n を開き、ワークフローに MCP クライアント（STDIO）ノードを追加します
2. 資格情報を構成します：
   • コマンド：/pad/naar/.venv/bin/python （例：/home/username/google-search-console-mcp/.venv/bin/python）
   • パラメータ：/pad/naar/google_search_console_server.py（例：/home/username/google-search-console-mcp/google_search_console_server.py）
   • 環境：

     SERVICE_ACCOUNT_JSON=/pad/naar/service_account_credentials.json
     

例：トップの検索キーワードを取得する

1. ワークフローに MCP クライアントノードを追加します
2. 操作「ツールを実行」を選択します
3. ツールを選択します：get_top_queries
4. パラメータ：

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

利用可能なツール

• list_sites：すべての検索コンソールサイトをリストする
• get_search_analytics：検索分析データを取得する
• get_top_queries：トップの検索キーワードを取得する
• inspect_url：URL のインデックス状態を確認する
• get_sitemap_info：サイトマップ情報を取得する

自動インストール

完全自動インストールを行うには、install.sh スクリプトを使用することもできます。

chmod +x install.sh
./install.sh

セキュリティ

• サービスアカウントの資格情報はローカルに保存し、Git にプッシュしないようにしてください（.gitignore を使用）
• credentials.json ファイルは常に安全な場所に保管してください
• 必要なサービスアカウントにのみ、検索コンソールプロパティへのアクセス権を付与してください

📄 ライセンス

MIT

貢献

プルリクエストは大歓迎です。大きな変更の場合は、まず問題を開いて、変更したい内容について議論してください。