Google Search Console MCP Server

Google Search Console MCP サーバー

🚀 はじめに：MCP サーバーのセットアップ

このチュートリアルでは、独自の MCP Model Context Protocol サーバーをセットアップし、Claude Desktop に追加して、Google Search Console（GSC）のデータと統合する手順をご紹介します。期間を比較して SEO の改善点を特定したり、棒グラフや折れ線グラフなどのビジュアルレポートを生成したり、クリック率、インプレッション、順位の変動を分析して最適化の機会を見つけたりできるようになります。

さっそく始めましょう！🚀

🔹 このガイドで説明する内容：

1. Google Cloud の認証情報を生成する – API アクセスを認証するためのサービスアカウント JSON キーを作成してダウンロードします。
2. 必要なツールをインストールする – Python、pip、uv、Git（任意）がシステムにインストールされていることを確認します。
3. MCP サーバーをセットアップする – リポジトリをクローンし、環境を設定して、MCP サーバーをインストールします。
4. Search Console のインサイトを有効にする – Claude Desktop で MCP サーバーが正しく動作していることを確認し、高度な検索分析ツールを使い始めます。

このガイドを終えると、Claude が MCP サーバーに自動的に接続するようになり、クエリを実行したり、データを可視化したり、ウェブサイトの検索パフォーマンスを簡単に最適化したりできるようになります。さっそく始めましょう！🚀

🔹 知っておいていただきたいこと

このチュートリアルは初心者向けに作られており、高度な技術スキルは必要ありません。ただし、コマンドライン（ターミナルまたはコマンドプロンプトとも呼ばれます）でコマンドを実行できる必要があります。

このガイドでは、次のようなコマンドを入力します。

python --version
git clone <repository-url>

コマンドラインを使ったことがなくてもご心配なく！手順に沿って一つずつ進めれば大丈夫です。

必要なのはこれだけです。それでは始めましょう！🚀

🎯 パート 1 - JSON 認証情報ファイルを生成する

以下の手順に沿って、Google Cloud Console からサービスアカウント JSON キーを作成してダウンロードします。すでに JSON 認証情報ファイルがある場合は、このパートをスキップできます。

📌 1. Google Cloud Console にアクセスする

🔗 Google Cloud Console にアクセス

📌 2. プロジェクトを選択する

• 上部のプロジェクト選択ツールをクリックします。
  

• 既存のプロジェクトを選択するか、新しいプロジェクトを作成します。

新しいプロジェクトを作成する場合：

Search Console API を有効にする

• 新しいプロジェクトが選択されていることを確認します

• APIs and Servicesをクリックします：

• Google Search Console API を探します（上部で検索する必要がある場合があります）

• **"Enable"**をクリックします

• ダッシュボードに戻ります（**"Google Cloud"**アイコンをクリックします）

📌 3. IAM & Admin セクションを開く

• 左側のメニューで、**"IAM & Admin" > "Service Accounts"**に移動します。

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

1. **"Create Service Account"**をクリックします。
2. 名前（例：my-app-service-account）を入力します。
3. **"Create and Continue"**をクリックします。

📌 5. 権限を割り当てる

• ロール（例：Editor、Owner）を選択します。
• **"Continue"**をクリックします。

📌 6. ユーザーへのアクセス権付与をスキップする（任意）

• **"Done"**をクリックします（ユーザーを追加する必要はありません）。

📌 7. JSON キーを生成する

1. リストからサービスアカウントを見つけます。
2. 右側の**3 つの点（⋮）をクリックし、"Manage Keys"**を選択します。
3. **"Add Key" > "Create New Key"**をクリックします。
4. **"JSON"形式を選択し、"Create"**をクリックします。
5. ✅ JSON ファイルが自動的にダウンロードされます。
6. JSON ファイルのパスをコピーします（右クリックして「パスとしてコピー」）

📌 8. Google Search Console にサービスアカウントを追加する

1. Google Search Console を開きます。
2. ウェブサイトのプロパティを選択します。
3. 設定（左下）をクリックします。
4. ユーザーと権限で、ユーザーを追加をクリックします。
5. サービスアカウントのメールアドレス（手順 4 のもの）を入力します。
6. 権限を割り当てます。
   • 制限付き（データの閲覧のみ）。
   • フル（プロパティの閲覧と管理）。
7. 追加をクリックします。

---

🎯 パート 2 - 必要なツールをインストールする

プロジェクトで作業を始める前に、必要なツールがインストールされていることを確認してください。次の手順に従って、準備が整っているか確認します。

📌 1. Python がインストールされているか確認する

次のコマンドを実行して、システムに Python がインストールされているか確認します。

Windows の場合：

python --version

Linux/macOS の場合：

python3 --version

Python がインストールされている場合は、バージョン番号が表示されます。インストールされていない場合は、🔗 Python をダウンロード からダウンロードしてインストールしてください。

📌 2. pip がインストールされているか確認する

pip は Python のパッケージマネージャーです。インストールされているか確認するには、次のコマンドを実行します。

