Wingate SEO MCP

オープンソースのセルフホスト型 Google Search Console + Google Analytics 4 MCP サーバーで、ChatGPT やその他の MCP クライアントに対応しています。別の SEO ダッシュボードに費用を支払うことなく、ご自身の SEO データを分析できます。

Wingate SEO MCP は、MCP クライアントを、あなたがすでに管理している Google プロパティに接続します。Search Console のパフォーマンス、GA4 のエンゲージメント、サイトマップと URL 検査のエビデンス、期間比較、および決定論的な SEO 診断を、1 つの読み取り専用サービスにまとめています。

発行者: Wingnut Innovations
バージョン: 0.5.0
ライセンス: MIT

なぜ使うのか?

• 自分の GSC と GA4 データについて自然言語で質問できます。

• 認証情報とプロパティマッピングを、自分が管理するインフラ上に保持できます。

• 定期的なダッシュボード作業を、再現可能なエビデンスと計算に置き換えることができます。

• イベントアクティビティ、ランディングページのエンゲージメント、CTR の機会、ランキングの変動、減衰、カニバリゼーションを調査できます。

• 意図的に小さな読み取り専用のセキュリティ境界から始められます。

ご自身で Google 認証情報を用意し、その ID に、分析したいプロパティへのアクセス権のみを付与します。Wingate SEO MCP には、ホスト型アカウント、バンドルされた Google アクセス、有料ゲート、テレメトリ、広告、またはサブスクリプションは含まれません。

読み取り専用 MCP ツール

公開サーバーは正確に 11 個のツールを公開します:

公開候補版には、Search Console、Google Indexing、GA4 Admin、サイトマップ送信、その他の書き込みツールはありません。

要件

• Node.js 20、22、または 24

• npm

• 必要な API が有効化された Google Cloud プロジェクト

• ユーザーが用意する、GSC と GA4 プロパティへのアクセス権を持つ Google サービスアカウントの JSON 認証情報

• ローカルの Streamable HTTP エンドポイントに到達できる MCP クライアント

クイックスタート

git clone https://github.com/wingnutinnovations-tech/wingate-seo-mcp.git
cd wingate-seo-mcp
npm install

.env.example をテンプレートとして使用し、コマンドを起動するシェルに同じ環境変数を設定してください。このプロジェクトは .env を自動的に読み込みません。ダウンロードしたサービスアカウントの JSON はリポジトリの外に保管してください。

GOOGLE_SERVICE_ACCOUNT_FILE=/absolute/path/to/google-service-account.json
WINGATE_SITES_FILE=./config/sites.local.json

npm start で起動される v0.5.0 MCP ランタイムには、明示的なサービスアカウント認証情報が必要です。GOOGLE_SERVICE_ACCOUNT_FILE (推奨)、GOOGLE_APPLICATION_CREDENTIALS、または GOOGLE_SERVICE_ACCOUNT_JSON を設定してください。アタッチされた Google Cloud メタデータ / ワークロード ID へのフォールバックは行われません。

認証情報を検証し、アクセス可能なプロパティを検出します:

npm run doctor
npm run discover:google

検出によって返されたプロパティを使用して、Git で無視されるローカルサイトレジストリを生成します:

npm run setup -- --output config/sites.local.json \
  --gsc sc-domain:example.com \
  --ga4 123456789 \
  --origin https://example.com \
  --key example-site \
  --name "Example Site"

制限付きのライブ読み取りを実行してから、サーバーを起動します:

npm run live:smoke -- --site example-site --inspect-origin
npm start

デフォルトのエンドポイントは次のとおりです:

http://127.0.0.1:3000/healthz
http://127.0.0.1:3000/mcp

詳細な手順については、Google セットアップ と ライブオンボーディング を参照してください。

Google API のセットアップ

Google Cloud プロジェクトで次の API を有効にします:

• Google Search Console API

• Search Console URL Inspection API

• Google Analytics Data API

• Google Analytics Admin API

各 Search Console プロパティへのアクセス権をサービスアカウントのメールアドレスに付与し、各 GA4 プロパティには少なくとも Viewer アクセス権を付与してください。ランタイムが要求するのは次のみです:

• https://www.googleapis.com/auth/webmasters.readonly

• https://www.googleapis.com/auth/analytics.readonly

Analytics Admin API は、アクセス可能な GA4 プロパティとウェブストリームを検出するためだけに使用されます。MCP サーバーは GA4 Admin 設定を変更しません。

