EdGEO

EdGEO

エビデンスに基づく SEO、GEO、Google AI Search の監査に使える、無料のローカルファースト MCP ツールキットです。

EdGEO は、互換性のある AI エージェントに、一般公開されているウェブページの調査、サイトの一部を対象としたクロール、AI の回答の分析、ユーザー自身の Google Search Console データの読み取りを行うツールを提供します。単独で利用できるオープンソースプロジェクトです。EdGEO アカウント、ホスト型の EdGEO サービス、テレメトリー、サブスクリプションは必要ありません。

API の回答は、ChatGPT、Gemini、Google AI Overviews、その他の一般向け製品でユーザーが目にするものと同じではありません。EdGEO は各観測結果のソースと条件を報告しますが、ランキングを保証するものではありません。

EdGEO でできること

• ページを監査する： HTTP ステータスとリダイレクト、タイトルと説明、canonical と robots のディレクティブ、見出し、言語、ビューポート、リンク、画像の alt テキスト、Open Graph／Twitter メタデータ、hreflang、解析可能な JSON-LD を調査します。
• 対象範囲を限定してサイトをクロールする： リクエストされた URL と同一ホストのサイトマップ URL を起点に、同一ホストの URL を最大 50 回取得します。EdGEO は URL の末尾のスラッシュを保持してリクエストし、robots.txt とクロール遅延に従い、HTML 以外のリソースを分離し、同じ最終 URL に解決されるページを重複排除します。キューに残った URL は、サイト全体の網羅率を示すものではありません。
• AI の回答を収集する： ループバック上の Ollama サーバーにクエリを送信するか、明示的な同意を得たうえで Gemini API にクエリを送信します。返される観測結果には、プロバイダー、モデル、プロンプトの種類、ロケール、タイムスタンプ、制限事項が含まれます。
• AI の回答を分析・比較する： 提供または収集した回答を分析し、ブランドの文字列一致とドメインの引用を調べます。プロンプトと記録された条件が一致する場合に限り、回答を比較します。
• Google Search Console に接続する： 読み取り専用の OAuth スコープでユーザーのアカウントを認証し、利用可能なプロパティを一覧表示して、指定した日付、ディメンション、検索タイプのデータを取得します。
• エクスポートしたデータをインポートする： Search Console の CSV／TSV をローカルで解析します。一般的な英語およびインドネシア語のヘッダーに対応するほか、構造化された行の要約もできます。

AI エージェントにインストールする

以下のクライアントを選択して、ローカル MCP サーバーをインストールします。

npx -y edgeo-mcp install --agent claude,codex,cursor,gemini

Gemini CLI 拡張機能をネイティブにインストールする場合は、次を使用します。

gemini extensions install https://github.com/edgarcia-id/edgeo

この拡張機能は、MCP プロンプトを /edgeo として登録します。オプションの Gemini API キー設定が必要なのは、EdGEO の Gemini プロバイダーを使う場合だけです。キーは Gemini CLI の機密性の高い拡張機能設定に保存されます。

Claude Code マーケットプレイスプラグインを使用する場合は、EdGEO マーケットプレイスを追加して、そのプラグインをインストールします。

claude plugin marketplace add edgarcia-id/edgeo
claude plugin install edgeo@edgeo-marketplace

このプラグインは、MCP ツールと名前空間付きの /edgeo:edgeo コマンドを提供します。以下のスタンドアロンインストーラーでは、名前空間なしの /edgeo スキルもインストールされます。

インストーラーはユーザーレベルの設定をマージし、編集前に JSON 設定ファイルをバックアップして、無関係なサーバーエントリーを保持します。Claude Code と Codex では各環境のネイティブ CLI コマンドを使用し、Cursor と Gemini CLI ではユーザーの MCP 設定を使用します。Claude Code と Codex には EdGEO スキルもインストールされます。インストール後、選択したクライアントを再起動するか、再読み込みしてください。

npx -y edgeo-mcp doctor
npx -y edgeo-mcp uninstall --agent claude,codex,cursor,gemini

MCP サーバーは edgeo という名前のプロンプトを登録します。MCP プロンプトをスラッシュコマンドとして公開するホストでは /edgeo が表示される場合があります。それ以外のホストでは、スキル選択画面、プロンプト UI、または通常のツール呼び出しを使用してください。MCP では、すべてのエージェントに共通するスラッシュコマンドの構文は定義されていません。

直接または手動でのセットアップと、対応するホストの動作については、EdGEO のインストールと配布およびエージェントのインストールに関する注意事項を参照してください。

Search Console のセットアップ