Windows の場合：

pip --version

Linux/macOS の場合：

pip3 --version

pip がインストールされていない場合は、公式インストールガイド 🔗 pip をダウンロード に従ってください。

📌 3. uv がインストールされているか確認する

uv は Python のパッケージおよびプロジェクト管理ツールです。インストールされているか確認するには、次のコマンドを実行します。

Linux/macOS/Windows の場合：

uv --version

uv がインストールされていない場合は、公式インストールガイド 🔗 uv をダウンロード に従ってください。

📌 4. Claude Desktop がインストールされているか確認する

Claude Desktop がインストールされていない場合は、公式インストールガイド 🔗 Claude Desktop をダウンロード に従ってください。

📌 5. Git がインストールされているか確認する（任意）

次のコマンドを実行して、システムに Git がインストールされているか確認します。

Linux/macOS/Windows の場合：

git --version

Git がインストールされている場合は、バージョン番号が表示されます。インストールされていない場合でも、プログラムファイルをダウンロードできます。または、🔗 Git をダウンロード からダウンロードしてインストールできます。

---

🎯 パート 3 - Claude Desktop に MCP サーバーを追加する

セットアップ手順

1. リポジトリをクローンする

ファイルのダウンロード先フォルダーで、新しいターミナルを開きます。次のコマンドを実行します。

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

Git がインストールされていない場合：

• ZIP ファイルをダウンロードします。

2. 仮想環境を作成して有効化する

# Windows
uv venv
.venv\Scripts\activate

# macOS/Linux
uv venv
source .venv/bin/activate

3. 依存関係をインストールする

# Windows/macOS/Linux
uv sync

4. MCP サーバーをインストールする

JSON 認証情報ファイルのパスを指定し、次のコマンドを実行します。

mcp install server.py -v GOOGLE_APPLICATION_CREDENTIALS=<path to credentials file>

<path to credentials file> を、お使いの JSON 認証情報ファイルのパス（例：C:\Users\Me\Downloads\credentials.json）に置き換えてください。

5. Claude Desktop を再起動する

タスクマネージャーで Claude のタスクを終了する必要がある場合があります。

---

🎯 パート 4 - Search Console の分析情報を取得する

Claude Desktop を開きます。MCP サーバーが正しく設定されていれば、チャットボックスに 5 つの追加ツールが表示されます。

Claude にさまざまな Search Console の分析タスクを依頼して、ツールを使用できます。ツールを呼び出す前に、Claude が許可を求めます。MCP サーバーを使用するには、「許可」のいずれかのオプションをクリックしてください。

はじめに使えるプロンプト

• 「Google Search Console で確認済みのサイトをすべて一覧表示して」
• 「example.com の 2025 年 1 月 1 日から 1 月 31 日までの検索アナリティクスを表示して」
• 「example.com の先月と前月の検索パフォーマンスを比較して」
• 「過去 30 日間のクリック数上位 10 ページを教えて」
• 「過去 3 か月間の週ごとの検索トレンドを表示して」

データ可視化のプロンプト

• 「過去1か月間にクリック数が多かった上位5ページの棒グラフを作成してください」
• 「過去90日間のインプレッションの傾向を示す折れ線グラフを作成してください」
• 「サイトのモバイルとデスクトップのトラフィックにおけるCTRを比較して可視化してください」
• 「example.comの国別検索パフォーマンスをヒートマップで表示してください」
• 「デバイスタイプ別のトラフィックの割合を示す円グラフを作成してください」
• 「上位50件のクエリについて、CTRと掲載順位を比較する散布図を作成してください」
• 「検索タイプ（ウェブ、画像、動画）別にトラフィックソースの内訳を可視化してください」
• 「時間の経過に伴うクリック数とインプレッション数を示す積み上げ面グラフを作成してください」
• 「比較グラフで、前週比の検索パフォーマンスの変化を可視化してください」
• 「複数のグラフを使って、サイトのSEOパフォーマンスを視覚的にレポートしてください」

Search Console 分析のプロンプト

• 「インプレッション数は多いもののCTRが低く、最適化できるキーワードを特定してください」
• 「過去1か月間に掲載順位が下がったページを表示してください」
• 「過去30日間にサイトが新たに掲載順位を獲得したキーワードを探してください」
• 「デスクトップと比べてパフォーマンスの差が最も大きいモバイルページを分析してください」
• 「検索結果の2ページ目（掲載順位11～20位）に表示されていて、1ページ目に押し上げられる可能性のあるクエリを表示してください」
• 「過去1年間の検索トラフィックにおける季節的な傾向を特定してください」
• 「3月1日のサイトリニューアル前後のオーガニックトラフィックを比較してください」
• 「インプレッション数とクリック数に基づいて、成長の可能性が最も高い国を表示してください」
• 「上位100件のクエリについて、平均掲載順位とCTRの相関関係を分析してください」
• 「予想されるトラフィック増加量に基づいて、最適化の機会を優先順位付きで一覧にしてください」

利用可能なツール