サイトマッピング

ローカルレジストリの各エントリは、安定した siteKey を 1 つの Search Console プロパティ、オプションの GA4 プロパティ、およびサイトのオリジンにマッピングします。形式については config/sites.example.json をコピーするか、npm run setup で config/sites.local.json を生成および検証してください。

ローカルレジストリは Git によって無視されます。リポジトリの閲覧者に、あなたがどのサイトを運営しているかを知られたくない場合は、実際のプロパティマッピングを決してコミットしないでください。

MCP クライアントを接続する

サーバーを起動し、Streamable HTTP 対応の MCP クライアントをローカルの /mcp エンドポイントに向けます。クライアントがサポートするローカル接続、または独立にレビューされたトランスポート境界を使用してください。このリポジトリには、インターネットトンネルや認証レイヤーは同梱されていません。

データを送信する前に、ツールディスカバリを調べ、ツールが正確に 11 個あり、すべてのツールが読み取り専用とマークされていることを確認してください。MCP クライアント接続 を参照してください。

質問例

• 「今月クリックを失ったページはどれですか?」

• 「CTR が低い 4〜20 位のクエリを見つけてください。」

• 「エンゲージメントが最も高いオーガニックのランディングページはどれですか?」

• 「リードイベントは発火しましたか?」

• 「過去 28 日間を、その前の 28 日間と比較してください。」

プライバシーとセキュリティ

Wingate SEO MCP には、非開示のテレメトリはありません。使用状況分析を Wingnut Innovations や第三者に送信することはありません。

データがマシンまたはサーバーから送信されるのは、次の場合のみです:

• コネクタが、設定した認証情報とプロパティアクセスを使用して Google API を呼び出す場合。または

• 設定した MCP クライアントがこのサーバーにリクエストを送信し、結果を受け取る場合。

サーバーはデフォルトで 127.0.0.1 にバインドします。独立にレビューされた認証およびトランスポート境界を追加せずに、公開インターネットに直接公開しないでください。認証情報、ローカルレジストリ、またはコマンド出力をプロンプトやソース管理に置かないでください。SECURITY.md を参照してください。

トラブルシューティング

• 認証情報ファイルを読み取れない: 絶対パスを使用し、JSON をリポジトリの外に保管してください。

• Google から 403: 関連する API を有効にし、サービスアカウントのメールアドレスにプロパティへのアクセス権を付与してください。

• GA4 プロパティが見つからない: 少なくとも Viewer アクセス権を付与してから、npm run doctor を再実行してください。

• マッピングがあいまい: --ga4 を明示的に指定してください。検出プロセスが弱い一致を黙って選択することはありません。

• イベント行がない: GA4 がその日付 / フィルター範囲で一致する行を観測しなかったことを意味します。データがないことだけでは、計装の問題を診断できません。

• MCP クライアントが接続できない: npm start、/healthz、ループバックバインド、およびクライアントのローカルネットワークまたは個別に保護されたトランスポート設定を確認してください。

開発と検証

npm run ci

これにより、構文チェック、TypeScript チェック、ユニット / 統合テスト、本番ビルド、および MCP ディスカバリが実行されます。CI は Node.js 20、22、24 を対象としています。

Docker パッケージングは、小さくレビュー可能なイメージと非 root ランタイムポリシーが準備できるまで、意図的に延期されています。Node/npm によるセルフホスティングのパスが v0.5.0 のベースラインです。

ロードマップとサポート

ロードマップ を参照してください。Wingate SEO MCP は無料のオープンソースです。時間や SEO ツールのサブスクリプション費用を節約できた場合は、任意で継続的な開発をサポートできます。v0.5.0 では、資金提供プロバイダーは設定されていません。

ライセンス、由来、および独立性

Wingate SEO MCP は MIT ライセンス の下でライセンスされています。選択された Google クライアントとメソッドのマッピングは、UPSTREAM.md、UPSTREAM_IMPORT_MANIFEST.json、および THIRD_PARTY_NOTICES.md に記載されている、バージョン固定された MIT ライセンスのアップストリームから翻案され、大幅に書き直されました。

Wingate SEO MCP は、Wingnut Innovations が公開する独立したプロジェクトです。Google や OpenAI とは提携、承認、またはスポンサー関係にありません。Google Search Console、Google Analytics、GA4、ChatGPT、および OpenAI は、それぞれの所有者の商標です。