Google Search Console MCP Server

Google Search Console MCP Server

このプロジェクトは、Amin Foroutan が開発した mcp-gsc のフォークです。この素晴らしいツールを作成した原作者に、心より感謝いたします。

Google Search Console（GSC）と Claude AI Desktop を連携するツールです。自然言語で会話しながら、SEO データを分析できます。この連携により、プロパティ情報、キーワード分析、URL 検査、サイトマップ管理にアクセスでき、すべて Claude との簡単なチャットで行えます。

---

SEO の専門家に役立つ機能

1. プロパティ管理

   • GSC のすべてのプロパティを一度に表示
   • 確認の詳細と基本的なサイト情報を取得
   • アカウントにサイトを追加
   • アカウントからサイトを削除

2. 検索分析とレポート

   • 訪問者を呼び込んでいる検索内容を確認
   • 表示回数、クリック数、クリック率を追跡
   • 期間ごとのパフォーマンス傾向を分析
   • 異なる期間を比較して変化を確認
   • Claude が生成するグラフでデータを視覚化

3. URL 検査とインデックス登録

   • 特定のページにインデックス登録の問題がないか確認
   • Google が最後にページをクロールした日時を確認
   • 複数の URL を一度に検査
   • インデックス登録状況を改善するための実用的な提案を取得

4. サイトマップ管理

   • すべてのサイトマップとそのステータスを表示
   • Claude を通じて新しいサイトマップを直接送信
   • サイトマップのエラーや警告を確認
   • サイトマップの処理状況を監視

---

利用可能なツール

連携の設定後に、Claude に依頼できる操作は次のとおりです。

依頼できること	実行する内容	必要な情報
list_properties	すべての GSC プロパティを表示	情報の提供は不要
get_site_details	特定のサイトの詳細を表示	サイトの URL
add_site	GSC のプロパティにサイトを追加	サイトの URL
delete_site	GSC のプロパティからサイトを削除	サイトの 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 に「list tools」と依頼してください。

---

クイックスタート（プログラミングの経験は不要です！）

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

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

認証方法

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

1. OAuth 認証（推奨）

この方法では、自分の Google アカウントで認証します。通常、サービスアカウントを使うより簡単で、普段アクセスできるリソースにアクセスできます。

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

設定手順：

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. client secrets JSON ファイルをダウンロードします（ファイル名は client_secrets.json のようになります）
11. このファイルをスクリプトと同じディレクトリに配置するか、GSC_OAUTH_CLIENT_SECRETS_FILE 環境変数にファイルの場所を設定します

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

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

この方法ではサービスアカウントを使用します。自動化スクリプトに適しているほか、個人アカウントを使用したくない場合にも利用できます。サービスアカウントを GSC に追加する必要があります。

設定手順：

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 プロパティに追加します

上の画像をクリックすると、手順を説明する動画を視聴できます

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

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

• Python（3.11 以降）- GSC と Claude の接続に使用します
• Node.js - MCP インスペクターと一部の MCP コンポーネントの実行に使用します
• Claude Desktop - 会話に使用する AI アシスタントです

Python と Node.js が正しくインストールされ、システムパスに追加されていることを確認してください。

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

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

1. このページの上部にある緑色の「Code」ボタンをクリックします
2. 「Download ZIP」を選択します
3. ファイルを見つけやすい場所（Documents フォルダーなど）に解凍します

または、Git に慣れている場合：

git clone https://github.com/naihaoko/gsc-mcp-server.git

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

ターミナル（Mac）またはコマンドプロンプト（Windows）を開きます。

1. 解凍したフォルダーに移動します：

   # 範例（請依實際路徑調整）
   cd ~/Documents/gsc-mcp-server
   

2. 仮想環境を作成します（プロジェクトの依存関係を分離します）：

   # 使用 uv（推薦）：
   uv venv .venv
   
   # 若未安裝 uv，先安裝：
   pip install uv
   # 再建立虛擬環境：
   uv venv .venv
   
   # 或用標準 Python：
   python -m venv .venv
   

   注意： uv または pip のインストール時に「pip not found」エラーが表示される場合は、下記の説明を参照してください。

3. 仮想環境を有効にします：

   # Mac/Linux：
   source .venv/bin/activate
   
   # Windows：
   .venv\Scripts\activate
   

4. 必要な依存関係をインストールします：

   # 使用 uv：
   uv pip install -r requirements.txt
   
   # 或用標準 pip：
   pip install -r requirements.txt
   

   「pip not found」エラーが表示される場合：

   # 先確保 pip 已安裝並升級：
   python3 -m ensurepip --upgrade
   python3 -m pip install --upgrade pip
   
   # 再嘗試安裝依賴：
   python3 -m pip install -r requirements.txt
   
   # 或安裝 uv：
   python3 -m pip install uv
   