Google Search Console API は無料で利用できますが、Google のクォータが適用されます。各ユーザーは自分の Google アカウントを接続します。EdGEO が要求するのは Search Console の読み取り専用スコープのみです。接続するには、デスクトップアプリタイプの Google OAuth クライアントを作成し、その Google Cloud プロジェクトで Search Console API を有効にして、次を実行します。

npx -y edgeo-mcp search-console connect --client-id YOUR_DESKTOP_OAUTH_CLIENT_ID

ブラウザーで Google の同意画面が開き、同じコンピューター上のループバックコールバックに戻ります。リフレッシュトークンはユーザーのローカル EdGEO データディレクトリに保存されます。別のディレクトリを選択するには、EDGEO_DATA_DIR を設定します。edgeo-mcp search-console status はローカルのセットアップを確認し、edgeo-mcp search-console disconnect は保存済みの許可を取り消して削除します。

OAuth のセットアップとデータの取り扱いについては、Google Search Console の接続詳細を参照してください。

モデル接続

• Ollama： ローカル API リクエストは 127.0.0.1:11434 に送信されます。EdGEO によってモデル API の料金が追加されることはありません。ローカルハードウェアが必要です。クラウドを利用する Ollama モデルでは、プロンプトが外部に送信される場合があります。
• Gemini API： MCP プロセスの環境で GEMINI_API_KEY を設定します。プロンプトを送信する前に、ツールで consentToExternalRequest: true を指定する必要があります。一部のモデル階層には無料クォータがあります。料金、提供状況、データ利用条件は異なります。プロバイダーの利用条件と設定に問題がない場合を除き、機密データを送信しないでください。

どちらのコネクターも、コンシューマー向けアプリのテストやウェブ検索を自動で実行することはありません。返される回答に引用が含まれるとは限りません。モデル接続の詳細を参照してください。

必要条件とローカル開発

• Node.js 20.18.1 以降
• エージェントで使用する場合は、ローカル stdio MCP をサポートするエージェント

npm ci
npm test
npm run typecheck
npm start

npm start はローカルの stdio MCP サーバーを起動します。サーバーは診断メッセージを stderr に書き込み、stdout は MCP メッセージ用に確保します。npm test は TypeScript をビルドし、CSV 解析、可視性分析、API リクエストの整形、OAuth トークンの更新、インストーラー設定のマージ、SSRF の拒否、MCP の初期化とツールの検出をテストします。

手法の制約

• ページ監査では、サーバーから返される HTML とヘッダーを調べます。JavaScript のレンダリング、Core Web Vitals の測定、インデックス登録の確認、検索順位の観測は行いません。
• クロールは完全一致するホスト名に限定され、該当する robots.txt のルールに従います。robots.txt を読み取れない場合は停止します。
• Search Console が報告するのは、Google が返すフィールドと表示ラベルのみです。EdGEO は通常のウェブ検索の行から AI Overviews、AI Mode、SGE を推測しません。
• ブランドの照合は文字列の完全一致で行われるため、人によるエンティティ確認が必要になる場合があります。言及は肯定的な評価や推奨を意味するものではなく、引用があっても近くの主張を裏付ける証拠にはなりません。
• 比較結果は記述的なものであり、因果関係を示すものではありません。差異は、サンプリング、モデルの更新、検索、アカウントの状態、記録されていない条件などに起因する場合があります。
• Search Console のエクスポートと API 応答では、匿名化されたクエリが省略されたり、データが途中で切り詰められたりする場合があります。クリック、引用、インプレッションは、収益でも GEO の効果を示す証拠でもありません。

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

ページリクエストとクロールリクエストは、ユーザーが選択した公開サイトに直接送信されます。EdGEO はローカル IP やプライベート IP を対象とするリクエストをブロックし、検証済みの DNS アドレスに固定します。提供されたデータと API の結果はローカルで処理され、接続されたエージェントに返されます。エージェントのホストは、独自のポリシーに従って会話やツールのデータを保持する場合があります。Gemini にプロンプトが送信されるのは、明示的なツールの同意フラグが設定された後に限られます。プライバシーとデータの取り扱いおよびセキュリティポリシーを参照してください。

ライセンス

Apache-2.0。ライセンスと同梱の帰属表示に従うことを条件に、商用利用と再配布が許可されています。LICENSE と NOTICE を参照してください。

プロジェクトの状況

edgeo-mcp パッケージと EdGEO サーバーのメタデータは npm と Official MCP Registry に公開されています。バージョン 0.1.2 では、クロール URL の処理、リダイレクトの分類、サイトマップリンクの観測、見出しの手がかりが改善されました。バージョン 0.1.1 では、Gemini CLI 拡張機能のネイティブサポートが追加されました。Gemini ギャラリーは、毎日のクローラーを通じて条件を満たすタグ付きリポジトリを検出します。