Skip to main content
Glama
Sign In
enesjakozh

Google Search Console MCP

by AminForou
Verified
GitHub
Python
44
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides tools for accessing Google Search Console data including property management, search analytics, URL inspection, and sitemap management. Enables analysis of SEO data through property listings, site details, search query metrics, indexing status checks, and sitemap submission.

SEO 向け Google Search Console MCP サーバー

Google Search Console （GSC）とClaude AIを接続するツール。自然言語での会話を通じてSEOデータを分析できます。この統合により、Claudeとの簡単なチャットを通じて、プロパティ情報、検索アナリティクス、URL検査、サイトマップ管理など、あらゆる機能にアクセスできます。

このツールは SEO プロフェッショナルに何をもたらすのでしょうか?

  1. 不動産管理
    • すべての GSC プロパティを 1 か所で確認できます
    • 検証の詳細とサイトの基本情報を取得する
    • アカウントに新しいプロパティを追加する
    • アカウントからプロパティを削除する
  2. 検索分析とレポート
    • どのような検索クエリがあなたのサイトに訪問者を誘導しているかを知る
    • インプレッション、クリック、クリックスルー率を追跡する
    • パフォーマンスの傾向を時間の経過とともに分析する
    • 異なる期間を比較して変化を見つける
    • クロードが作成したチャートとグラフでデータを視覚化します
  3. URL検査とインデックス作成
    • 特定のページにインデックスの問題があるかどうかを確認する
    • Google が最後にページをクロールした日時を確認する
    • 複数のURLを一度に検査してパターンを特定する
    • インデックス作成の改善方法に関する実用的な洞察を得る
  4. サイトマップ管理
    • すべてのサイトマップとそのステータスを表示します
    • 新しいサイトマップをClaude経由で直接送信する
    • サイトマップ内のエラーや警告を確認する
    • サイトマップの処理ステータスを監視する

利用可能なツール

この統合を設定したら、Claude に次の操作を依頼できます。

あなたが求めるもの何をするのかご用意いただくもの
list_propertiesGSCプロパティをすべて表示何もないです。ただ聞いてください!
get_site_details特定のサイトの詳細を表示しますウェブサイトのURL
add_siteGSC プロパティに新しいサイトを追加しますウェブサイトのURL
delete_siteGSC プロパティからサイトを削除しますウェブサイトのURL
get_search_analytics上位のクエリとページを指標とともに表示しますウェブサイトのURLと期間
get_performance_overviewサイトのパフォーマンスの概要を示しますウェブサイトのURLと期間
check_indexing_issuesページにインデックスの問題があるかどうかを確認しますウェブサイトのURLと確認するページのリスト
inspect_url_enhanced特定のURLの詳細な検査ウェブサイトのURLと検査するページ
get_sitemapsサイトのすべてのサイトマップを一覧表示しますウェブサイトのURL
submit_sitemap新しいサイトマップをGoogleに送信するウェブサイトのURLとサイトマップのURL

利用可能な 19 個のツールの完全なリストとその詳細な説明については、セットアップ後に Claude に「ツールの一覧を表示」するように依頼してください。

はじめに（コーディング経験は必要ありません）

1. Google Search Console APIアクセスを設定する

このツールを使用する前に、Claude が GSC データにアクセスできるようにする API 認証情報を作成する必要があります。

認証オプション

このツールは、次の 2 つの認証方法をサポートしています。

1. OAuth認証（推奨）

この方法では、ご自身のGoogleアカウントで認証できるため、サービスアカウントを使用するよりも便利です。通常と同じリソースにアクセスできます。

OAuth認証をスキップし、サービスアカウント認証のみを使用するには、 GSC_SKIP_OAUTH 「true」、「1」、または「yes」に設定します。

セットアップ手順:
  1. Google Cloud Consoleにアクセスし、Google Cloud アカウントをお持ちでない場合は作成してください。
  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
  3. プロジェクトでSearch Console API を有効にする
  4. プロジェクトにスコープhttps://www.googleapis.com/auth/webmastersを追加します
  5. 「資格情報」ページへ
  6. 「認証情報を作成」をクリックし、「OAuthクライアントID」を選択します。
  7. OAuth同意画面を設定する
  8. アプリケーションの種類として「デスクトップアプリ」を選択します
  9. OAuthクライアントに名前を付けて、「作成」をクリックします。
  10. クライアント シークレットの JSON ファイルをダウンロードします ( client_secrets.jsonのような名前になります)
  11. このファイルをスクリプトと同じディレクトリに配置するか、 GSC_OAUTH_CLIENT_SECRETS_FILE環境変数を設定してその場所を指定します。

