mcpField
G
geo

geo

github.com/hainrixzマーケティング・グロース80213 回インストール6 日前に更新
リポジトリ

geo について

geoは、SEO監査のうちAI検索に関する部分を扱う読み取り専用のClaude Codeスキルです。引用可能性、クローラーアクセス、ディスカバリーファイル、レンダリング、スキーマを調査し、任意の検索露出・Search Consoleプローブはスコアと分けて報告します。

主な機能

  1. 01AI検索に焦点を当てたSEO監査
  2. 02GEOおよびAEO関連項目の確認
  3. 03レンダリングとスキーマのチェック
  4. 04任意のウェブ検索露出プローブ
  5. 05Search Consoleの生成AIエクスポートをインポート

活用シーン

  1. 01サイトのAI検索対応状況を評価
  2. 02GEOおよびAEO監査アクションの優先順位付け
  3. 03クローラーアクセスとディスカバリーファイルの確認
  4. 04任意の検索露出またはインプレッションプローブの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hainrixz/claude-seo-ai --skill geo

インストール後、Claude Code で/geoを入力して読み込まれたか確認します。

詳細

/claude-seo-ai:geo

監査のうち、AI 検索(GEO/AEO)に関するサブセットです。読み取り専用です。

$ARGUMENTS = <url|path> [flags]。--pages N、--render static|auto|js(デフォルトは static)、および --feed <path>(Agentic Commerce Protocol の商品フィード。これは e コマースの垂直分野が有効な場合にのみ機能し、指定しない場合は M18.agentic.acp_feed_errors は needs_api のままです。読み取られていないフィードは、決してクリーンなフィードではありません)はオーケストレーターに転送され、変更されずに audit.mjs に渡されます。--probe と --gsc-ai-export はここで処理され、audit.mjs では処理されません。これらはプローブであり、報告されますが、スコアには反映されません(重大度 0、AI Visibility スコアおよびすべての上限計算から除外)。

実行内容

  1. ターゲットとフラグを指定して seo-orchestrator を呼び出し、「AI path only」という指示を渡します。オーケストレーターはスクリプトでスナップショットを取得し(WebFetch は決して使用しません)、決定論的なチェックを実行してから、ai-search-geo-specialist に M6(seo-entity-linking)、M11(seo-geo-answerblocks)、M12(seo-geo-factdensity)、M14(seo-ai-crawlers — アクセスと Google AI 機能の適格性)、M21(seo-ai-discovery — llms.txt、agents.md、UCP、エージェント用サイトマップ)、M22(seo-agent-readiness)を割り当てます。さらに、AI 可視性に影響する M5(seo-schema-jsonld、schema-generator 経由)と M4(seo-rendering、technical-auditor 経由)も割り当てます。
  2. フラグが指定されている場合に限り、以下のプローブフローを実行します。
  3. report.json から、AI Visibility スコア(評価帯と解釈)、カテゴリ別の引用可能性の内訳、needs_api / manual_review の件数、優先順位付きの GEO/AEO 対応策、probes セクション(スコアとは明確に分ける)、および report.md のパスを提示します。
  4. Google が公式に説明している点を最初に伝えます。AI Overviews / AI Mode にページが表示されるには、Search でインデックス登録され、スニペットの対象となることが必要です(M14 ai_eligibility)。M21 — llms.txt およびその他のディスカバリーファイルは、重み 0 で報告されることをユーザーに伝えます(Google Search は llms.txt を無視し、ベンダーのサポートも一部に限られます)。ファイルは書き込まず、安全な AUTO 修正(例:AI クローラー向け robots.txt プリセット)については /claude-seo-ai:fix を案内します。

--probe "<question>" — ウェブ検索での表示状況(繰り返し指定可能)

