Google Search Console MCPサーバー

MCPプロトコルをサポートするあらゆるAIアシスタントから、Google Search Consoleのデータ（ランキング、クリック数、表示回数、ページレベルのパフォーマンス）をクエリできます。

前提条件

• Node.js 18以上

• Google Search Consoleにアクセス可能なGoogleアカウント

Related MCP server: Google Search Console + GA4 MCP Server

セットアップ

1. 依存関係のインストール

npm install

2. Google Cloudプロジェクトの作成

1. Google Cloud Console にアクセスします

2. 新しいプロジェクトを作成（または既存のプロジェクトを選択）します

3. Search Console API を有効にします：

   • 「APIとサービス」 > 「ライブラリ」に移動します

   • 「Search Console API」を検索します

   • 「有効にする」をクリックします

3. OAuth2認証情報の作成

1. 「APIとサービス」 > 「認証情報」に移動します

2. 「認証情報を作成」 > 「OAuthクライアントID」をクリックします

3. アプリケーションの種類：デスクトップアプリ（またはウェブアプリケーション）

4. 任意の名前を付けます

5. クライアントID と クライアントシークレット をコピーします

4. .env ファイルの設定

cp .env.example .env

値を入力します：

5. サーバーの実行

npm start

初回実行時に、OAuth認証を完了するためのブラウザウィンドウが自動的に開きます。その後、トークンはローカルの .tokens.json に保存され、再度プロンプトが表示されることはありません。

AIアシスタントへの接続

このサーバーは stdio（標準入出力）を介して通信します。これは、MCPサーバーをAIアシスタントに接続するための標準的な方法です。AIアシスタントを以下のように設定してください：

node /path/to/src/index.js

/path/to を、お使いのPC上のこのプロジェクトへの実際のパスに置き換えてください。

利用可能なツール

getTopQueries

クリック数順にランク付けされたトップ検索クエリを返します。

• パラメータ: startDate (YYYY-MM-DD), endDate (YYYY-MM-DD), rowLimit (オプション、デフォルト10)

• 戻り値: 各行のクエリ、クリック数、表示回数、CTR、掲載順位

getSiteSummary

サイト全体の検索パフォーマンスの合計を返します。

• パラメータ: startDate (YYYY-MM-DD), endDate (YYYY-MM-DD)

• 戻り値: 合計クリック数、表示回数、CTR、平均掲載順位

getPagePerformance

特定のページにフィルタリングされたパフォーマンスデータを返します。

• パラメータ: pageUrl (GSCに表示される正確なURL), startDate (YYYY-MM-DD), endDate (YYYY-MM-DD)

• 戻り値: そのページのクリック数、表示回数、CTR、掲載順位

getRankingChanges

2つの期間で掲載順位の変化が最も大きいページを見つけます。

• パラメータ: days (比較する日数、デフォルト28)

• 戻り値: ページURL、順位の変化、現在の順位、以前の順位

重要

.env や .tokens.json をバージョン管理にコミットしないでください。これらのファイルは .gitignore によって既に除外されています。