list_sites

Google Search Console アカウント内の確認済みサイトをすべて一覧表示します。

query_search_analytics

Parameters:
- site_url: Full URL of your website (e.g., https://www.example.com/)
- start_date: Start date in YYYY-MM-DD format
- end_date: End date in YYYY-MM-DD format
- dimensions: List of dimensions (query, page, device, country, date)
- search_type: Type of search results (web, image, video, news, discover, googleNews)
- row_limit: Number of rows to return (max 25000)

compare_time_periods

Parameters:
- site_url: Full URL of your website
- current_start_date: Start date for current period in YYYY-MM-DD format
- current_end_date: End date for current period in YYYY-MM-DD format
- previous_start_date: Start date for previous period in YYYY-MM-DD format
- previous_end_date: End date for previous period in YYYY-MM-DD format
- dimensions: List of dimensions (query, page, device, country, date)
- search_type: Type of search results
- row_limit: Number of rows to return

get_top_performing_content

Parameters:
- site_url: Full URL of your website
- start_date: Start date in YYYY-MM-DD format
- end_date: End date in YYYY-MM-DD format
- metric: Metric to sort by (clicks, impressions, ctr, position)
- limit: Number of results to return

get_search_trends

Parameters:
- site_url: Full URL of your website
- start_date: Start date in YYYY-MM-DD format
- end_date: End date in YYYY-MM-DD format
- interval: Time interval for grouping (day, week, month)

🛠 トラブルシューティング

MCP サーバーの設定中または使用中に問題が発生した場合は、以下の解決策をお試しください。

1️⃣ Claude Desktopを再起動する

ツールがすぐに表示されない場合があります。Claude Desktopを再起動して、もう一度お試しください。 再起動する前に、タスクマネージャー（Windows）またはアクティビティモニタ（Mac）でClaudeのプロセスを終了する必要がある場合があります。

2️⃣ 数分待つ

MCP サーバーの設定後、新しいツールの読み込みに数分かかることがあります。 すぐに表示されない場合は、数分待ってからもう一度お試しください。

3️⃣ JSON 認証情報ファイルを確認する

サービスアカウントのJSONファイルが、アクセス可能なフォルダーにあることを確認してください。 制限付きフォルダーや管理者専用フォルダー（WindowsのC:\Program Files\やmacOSの~/Library/など）には置かないでください。 必要に応じて、ドキュメントやデスクトップなど、よりアクセスしやすい場所に移動してください。

:four: Claudeの設定を確認する

File => Settingsに移動し、Developerタブをクリックしてください。Search Console Analyticsをクリックしたときに、ステータスが「running」と表示されるはずです。表示されない場合は、接続の問題の原因を示すエラーメッセージが表示されている可能性があります。以下の画像のようにSettingsが表示されない場合は、Claude Desktopが最新バージョンであることを確認してください：🔗 Claude Desktopをダウンロード。

Edit Configをクリックし、テキストエディターで**'claude_desktop_config.json'**を開いてください。次の内容が含まれているはずです。

{
  "mcpServers": {
    "Search Console Analytics": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth",
        "--with",
        "mcp[cli]",
        "--with",
        "pandas",
        "mcp",
        "run",
        "C:\\Documents\\gsc-mcp-server\\server.py"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "C:\\Users\\Path\\To\\Credentials\\gscaccess-credentials.json"
      }
    }
  }
}

内容が異なる場合は、このデータをファイルに貼り付け、server.pyファイルと認証情報ファイルのファイルパスを更新してください。表示されているとおり、バックスラッシュ文字をエスケープしてください。Claudeを再起動してください。

Macユーザー：「spawn uv ENOENT」エラーの修正

Claude Desktopを開いたときに**「spawn uv ENOENT」**というエラーが表示される場合、uvがインストールされていないか、システムパスに見つからないことを意味します。uvがインストールされている場合は、Claudeの設定にフルパスを追加してみてください。

1️⃣ Claude Desktop の設定を更新する

Claude Desktop を開き、File > Settings > Developer に移動します。 「Search Console Analytics」 をクリックし、Edit Config を選択します。 claude_desktop_config.json の "command": "uv" エントリを見つけます。 "uv" を uv のフルパスに置き換えます。通常は次のとおりです：/Users/YOURUSERPROFILENAME/.local/bin/uv

次のコマンドを実行して、uv のインストールパスを確認します：

which -a uv

このコマンドを実行すると、uv のインストール先のパスがすべて表示されます。確認できるパスが /Library/Frameworks/Python.framework/Versions/3.**/bin/uv だけの場合は、🔗 uv をダウンロード して、パート 3 に戻る必要があります。

ファイルを保存し、Claude Desktop を再起動します。

2️⃣ uv の別のインストール方法を試す

上記の方法でうまくいかない場合、uv が正しくインストールされていない可能性があります。Homebrew を使ってインストールしてみてください：

brew install uv

それでも問題が解決しない場合は、手順を最初から確認し、すべてが正しく設定されていることを確かめてください。🚀