GSC-MCP

Google Search Console のデータを Claude、ChatGPT、Cursor で利用可能にするリモート MCP サーバー。Google の完全データエクスポート（制限のある API ではなく）をベースにしています。

ドメイン: gsc2mcp.drossmedia.de · 運用: netcup Root Server、ニュルンベルク、Cloudflare を前面に配置

ステータス: 実装開始。ネットワーク非依存のコアロジックはテスト済みパッケージ（core、analytics、db、gsc-client）として、MCP サーバー（apps/app）と同期ワーカー（apps/worker）の骨格とともに完成しています。ネットワーク側の配線（MCP トランスポート、OAuth プロバイダー、Google 連携）は、ロードマップのフェーズ 0/1 で、ドメインと GCP OAuth クライアントが整い次第行われます。

概要

Search Console API は厳しく制限されています。履歴は 16 ヶ月、1 リクエストあたり 25,000 行、1 日あたりの検索タイプごとに約 50,000 行です。市場にあるすべてのツールは例外なくこの API を使用しています（後でデータを保存するツールも含めて）。つまり、それらはサンプルを保存しているにすぎません。

Google の Bulk Data Export にはこれらの制限がありません。完全な検索データ、毎日、API クォータなし、無制限に保存可能。欠けているのは、それ以外のすべて（インターフェース、分析、エージェントアクセス）です。

GSC-MCP はまさにこのギャップを埋め、決定論的な分析エンジンを追加します。変更原因分析、季節調整済み異常検知、サイト固有の CTR 曲線、カニバリゼーションの時系列。数値は推定ではなく、検証可能です。

その違いの大きさは測定されています。sc-domain:aip.aero では、クリック数上位 100 のクエリが全クリックの 8.3% を占めており、行数制限のあるツールが表示できる範囲外に約 92% のアクティビティがあります。

Related MCP server: searchconsole-mcp

ドキュメント

アーキテクチャの概要

Claude / ChatGPT / Cursor
        │  Streamable HTTP + OAuth 2.1
        ▼
   Cloudflare (TLS, DDoS, WAF, Rate Limiting)
        │
        ▼
   netcup Root Server · Nürnberg
     Caddy → app (MCP + OAuth AS) · web · worker
     PostgreSQL 17 (Warehouse, pg-boss, Rate-Budget)
        │
        ├──▶ Search Console API      (einmaliger 16-Monats-Backfill)
        └──▶ BigQuery Bulk Export    (laufend, vollständig, ohne API-Quote)

2 番目のホスト名 gsc2mcp-direct.drossmedia.de は Cloudflare 経由せずにサーバーに直接アクセスします。これは、調達において米国のデータ処理業者を許可しない顧客向け、およびプロキシ障害時の代替経路として機能します。

プロジェクト構造

モノレポ、npm ワークスペース、TypeScript strict、Vitest。

正規 DDL は packages/db/migrations/0001_init.sql にあり、実際の PostgreSQL に対して検証されます。詳細は docs/03 で説明されています。

開発

npm install
npm run typecheck   # tsc --build über alle Packages
npm test            # Vitest über packages/*/test und apps/*/test

CI（GitHub Actions）ではさらに、実際の PostgreSQL に対するマイグレーション、コンセプトドキュメント（リンク、一貫性）、および両方のテーマでの概要ページがチェックされます。詳細は docs/10-repo-struktur.md と CLAUDE.md を参照してください。

次のステップ

重要なパスはコードではなく、機密スコープ webmasters.readonly に対する Google OAuth 検証です。通常、数週間かかり、ドメインとプライバシーポリシーが必要です。詳細は docs/02-auth.md と docs/09-roadmap.md を参照してください。

フェーズ 2 の前には、一括データエクスポートの配信先（顧客の BigQuery プロジェクトか自社のプロジェクトか）を決定する必要もあります。その評価は docs/12-wettbewerb-usp.md に記載されています。