OAuth認証でツールを初めて実行すると、ブラウザウィンドウが開き、Googleアカウントへのログインとアプリケーションの承認を求められます。承認後、ツールはトークンを保存し、将来使用できるようにします。

2. サービスアカウント認証

この方法ではサービスアカウントを使用します。これは、自動化されたスクリプトや、個人のGoogleアカウントを使いたくない場合に便利です。この方法では、Google Search Consoleにサービスアカウントをユーザーとして追加する必要があります。

セットアップ手順:
  1. Google Cloud Consoleにアクセスし、Google Cloud アカウントをお持ちでない場合は作成してください。
  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
  3. プロジェクトでSearch Console API を有効にする
  4. 「資格情報」ページへ
  5. 「認証情報を作成」をクリックし、「サービスアカウント」を選択します
  6. サービスアカウントの詳細を入力し、「作成」をクリックします
  7. 新しく作成されたサービスアカウントをクリックします
  8. 「キー」タブに移動し、「キーの追加」>「新しいキーの作成」をクリックします。
  9. JSON形式を選択し、「作成」をクリックします
  10. キーファイルをダウンロードし、スクリプトと同じディレクトリにservice_account_credentials.jsonとして保存するか、 GSC_CREDENTIALS_PATH環境変数を設定してその場所を指定します。
  11. サービス アカウントのメールアドレスを適切な Search Console プロパティに追加します

🎬 初心者向けのチュートリアルを YouTube でご覧ください:

上の画像をクリックして、ステップバイステップのビデオチュートリアルをご覧ください。

2. 必要なソフトウェアをインストールする

次のツールをコンピューターにインストールする必要があります。

  • Python (バージョン3.11以降) - GSCとClaude間の接続を実行します
  • Node.js - MCPインスペクタと特定のMCPコンポーネントを実行するために必要
  • Claude Desktop - チャットできるAIアシスタント

続行する前に、Python と Node.js の両方が適切にインストールされ、システム パスで使用可能であることを確認してください。

3. Google Search Console MCPをダウンロードする

このツールをコンピュータにダウンロードする必要があります。最も簡単な方法は次のとおりです。

  1. このページの上部にある緑色の「コード」ボタンをクリックしてください
  2. 「ZIPをダウンロード」を選択
  3. ダウンロードしたファイルを、簡単に見つけられる場所（ドキュメントフォルダなど）に解凍します。

あるいは、Git に精通している場合は、次の操作を行います。

git clone https://github.com/AminForou/mcp-gsc.git

4. 必要なコンポーネントをインストールする

コンピュータのターミナル (Mac) またはコマンド プロンプト (Windows) を開きます。

  1. ファイルを解凍したフォルダに移動します。
    # Example (replace with your actual path): cd ~/Documents/mcp-gsc-main
  2. 仮想環境を作成します (これにより、プロジェクトの依存関係が分離されます)。
    # Using uv (recommended): uv venv .venv # If uv is not installed, install it first: pip install uv # Then create the virtual environment: uv venv .venv # OR using standard Python: python -m venv .venv
    注意: uv をインストールしようとしたときに「pip が見つかりません」というエラーが表示される場合は、以下の「「pip が見つかりません」というエラーが表示される場合」のセクションを参照してください。
  3. 仮想環境をアクティブ化します。
    # On Mac/Linux: source .venv/bin/activate # On Windows: .venv\Scripts\activate
  4. 必要な依存関係をインストールします。
    # Using uv: uv pip install -r requirements.txt # OR using standard pip: pip install -r requirements.txt
    「pip が見つかりません」というエラーが発生した場合:
    # First ensure pip is installed and updated: python3 -m ensurepip --upgrade python3 -m pip install --upgrade pip # Then try installing the requirements again: python3 -m pip install -r requirements.txt # Or to install uv: python3 -m pip install uv

コマンド プロンプトの先頭に(.venv)が表示される場合、仮想環境がアクティブであり、システムの Python インストールに影響を与えずに依存関係がそこにインストールされることを意味します。

5. ClaudeをGoogle Search Consoleに接続する

  1. Claude Desktopをまだダウンロードしていない場合はダウンロードしてインストールしてください。
  2. Googleサービスアカウントの認証情報がコンピュータのどこかに保存されていることを確認してください
  3. コンピュータのターミナル (Mac) またはコマンド プロンプト (Windows) を開き、次のように入力します。
# For Mac users: nano ~/Library/Application\ Support/Claude/claude_desktop_config.json # For Windows users: notepad %APPDATA%\Claude\claude_desktop_config.json
  1. 次の構成テキストを追加します (これにより、Claude に GSC への接続方法が伝えられます)。

OAuth認証（自分のアカウントを使用）

