Tag Pilot Search Console

Tag Pilot Search Console MCP

Google Search Console 向けの無料の読み取り専用Model Context Protocol サーバーです。Claude、Cursor、その他の MCP クライアントに、オーガニック検索について質問できます。クエリやページごとのクリック数、表示回数、CTR、掲載順位、2 つの期間での変化、SEO の機会、URL の Google インデックス登録状況、サイトマップなどを確認できます。

Google Cloud の設定も、コピーする API キーも不要です。 GCP プロジェクト、OAuth クライアント、サービスアカウント、gcloud は必要ありません。サーバーを追加して質問し、ブラウザーで一度承認するだけです。

claude mcp add search-console -- npx -y @tagpilot/search-console-mcp

はじめに

1. AI クライアントにインストールします（以下を参照）。設定は不要です。
2. 「今月、クリック数が最も減ったクエリは？」 などと質問します。初回はブラウザーウィンドウが開くか、AI にリンクと ABCD-1234 のようなコードが表示されます。
   • 無料の Tag Pilot アカウントにサインインするか、新規作成します。
   • コードが一致することを確認し、このコンピューターを承認します。
   • Search Console プロパティを閲覧できる Google アカウントでサインインし、Search Console への読み取り専用アクセスを許可します。
3. もう一度質問します。接続されると、コンピューターが Search Console MCP ページの接続済みデバイスに表示されます。

すでに Tag Pilot GA4 MCP をお使いですか？こちらは独自の接続（および Google の同意）を使用する別のサーバーなので、どちらか一方でも両方でもインストールできます。

インストール

クライアント	方法
Claude Desktop	拡張機能をダウンロードして開きます（Node.js は不要です）
Claude Code	claude mcp add search-console -- npx -y @tagpilot/search-console-mcp
Cursor	Cursor に追加、または以下の mcp.json を使用します
VS Code	VS Code にインストール
Windsurf、Zed、…	コマンド npx、引数 ["-y", "@tagpilot/search-console-mcp"]（stdio）
Gemini CLI	リポジトリをクローンしてから、gemini extensions install ./ga4-mcp/packages/search-console-mcp を実行します

Claude Desktop 拡張機能以外はすべて npx で npm パッケージを実行するため、Node.js 18 以降が必要です。MCP Registry では io.github.tagpilot/search-console-mcp として登録されています。

Claude Desktop の設定ファイル（claude_desktop_config.json）、Cursor（~/.cursor/mcp.json）、および同様のクライアントの場合：

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["-y", "@tagpilot/search-console-mcp"]
    }
  }
}

ヘッドレス環境および CI： ブラウザーで承認できる人がいない場合は、Search Console MCP ページで gsc:mcp キーを作成し、サーバーの環境に TAGPILOT_API_KEY=tpk_… を設定します。これによりデバイス接続の手順は省略され、Google のサインインリンクのみが表示されます。

接続の仕組みと Tag Pilot から見える情報

GA4 MCP と同じフローです（gh auth login のような RFC 8628 形式のデバイス接続）。お使いのデバイスを問わず、どのブラウザーからでも利用でき、SSH、コンテナー、WSL 経由でも動作します。お使いのマシン上でリッスンするものはありません。

• Search Console のデータは、お使いのマシンから Google に直接送信されます （www.googleapis.com/webmasters/v3、searchconsole.googleapis.com）。Tag Pilot を経由することはありません。
• Tag Pilot はトークン交換を仲介するだけです。 Tag Pilot の Google OAuth クライアント認証情報を Google のトークンエンドポイントに追加し、Google からの応答を返します。Google のトークンは保存せず、ログにも記録しません。一度限りのサインインコードは最長 10 分間保持されます。このコードは、お使いのマシン上に留まる PKCE 検証子がなければ使用できません。
• 読み取り専用です。 リクエストする Google スコープは webmasters.readonly のみです。Search Console に変更を加えるツールはありません（サイトマップの送信や削除などはできません）。
• 認証情報はお使いのマシンに保存されます（~/.config/tagpilot/search-console-mcp/device.json）。このファイルを読み取れるのはお使いのユーザーのみです。
• 接続を解除するには： Search Console MCP ページでデバイスを取り消し、npx -y @tagpilot/search-console-mcp logout を実行してから、myaccount.google.com/permissions でアプリのアクセス権を削除します。

