Search Console Mcp

• 💰 Google AdSense との連携：setup --engine=adsense を通じて、収益レポート、支払い、アカウントアラートを利用できます。AdSense を有効にするには、別途 adsense.readonly OAuth スコープの承認が必要です。有効にするまで、既存の GSC、Bing、GA4 の設定は変更されません。
• 🔐 AdSense 認証は OAuth のみ：AdSense Management API がサポートするのはユーザー OAuth のみです。セットアップ時にアクセス権を実際に検証し、サポートされていないサービスアカウント設定は、具体的な対処方法を示して拒否するようになりました。複数アカウントを利用するユーザーは、ページネーションに完全対応（100アカウント超）したうえで、パブリッシャーアカウントを明示的に選択できます。
• 📊 adsense_report の機能強化：カスタムの startDate／endDate がプリセットの dateRange より優先されるようになりました。また、収益レポートを並べ替える新しい orderBy パラメーター（-ESTIMATED_EARNINGS）が追加されました。
• 🧪 MCP のエンドツーエンドテストスイート：ビルド済みサーバーバイナリを、MCP ホストが操作するのと同じように、stdio と SSE を通じてテストするようになりました。ハンドシェイク、ツールのスキーマ、エラーエンベロープ、複数アカウントのリソース動作を対象とする11件の E2E テストが CI に組み込まれています。

• 💰 Google AdSense との連携：setup --engine=adsense を通じて、収益レポート、支払い、アカウントアラートを利用できます。AdSense を有効にするには、別途 adsense.readonly OAuth スコープの承認が必要です。有効にするまで、既存の GSC、Bing、GA4 の設定は変更されません。
• 🔐 AdSense 認証は OAuth のみ：AdSense Management API がサポートするのはユーザー OAuth のみです。セットアップ時にアクセス権を実際に検証し、サポートされていないサービスアカウント設定は、具体的な対処方法を示して拒否するようになりました。複数アカウントを利用するユーザーは、ページネーションに完全対応（100アカウント超）したうえで、パブリッシャーアカウントを明示的に選択できます。
• 📊 adsense_report の機能強化：カスタムの startDate／endDate がプリセットの dateRange より優先されるようになりました。また、収益レポートを並べ替える新しい orderBy パラメーター（-ESTIMATED_EARNINGS）が追加されました。
• 🧪 MCP のエンドツーエンドテストスイート：ビルド済みサーバーバイナリを、MCP ホストが操作するのと同じように、stdio と SSE を通じてテストするようになりました。ハンドシェイク、ツールのスキーマ、エラーエンベロープ、複数アカウントのリソース動作を対象とする11件の E2E テストが CI に組み込まれています。

これが必要な理由

サイトのデータは、4つの異なるサイロに分散しています。「広告収益が減ったのは、トラフィックの減少が原因なのか、それともRPMの低下が原因なのか？」という質問に答えるには、通常、4つのダッシュボードにログインし、4つのCSVをエクスポートして、手作業でVLOOKUPを行う必要があります。

Search Console MCPは、GSC、Bing、GA4、AdSenseを、AIエージェントが直接呼び出せる一連のツールにまとめ、データがコンテキストウィンドウに届く前に、カニバリゼーション、異常検知、収益のアトリビューション分析を行います。

⚡ クイックスタート

npx search-console-mcp setup

ブラウザーが開き、Google アカウントの認証が行われ、認証情報が安全に保存されます（セキュリティを参照）。次に、MCP クライアントの設定（Claude Desktop、Cursor、Antigravityなど）に追加します。

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["search-console-mcp"]
    }
  }
}

クライアントを再起動して、以下のプロンプトを試してください。

💬 試してみる

以下をそのままエージェントに貼り付けてください。

「先週と比べて今週のトラフィックが減りました。いつから始まったのか、どのページが原因なのかを正確に特定してください。」

「example.comで掲載順位が8～15位、表示回数が1,000回以上のキーワードを探してください。すぐに成果が見込めるものを知りたいです。」

「キーワードのカニバリゼーションを確認してください。同じクエリで競合しているページが2つありますか？」

「上位ページでseo_auditを実行してください。検索での可視性は高いのにCTRが低いページはどれですか？」

🔌 アカウントを接続する

すべてをCLIから管理できます。

npx search-console-mcp accounts list
npx search-console-mcp accounts add-site [email protected] --site=example.com
npx search-console-mcp accounts remove [email protected]

エージェントがサイトを照会すると、サーバーが所有アカウントを自動的に特定するため、手動で切り替える必要はありません。複数アカウントのドキュメント →

# 1. On your laptop (after setup --engine=adsense):
npx search-console-mcp adsense-export

# 2. On the server (prints a ready-to-run command on step 1):
npx search-console-mcp adsense-import --token='...' --publisher-id='accounts/pub-...'

🖥️ CLI からツールを実行

Search Console MCP では、登録済みの MCP ツールを CLI コマンドとして直接実行することもできます。run サブコマンドを使うと、ツールの一覧表示、ツール固有の引数の確認、結果の JSON、CSV、ASCII テーブル形式での出力ができます。

# List registered tools
npx search-console-mcp run --help

# Show options for one tool
npx search-console-mcp run analytics_query --help

# Run an SEO audit with JSON output
npx search-console-mcp run seo_audit --siteUrl=https://example.com --type=quick_wins

# Print array results as CSV or a table
npx search-console-mcp run analytics_query --siteUrl=https://example.com --startDate=2026-06-01 --endDate=2026-06-30 --dimensions=date,query --format=csv
npx search-console-mcp run sites_list --engine=all --format=table

🛠 ツール（Fluent Domain アーキテクチャ）

Search Console MCP v2.0 には、SEO、Analytics、Inspection、Indexing のすべての操作を適切に処理する 7 つの Fluent Domain ツールが用意されています。

Google AdSense ツール

注： accountId は、accounts_manage で表示される設定済みのプロフィール ID（例：adsense_2）を指し、accounts/pub-123 のようなパブリッシャーリソース名ではありません。

🔒 セキュリティ

• OS のキーチェーンを優先 — トークンは macOS キーチェーン、Windows 資格情報マネージャー、または Linux Secret Service に保存されます
• AES-256-GCM によるフォールバック — マシンのハードウェア ID から導出した鍵で暗号化されます。ファイルが盗まれても、別のデバイスでは役に立ちません
• 最小限の保存 — refresh_token と expiry_date のみを mode 600 で保存します
• サイレント更新 — トークンはバックグラウンドで自動的に更新されます

ライセンス

MIT · 貢献ガイド · 後方互換性ガイド