{ "mcpServers": { "gscServer": { "command": "/FULL/PATH/TO/-main/.venv/bin/python", "args": ["/FULL/PATH/TO/mcp-gsc-main/gsc_server.py"], "env": { "GSC_OAUTH_CLIENT_SECRETS_FILE": "/FULL/PATH/TO/client_secrets.json" } } } }

サービスアカウント認証

{ "mcpServers": { "gscServer": { "command": "/FULL/PATH/TO/-main/.venv/bin/python", "args": ["/FULL/PATH/TO/mcp-gsc-main/gsc_server.py"], "env": { "GSC_CREDENTIALS_PATH": "/FULL/PATH/TO/service_account_credentials.json", "GSC_SKIP_OAUTH": "true" } } } }

**重要:**すべてのパスをコンピュータ上の実際の場所に置き換えてください。

  • 最初のパスは仮想環境内のPython実行ファイルを指す必要があります
  • 2番目のパスは、解凍したフォルダ内のgsc_server.pyファイルを指す必要があります。
  • 3番目のパスは、Googleサービスアカウントの認証情報JSONファイルを指す必要があります。

例:

  • マック：
    • Python パス: /Users/yourname/Documents/mcp-gsc/.venv/bin/python
    • スクリプトのパス: /Users/yourname/Documents/mcp-gsc/gsc_server.py
  • ウィンドウズ:
    • Python パス: C:\\Users\\yourname\\Documents\\mcp-gsc\\.venv\\Scripts\\python.exe
    • スクリプト パス: C:\\Users\\yourname\\Documents\\mcp-gsc\\gsc_server.py
  1. ファイルを保存します。
    • Mac: Ctrl+O、Enter、Ctrl+X の順に押して終了します。
    • Windows: ファイル > 保存をクリックし、メモ帳を閉じます。
  2. Claudeデスクトップを再起動します
  3. Claudeを開くと、ツールセクションにGSCツールが表示されるはずです。

6. SEO データの分析を始めましょう!

GSCデータについて、Claudeに質問できるようになりました！Claudeはデータの取得だけでなく、分析、傾向の説明、そしてSEOパフォーマンスをより深く理解するための視覚化も行います。

各ツールで使用できる強力なプロンプトをいくつか紹介します。

ツール名サンプルプロンプト
list_properties「すべての GSC プロパティを一覧表示し、最も多くのページがインデックスされているものを教えてください。」
get_site_details「mywebsite.com の検証ステータスを分析し、所有権の詳細が何を意味するのか説明してください。」
add_site「新しいウェブサイトhttps://mywebsite.comを Search Console に追加し、そのステータスを確認します。」
delete_site「Search Console から古いテストサイトhttps://test.mywebsite.comを削除します。」
get_search_analytics「過去 30 日間の mywebsite.com の上位 20 件の検索クエリを表示し、CTR が 2% 未満のものを強調表示して、タイトルの改善を提案してください。」
get_performance_overview「mywebsite.com の過去 28 日間のパフォーマンスの概要を視覚的に作成し、異常な低下や急上昇を特定し、考えられる原因を説明します。」
check_indexing_issues「これらの重要なページでインデックスの問題がないか確認し、すぐに対応が必要なページを優先順位付けしてください: mywebsite.com/product、mywebsite.com/services、mywebsite.com/about」
inspect_url_enhanced「mywebsite.com/landing-page を徹底的に検査し、インデックスステータスを改善するための実用的な推奨事項を提供してください。」
batch_url_inspection「上位 5 つの製品ページを検査し、一般的なクロールやインデックス作成のパターンを特定し、技術的な SEO の改善を提案してください。」
get_sitemaps「mywebsite.com のすべてのサイトマップを一覧表示し、エラーのあるサイトマップを特定し、次の手順を推奨します。」
list_sitemaps_enhanced「mywebsite.com のすべてのサイトマップを分析し、エラー パターンに焦点を当てて、優先順位をつけたアクション プランを作成します。」
submit_sitemap「新しい製品サイトマップをhttps://mywebsite.com/product-sitemap.xmlに送信し、Google がサイトマップを処理するのに通常どのくらいの時間がかかるか説明してください。」
get_sitemap_details「mywebsite.com/sitemap.xml でメインのサイトマップのステータスを確認し、警告が SEO にとって何を意味するのかを説明してください。」
get_search_by_page_query「mywebsite.com/blog/post-title にある私のブログ投稿へのトラフィックを促進している検索用語は何ですか? 関連キーワードを最適化する機会を特定します。」
compare_search_periods「1月と2月のサイトのパフォーマンスを比較してください。どのクエリが最も改善し、どのクエリが減少しましたか？また、これらの変化の理由は何でしょうか？」
get_advanced_search_analytics「インプレッション数は多いが順位が 10 位未満のクエリについてモバイル検索のパフォーマンスを分析し、ランキングを上げるためのコンテンツの改善を提案します。」