ツール

すべてのツールは読み取り専用です。site_url は、list_sites に表示されるプロパティそのものです。ドメインプロパティの場合は sc-domain:example.com、URL プレフィックスの場合は末尾にスラッシュを付けた URL（https://www.example.com/）です。

ツール	機能
list_sites	権限レベルとともに、読み取り可能なプロパティ（ドメインおよび URL プレフィックス）を表示します。まずはこちらから始めてください。
search_analytics	date、hour、query、page、country、device、searchAppearance 別のクリック数、表示回数、CTR、掲載順位を表示します。フィルター、検索タイプ（ウェブ、画像、動画、ニュース、Discover、Google ニュース）、データの状態、集計、ページングに対応しています（1 回の呼び出しにつき最大 25,000 行）。
compare_periods	クエリまたはページごとに期間を比較します。両期間のデータ、差分、新規・消失した行、プロパティの合計を表示します。デフォルトでは直近 28 日間と、その前の 28 日間を比較します。
find_opportunities	Tag Pilot による分析です。 low_ctr：表示回数が多い一方、掲載順位に対する一般的な CTR の半分未満である 1 ページ目の行です。striking_distance：平均掲載順位が約 5～20 位で、表示回数が十分にある行です。
inspect_url	URL 検査：1 つの URL について、Google にインデックス登録されたバージョンを表示します（判定、カバレッジ、最終クロール日時、robots.txt、Google が選択した正規 URL と申告された正規 URL、サイトマップ、リッチリザルト）。
list_sitemaps / get_sitemap	送信済みサイトマップを表示します。種類、最終送信日時／ダウンロード日時、エラー、警告、送信済み URL 数を確認できます。
connect	このコンピューターを接続します。ブラウザーで承認するためのリンクとコードを返します（お使いの AI がそれらを表示します。MCP の URL エリシテーションに対応するクライアントは、リンクを開くよう提案します）。明示的に開始するには、"Search Console に接続して" と伝えてください。
connection_status	接続済み（デバイス名を表示）、承認待ち（リンクとコードを再表示）、未接続、またはエラー内容を表示します。サインインを開始している場合は、完了まで最大 25 秒待ちます。

Search Console データについて知っておくべきこと

• 遅延： データは通常、2～3日後に利用可能になります。デフォルトの日付範囲は、3日前までの28日間です。data_state: "all" を指定すると、より新しい、まだ変動中のデータも含まれます。結果には、どの日付のデータが不完全かが示されます。
• 日付は太平洋時間です（Search Console の日付の区切りに基づきます）。相対日付（"yesterday"、"7daysAgo"）も太平洋時間で計算されます。
• 匿名化されたクエリ： プライバシー保護のため表示されないほど検索頻度が低いクエリは、クエリでグループ化またはフィルタリングした行から除外されます。そのため、クエリごとの行を合計しても、日付、国、デバイス別の合計より少なくなります。このため、compare_periods ではプロパティ全体の合計が個別に報告されます。
• 行数の上限： 1回の呼び出しで返される行数は最大25,000行です（ページを切り替えるには start_row を使用してください）。また、Google が公開するのは、検索タイプごとに1日あたり最大50,000行で、クリック数順に並べられます。
• 集計： ページでグループ化またはフィルタリングすると、各 URL が個別にカウントされるため（byPage）、合計はプロパティ単位の合計と異なります。
• Discover と Google News は aggregation_type: "byProperty" をサポートしていません。
• 割り当て量（Google の制限）： Search Analytics では、サイトごと、およびユーザーごとに1分あたり1,200件のクエリが許可されています。また、クエリとページの両方を指定する長いリクエストほど早く消費される負荷割り当て量もあります。URL Inspection では、1日あたり2,000件の検査、プロパティごとに1分あたり600件が許可されています。そのため、inspect_url は重要な URL を数件確認する用途であり、サイトマップ全体を調べる用途ではありません。