「この質問をしたとき、このサイトは表示されるか」を、一時点の単一検索エンジンから推定する大まかな指標です。引用データではありません。

  1. 各 --probe の質問について、その質問文をそのまま使って WebSearch を呼び出します。質問を書き換えたり、ブランド名を追加したり、ユーザーが求めていない追加クエリを実行したりしてはいけません。
  2. オーガニック検索結果を順に確認し、JSON オブジェクトを 1 つ作成します。rank は検索結果リスト内の 1 始まりの位置、url と title はそのまま転記し、host は監査対象サイトのホスト名とします。
    { "host": "example.com",
      "queries": [ { "query": "best sustainable running shoes",
                     "results": [ { "rank": 1, "url": "https://…", "title": "…" } ] } ] }
    
  3. それを標準入力経由でレポーターに渡します(ユーザーのプロジェクトには何も書き込まれません)。--out を指定すると、実行ディレクトリ内にプローブが保存されます。この場所から report.mjs が probes.web_search として取り込みます。
    node "${CLAUDE_PLUGIN_ROOT}/scripts/probe-report.mjs" --host <host> \
      --out "<run_dir>/probes/web-search.json" [--history <dir>] <<'JSON'
    { "host": "…", "queries": [ … ] }
    JSON
    
    --results <file.json> を指定すると、標準入力の代わりにファイルから同じ JSON を読み込みます。
  4. 返される値は、表示率(ホストが結果に含まれるクエリの割合)、最上位の順位、競合ホストの集計、およびそのホストについて以前に保存されたプローブ実行結果との傾向です。これを probes.web_search として報告し、disclaimer フィールドを一字一句そのまま引用します。スクリプトが出力する文字列(scripts/probe-report.mjs の DISCLAIMER。report.json と report.md にも書き込まれます)をそのまま出力し、言い換えてはいけません。そうすることで、モデルが生成する文章と、その横に表示される機械生成の文言が食い違うことを防げます。現在の文言は次のとおりです。「これらの質問に対するウェブ検索での表示状況です。これは AI Overview、AI Mode、ChatGPT、Perplexity の引用データではありません — それを公開しているベンダーはありません。インデックス登録/取得可能性は Google AI 機能の前提条件として公式に説明されています。この結果への表示は必要条件ですが、十分条件ではありません。」
  5. この所見は M14.probe.web_presence で、重大度 0、手法は web_search_probe です。プローブによって AI Visibility スコアを変えてはいけません。また、順位をランキングの測定値として説明してはいけません。WebSearch の結果は、ユーザーごとに異なり、地域によって変化し、変動しやすいためです。

--gsc-ai-export <csv> — Search Console の生成 AI インポート

  1. ユーザーは Search Console の生成 AIパフォーマンス レポートを手動でエクスポートします。API はありません。ファイルを渡してください:
    node "${CLAUDE_PLUGIN_ROOT}/scripts/gsc-ai-import.mjs" --csv <file.csv> [--host <host>] [--history <dir>] \
      > "<run_dir>/probes/gsc-generative-ai.json"
    
    スクリプトはインポート内容を出力するだけで、ファイル自体は書き込みません。そのため、実行時の probes/ ディレクトリにリダイレクトしてください。これにより、report.mjs はデータ階層 2 の probes.gsc_generative_ai としてレポートします。
  2. 英語とスペイン語の列見出しの両方が認識されます。レポートに含まれるのはインプレッションのみです。クリック、引用、回答ごとの帰属情報はありません。そのため、インポートで報告されるのはインプレッションのみです。
  3. probes.gsc_generative_ai として報告してください。検出結果はすべて重大度 0です。M14.gsc_ai.impressions_present(エクスポートにこのプロパティの生成 AI インプレッションが含まれている)、M14.gsc_ai.zero_impressions(エクスポートの解析には成功したものの、インプレッションが含まれていない)、M14.gsc_ai.unavailable(needs_api — エクスポートが提供されていない、またはファイルを解析できなかった場合。デフォルトの状態)。
  4. この数値が何を示していないかを明確に伝えてください。Google の生成 AI サーフェスにおけるインプレッションは、引用でもクリックでもなく、スコアの入力値でもありません。

どちらのプローブセクションもスコアの横に表示し、スコアには含めません。ユーザーが「AI での可視性は上がりましたか?」と尋ねた場合、これらは代理指標であり、スコアは構造的な評価であると正直に回答してください。まさにその理由から、両者は別々に報告されます。ユーザーの言語(EN/ES)で回答してください。

コメント