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.1
ライセンス: MIT

なぜ使うのか？

• 自身のGSCおよびGA4データについて、自然言語で質問できます。

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

• 繰り返し発生するダッシュボード作業を、再現可能なエビデンスと計算に置き換えます。

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

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

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

Related MCP server: Google SEO MCP

読み取り専用のMCPツール

公開サーバーが公開するツールは、正確に11個です:

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

GA4レポート品質の診断

GA4の結果には、返されたデータに関するエビデンスとしてレポート診断が含まれます。Googleはしきい値処理やサンプリングを適用する場合があり、高カーディナリティのディメンションは(other)行にグループ化されることがあります。境界付きツール応答は、さらに多くの行が利用可能な場合も報告しますが、プロパティクォータの詳細は情報提供のみです。これらの注意事項は、トラッキングが正しいまたは完全であることを証明するものではなく、Wingate SEO MCPはGoogleのレポート動作を回避することはできません。

ga4_overviewは、MCPツールを追加することなく、オプションでセッションレベルのトラフィック獲得エビデンスを追加できます:

{
  "siteKey": "example-site",
  "days": 28,
  "includeAcquisition": true,
  "acquisitionLimit": 25
}

デフォルトの概要は獲得リクエストを行わず、acquisition: nullを返します。有効にすると、acquisitionはセッションのデフォルトチャネルグループとセッションのソース/メディアで行をグループ化し、概要と同じ日付範囲とgoogleOrganicOnlyスコープを使用し、1〜100行に制限されます。そのreportDiagnosticsは、切り捨て、しきい値処理、サンプリング、クォータの注意事項を公開します。GA4の獲得帰属は、Search Consoleの帰属と同等ではありません。

要件

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

• npm

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

• GSCおよびGA4プロパティへのアクセス権を持つ、ユーザー提供のGoogleサービスアカウントJSON認証情報

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

クイックスタート

git clone https://github.com/aitradesniper-blip/wingate-seo-mcp-public.git wingate-seo-mcp
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で起動するMCPランタイムには、明示的なサービスアカウント認証情報が必要です。GOOGLE_SERVICE_ACCOUNT_FILE（推奨）、GOOGLE_APPLICATION_CREDENTIALS、またはGOOGLE_SERVICE_ACCOUNT_JSONを設定してください。接続されたGoogle Cloudメタデータ/ワークロードIDへのフォールバックはありません。

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

npm run doctor
npm run discover:google

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

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は、それぞれの所有者の商標です。