コマンドプロンプトの先頭に (.venv) が表示されていれば、仮想環境が有効になっています。依存関係はここにインストールされるため、システムの Python には影響しません。

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

1. Claude Desktop をダウンロードしてインストールします（まだインストールしていない場合）
2. Google サービス アカウントの認証情報ファイルを用意します
3. ターミナル（Mac）またはコマンドプロンプト（Windows）を開き、次を入力します：

   # Mac 用戶：
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # Windows 用戶：
   notepad %APPDATA%\Claude\claude_desktop_config.json

4. 以下の設定を追加します（GSC への接続方法を Claude に伝えます）：

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

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/gsc-mcp-server/.venv/bin/python",
      "args": ["/FULL/PATH/TO/gsc-mcp-server/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/gsc-mcp-server/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/FULL/PATH/TO/service_account_credentials.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

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

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

例：

• Mac：
  • Python のパス：/Users/yourname/Documents/gsc-mcp-server/.venv/bin/python
  • スクリプトのパス：/Users/yourname/Documents/gsc-mcp-server/gsc_server.py
• Windows：
  • Python のパス：C:\\Users\\yourname\\Documents\\gsc-mcp-server\\.venv\\Scripts\\python.exe
  • スクリプトのパス：C:\\Users\\yourname\\Documents\\gsc-mcp-server\\gsc_server.py

5. ファイルを保存します：

   • Mac：Ctrl+O を押してから Enter を押し、次に Ctrl+X を押して終了します
   • Windows：「ファイル > 保存」をクリックしてから、Notepad を閉じます

6. Claude Desktop を再起動します

7. Claude を開くと、ツールセクションに GSC ツールが表示されます

6. 開始分析你的 SEO 數據！

現在你可以請 Claude 查詢你的 GSC 數據！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	「顯示 mywebsite.com 過去 30 天的前 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 的查詢，並建議內容改進以提升排名。」

你也可以請 Claude 結合多個工具並分析結果。例如：

• 「找出我前 20 個流量最高的登陸頁，檢查其索引狀態，並建立報告，標出同時有高流量與索引問題的頁面。」
• 「分析我網站過去 90 天的表現趨勢，找出成長最快的查詢，並檢查對應登陸頁是否有技術問題。」
• 「比較桌機與行動裝置搜尋表現，用圖表視覺化差異，並根據表現落差建議需行動優化的頁面。」
• 「找出排名在第 2 頁（第 11-20 名）且曝光高但 CTR 低的查詢，檢查對應網址並建議標題與描述改進。」

Claude 會用 GSC 工具取得資料、易懂呈現、產生視覺化圖表，並根據結果給出可行建議。

---

資料視覺化能力

Claude 可協助你用多種方式視覺化 GSC 數據：

• 趨勢圖：查看指標隨時間變化
• 比較圖：比較不同時期或維度
• 表現分布圖：了解內容在各排名的表現
• 相關性分析：找出不同指標間的關聯
• 熱力圖：用色彩呈現複雜資料

分析數據時只要請 Claude「視覺化」或「建立圖表」，它會產生合適的圖表協助你理解資訊。

---

疑難排解

找不到 Python 指令

在 macOS 上，預設 Python 指令通常是 python3 而非 python，這可能導致部分應用（包含 Node.js 整合）出錯。

若遇到 Python 找不到的錯誤，可建立別名：

1. 建立 Python 別名（只需一次）：

   # macOS 用戶：
   sudo ln -s $(which python3) /usr/local/bin/python
   
   # 若無效，嘗試尋找 Python 安裝路徑：
   sudo ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /usr/local/bin/python
   

2. 驗證別名是否有效：

   python --version
   

這會建立符號連結，讓應用程式呼叫 python 時實際使用你的 python3。

Claude 設定問題

若連線有困難：

1. 確認所有設定檔路徑正確且為完整路徑
2. 檢查服務帳號是否有存取 GSC 資產
3. 重新啟動 Claude Desktop
4. 嘗試使用工具時，查看 Claude 回應中的錯誤訊息
5. 手動執行伺服器時，確認虛擬環境已啟動

其他異常問題

若安裝或使用過程遇到其他異常：

1. 複製完整錯誤訊息
2. 用 ChatGPT 或 Claude 詳細說明你的問題，包括：
   • 你嘗試做什麼
   • 完整錯誤訊息
   • 作業系統
   • 已嘗試的步驟
3. AI 助手通常能根據你的情境協助診斷與解決技術問題

大多數問題都曾被他人遇過，通常都有簡單解法。

---

貢獻

發現 bug 或有改進想法？歡迎在 GitHub 開 issue 或提交 pull request。