find_opportunities は、概算のベンチマーク CTR 曲線（掲載順位1位 ≈ 28％、3位 ≈ 10％、10位 ≈ 2％）を使用して行を順位付けします。これは優先順位を決めるための目安であり、Google のデータでも予測でもありません。

トラブルシューティング

「まだ接続されていません」（リンクと ABCD-1234 のようなコードが表示される）：AI にリンクとコードが表示されます。任意のブラウザーでリンクを開き（このマシンでなくてもかまいません）、Tag Pilot にサインインして、コードが一致していることを確認し、承認して Search Console へのアクセスを許可してください。その後、完了したことを AI に伝えると、AI が質問を再試行します（または connection_status を呼び出します）。サーバーはバックグラウンドで確認を続けるため、再起動は不要です。コードの有効期限は10分です。期限が切れたら、もう一度依頼する（または「Search Console に接続して」と伝える）と、新しいコードが発行されます。代わりにターミナルから接続する場合（SSH 経由など）は、npx -y @tagpilot/search-console-mcp login を実行してください。リンク、枠で囲まれたコード、カウントダウンが表示され、承認されるまで待機します。

「サインイン中の Google アカウントは Search Console プロパティ … にアクセスできません」：list_sites を使用し、site_url に一覧に表示された値をそのまま渡してください（ドメインプロパティには sc-domain:、URL プレフィックスには末尾のスラッシュを使用します）。別の Google アカウントを使用するには、npx -y @tagpilot/search-console-mcp logout を実行してから、再接続してください。

「このコンピューターは Tag Pilot から切断されました」：デバイスの接続が取り消されました。再接続するには、もう一度依頼してください。「Google へのサインインの有効期限が切れたか、取り消されました」：もう一度依頼し、再度承認してください。

割り当て量のエラー：数分間（Search Analytics の場合）、または翌日まで（URL Inspection の場合）待ってください。

セットアップの確認： npx -y @tagpilot/search-console-mcp status。ログは stderr に出力されます。

設定

設定は不要です。すべての変数は省略可能です。

変数
TAGPILOT_API_KEY	ヘッドレス環境や CI 環境用の gsc:mcp キーです。デバイス接続をスキップします。
TAGPILOT_API_URL	Tag Pilot API のベース URL です。デフォルトは https://api.tagpilot.io です。
SEARCH_CONSOLE_MCP_NO_BROWSER	1 を指定すると、ブラウザーを開かずにリンクのみを表示または返します。
SEARCH_CONSOLE_MCP_BROWSER	開くブラウザーです（macOS のアプリ名、または Linux/Windows のコマンド）。
SEARCH_CONSOLE_MCP_AUTH_WAIT_SECONDS	リンクを返す前に、接続を待つツール呼び出しの時間です。デフォルトは45です。
SEARCH_CONSOLE_MCP_CONFIG_DIR	認証情報のディレクトリです。デフォルトは ~/.config/tagpilot/search-console-mcp です。

コマンド：npx -y @tagpilot/search-console-mcp [serve|login|logout|status|--help|--version]。

開発

リポジトリの README を参照してください。SEARCH_CONSOLE_MCP_WEBMASTERS_API_URL と SEARCH_CONSOLE_MCP_INSPECTION_API_URL を指定すると、Google への呼び出し先がモックになります（npm run e2e で使用）。

ライセンス

Apache License 2.0。Copyright 2026 Tag Concierge sp. z o.o. このライセンスは、Tag Pilot の名称およびロゴには適用されません（NOTICE を参照）。