複数のツールを組み合わせて結果を分析するよう、クロードに依頼することもできます。例えば：

  • 「トラフィックによる上位 20 のランディング ページを見つけて、インデックス ステータスを確認し、トラフィックが多く、インデックスの問題があるページを強調表示するレポートを作成します。」
  • 「過去 90 日間のサイトのパフォーマンス傾向を分析し、最も急成長しているクエリを特定し、対応するランディング ページに技術的な問題があるかどうかを確認します。」
  • 「デスクトップとモバイルの検索パフォーマンスを比較し、その違いをグラフで視覚化し、パフォーマンスのギャップに基づいてモバイルの最適化が必要な特定のページを推奨します。」
  • 「インプレッション数は多いがクリック率が低い、ページ 2 (11 ～ 20 位) にランクされているクエリを特定し、対応する URL を調べて、タイトルとメタ ディスクリプションの改善を提案します。」

Claude は GSC ツールを使用してデータを取得し、わかりやすい形式で提示し、必要に応じて視覚化を行い、結果に基づいて実用的な洞察を提供します。

データ視覚化機能

Claude はさまざまな方法で GSC データを視覚化するのに役立ちます。

  • トレンドチャート: 時間の経過とともに指標がどのように変化するかを確認します
  • 比較グラフ: 異なる期間や次元を比較する
  • パフォーマンス分布: コンテンツが各ポジションでどのようにパフォーマンスを発揮しているかを把握します
  • 相関分析：異なる指標間の関係を特定する
  • ヒートマップ: 複雑なデータセットを色分けされた表現で視覚化します

データを分析するときに、Claude に「視覚化」または「グラフを作成」するように依頼するだけで、情報をよりよく理解できるように適切な視覚化が生成されます。

トラブルシューティング

Pythonコマンドが見つかりません

macOS では、デフォルトの Python コマンドはpythonではなくpython3であることが多く、Node.js 統合を含む一部のアプリケーションで問題が発生する可能性があります。

Python が見つからないことに関連するエラーが発生した場合は、エイリアスを作成できます。

  1. Python エイリアスを作成します (1 回限りの設定):
    # For macOS users: sudo ln -s $(which python3) /usr/local/bin/python # If that doesn't work, try finding your Python installation: sudo ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /usr/local/bin/python
  2. エイリアスが機能することを確認します。
    python --version

これによりシンボリック リンクが作成され、アプリケーションがpythonを呼び出すときに、実際にはpython3インストールが使用されるようになります。

クロード構成の問題

接続に問題がある場合:

  1. 設定内のすべてのファイルパスが正しいことを確認し、フルパスを使用してください。
  2. サービスアカウントがGSCプロパティにアクセスできることを確認してください
  3. 変更を加えた後はClaude Desktopを再起動してください。
  4. ツールを使用しようとすると、Claude の応答でエラーメッセージが表示されることがあります。
  5. サーバーを手動で実行するときに仮想環境がアクティブになっていることを確認してください

その他の予期しない問題

インストール中または使用中にその他の予期しない問題が発生した場合:

  1. 受け取ったエラーメッセージを正確にコピーしてください
  2. ChatGPT または Claude を使用して、次のような問題を詳しく説明してください。
    • 何をしようとしていたのか
    • 正確なエラーメッセージ
    • オペレーティングシステム
    • すでに試した手順
  3. AIアシスタントは、状況に応じた具体的な解決策を提案することで、技術的な問題の診断と解決に役立つことが多い。

ほとんどの問題は以前にも他の人が遭遇したことがあり、通常は簡単な解決策があるということを覚えておいてください。

貢献

バグを見つけたり、改善のアイデアをお持ちですか？ご意見をお待ちしております。GitHub で問題を報告するか、プルリクエストを送信してください。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

Google Search Console を Claude AI に接続することで、SEO プロフェッショナルが自然言語の会話を通じて SEO データを分析し、プロパティ情報、検索分析、URL 検査、サイトマップ管理にアクセスできるようになります。

  1. What Can This Tool Do For SEO Professionals?
    1. Available Tools
      1. Getting Started (No Coding Experience Required!)
        1. 1. Set Up Google Search Console API Access
        2. 2. Install Required Software
        3. 3. Download the Google Search Console MCP
        4. 4. Install Required Components
        5. 5. Connect Claude to Google Search Console
        6. 6. Start Analyzing Your SEO Data!
      2. Data Visualization Capabilities
        1. Troubleshooting
          1. Python Command Not Found
          2. Claude Configuration Issues
          3. Other Unexpected Issues
        2. Contributing
          1. License

            Appeared in Searches

            ID: g04bfrjz9i