ultimate-seo-geo について
Ultimate SEO + GEO は、AGENTS.md を読み込むエージェント向けの、LLM 非依存の SEO・生成エンジン最適化スキルです。監査、優先順位付き計画、検証を伴う実行を、診断スクリプトと分野別手順で支援します。
主な機能
- 01評価付きサイト監査と指摘の作成
- 02AI 検索の可視性と引用状況の評価
- 03段階的で優先順位付きの実行計画
- 04構造化データの生成と検証
- 05SEO の各分野を扱う診断スクリプト
活用シーン
- 01サイト監査と技術修正の優先順位付け
- 02AI 引用を意識したコンテンツ構成の改善
- 03構造化データや移行用成果物の準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mykpono/ ultimate-seo-geo --skill ultimate-seo-geoインストール後、Claude Code で/ultimate-seo-geoを入力して読み込まれたか確認します。
詳細
Ultimate SEO + GEO — LLM に依存しない SEO エージェント
| 属性 | 詳細 |
|---|---|
| バージョン | 1.22.1 |
| 更新日 | 2026-10-01 |
| ライセンス | MIT |
| 作者 | Myk Pono |
| ラボ | lab.mykpono.com |
| ホームページ | lab.mykpono.com |
| プロフィール | |
| プラットフォーム | Claude Code, Cursor, Copilot, Gemini CLI, Codex, Windsurf, Cline, Aider, Devin |
決定版の SEO および生成エンジン最適化エージェントです。LLM に依存せず、AGENTS.md を読み取るあらゆるプラットフォームで動作します。Google の公式 SEO ガイダンス、2026 年の GEO 研究、実践者のベストプラクティスを、ひとつの汎用フレームワークに統合しています。すべての調査結果には、診断だけでなく、明確な修正指示が付いています。
このファイルはルーティング用のシェルです。 §1〜§26 の詳細な手順は references/procedures/ にあります。ユーザーのタスクで該当セクションが必要な場合にのみ読み込んでください(下記の §0 を参照)。ドメイン知識の表は、従来どおり references/*.md にあります。
0. 始める前に
ルーティングインデックス(必要な項目のみ参照)
| 目的 | 手順ファイル | あわせて参照/実行 |
|---|---|---|
| スコア付きの完全監査 | references/procedures/02-full-site-audit.md、references/procedures/21-script-toolbox.md | references/audit-script-matrix.md、references/thinking-framework.md、generate_report.py |
| AI による引用/GEO | references/procedures/03-geo-ai-search.md | references/ai-search-geo.md、entity_checker.py、citability_checker.py、llms_txt_checker.py、robots_checker.py |
| コンテンツの関連性+GEO(構造、E-E-A-T、内部リンク) | references/procedures/03-geo-ai-search.md、references/procedures/06-content-eeat-and-pruning.md | references/eeat-framework.md、article_seo.py、readability.py、internal_links.py、generate_report.py |
| AI が下書きしたコンテンツのレビュー(アーティファクト、生成テキストの兆候) | references/procedures/06-content-eeat-and-pruning.md | references/ai-generated-content-artifacts.md、content_quality.py、readability.py |
| スキーマのみ | references/procedures/05-schema-structured-data.md | references/schema-types.md、validate_schema.py |
| ローカル | references/procedures/12-local-seo.md | references/local-seo.md、local_signals_checker.py |
| クロール/インデックス/パフォーマンス | references/procedures/04-technical-seo.md、references/procedures/11-crawl-indexation.md | マトリックスのスクリプト(robots_checker、sitemap_checker、API が利用できる場合は pagespeed.py) |
| 移行 | references/procedures/20-site-migration.md | references/site-migration.md、redirect_checker.py |
| キーワード/ロードマップ(URL なし) | references/procedures/07-keywords-clusters-aeo.md、references/procedures/16-strategy-roadmap.md | ライブサイトの /100 スコアを作り出さないでください |
| SEO の変化/変更の追跡 | references/procedures/22-drift-monitoring.md | drift_monitor.py |
| セマンティックなトピックのクラスタリング | references/procedures/23-semantic-clustering.md | topic_cluster.py |
| コンテンツブリーフの生成 | references/procedures/07-keywords-clusters-aeo.md | content_brief.py |
| E コマース SEO | references/procedures/24-ecommerce-seo.md | ecommerce_schema.py、validate_schema.py |
| 高度なローカル SEO/マップ | references/procedures/25-maps-intelligence.md | maps_checker.py、local_signals_checker.py |
| サイト構造/コンテンツタイプの網羅性/ナビゲーション/サイトマップとクロールの照合 | references/procedures/26-site-structure-content-types.md | references/page-types.md、site_graph.py、page_type_classifier.py、navigation_checker.py、site_architecture.py、sitemap_checker.py --reconcile |
クライアント向けレポート(report.html:概要、監査、戦略、計画、付録) | references/report-template/report-template.md | render_report.py、report_data_lint.py、report.css |
| Google API 認証情報 | references/procedures/21-script-toolbox.md | google_api_tier.py、crux_history.py、gsc_query.py、gsc_insights.py、ga4_report.py |
セクション番号 §1–§26 は、AGENTS.md および references/procedures/ 内のファイル名と一致します。完全なインデックス:references/procedures/README.md。
参考資料の参照ガイド
セクションで参考ファイルが指定されている場合は、現在のタスクに必要なものだけを読んでください。
段階的開示のルール: 1 回の応答で references/ 内のファイルを最大 3 件 まで読み込んでください(references/procedures/ 内のファイルを含みます)。ただし、generate_report.py を使ってモード 1 の完全監査を実行する場合は除きます。この場合、すべての評価項目が暗黙的に対象となります。単一テーマのモード 2 またはモード 3 のタスク(例:「スキーマを修正する」「llms.txt を作成する」)では、ルーティングテーブルにより、テーマに応じた references/*.md ファイル 1~2 件と、手順の詳細が必要な場合に限り references/procedures/*.md ファイルを最大 1 件特定します。範囲の狭いタスクで references/ ツリー全体を読み込むと、コンテキストを浪費し、品質を向上させることなく応答が遅くなります。この方法は、Anthropic の Skills の段階的開示アーキテクチャに沿っています。
| タスク | 参照する資料 | 実行するツール |
|---|---|---|
| 完全監査(種類を問わず) | references/audit-script-matrix.md | generate_report.py |
| GEO / AI 引用 | references/ai-search-geo.md、references/entity-optimization.md | robots_checker.py、entity_checker.py、citability_checker.py、llms_txt_checker.py |
| スキーママークアップ | references/schema-types.md | validate_schema.py |
| 技術面 / CWV | references/technical-checklist.md | pagespeed.py、robots_checker.py、security_headers.py |
| コンテンツ / E-E-A-T | references/eeat-framework.md、references/core-eeat-framework.md | readability.py、article_seo.py |
| AI 作成コンテンツの成果物 | references/ai-generated-content-artifacts.md | content_quality.py、readability.py |
| CITE ドメイン監査 | references/cite-domain-rating.md | link_profile.py |
| キーワード / クラスター | references/keyword-strategy.md | — |
| リンク | references/link-building.md | internal_links.py、broken_links.py、link_profile.py |
| ローカル SEO | references/local-seo.md | local_signals_checker.py |
| 画像 | references/image-seo.md | image_checker.py |
| 国際対応 / hreflang | references/international-seo.md | hreflang_checker.py |
| プログラマティック SEO | references/programmatic-seo.md | programmatic_seo_auditor.py |
| 移行 | references/site-migration.md | redirect_checker.py |
| アナリティクス / 誤解 | references/analytics-reporting.md | — |
| クロール / インデックス登録 | references/crawl-indexation.md | sitemap_checker.py、index_coverage_diff.py、duplicate_content.py、canonical_checker.py、broken_links.py、internal_links.py |
| サイト構造 / ページ種別 / ナビゲーション | references/page-types.md、references/industry-templates.md | site_graph.py、page_type_classifier.py、navigation_checker.py、site_architecture.py |
モード 1(完全監査)を実行しないケース
| ユーザーの意図 | 対応 |
|---|---|
| 主な依頼が Google Ads / PPC | 有料メディアの範囲です。オーガニック SEO も依頼されていない限り、オーガニック SEO のヘルススコアやクロール上の問題を大量に提示しないでください。 |
| 雇用者ブランディングのみ、純粋な報道機関向けの広報・PR 配信、メールのみのマーケティング | 範囲を絞った案内にとどめてください。技術面とコンテンツの完全監査を暗黙に実施してはいけません。 |
| GA4/GTM の設定のみ(オーガニック SEO に関する質問なし) | references/procedures/10-analytics-reporting.md を参照してください。ドメイン全体の数値スコアを捏造してはいけません。 |
| ソーシャルコミュニティの管理のみ | オーガニック検索での発見に関連する場合(例:sameAs、エンティティシグナル)を除き、対象外です。 |
| 範囲が明示されたタスク(例:「robots.txt と sitemap のみ」) | その範囲内にとどめてください。ユーザーから求められない限り、ドメイン全体の E-E-A-T に関する長文や /100 スコアを提示してはいけません。 |
監査コンテキスト:内部モードと競合分析モード
ルーティングの前に、該当する監査コンテキストを判断してください。どの出力が有効かは、これによって決まります。
| シグナル | コンテキスト | 許可される内容 |
|---|---|---|
| ユーザーが「自分のサイト」「当社のサイト」「自分が所有している」と述べる、GSC/GA4 へのアクセスを提供する、またはバックエンドへのアクセスを確認する | 内部モード | スコア付きの完全な監査、すべてのスクリプトを実行対象にできる、実行モードを利用可能、/100 ヘルススコアが有効 |
| ユーザーが所有していない外部 URL(競合他社、見込み顧客、参考サイト) | 競合分析モード | 表層的なクロールのみ(ホームページ+最大 20 ページ)、/100 ヘルススコアなし、実行モードは無効、すべての出力に 「外部観察のみ」 と表示 |
判断に迷った場合は、次のように尋ねてください。「これはご自身のサイトですか、それとも競合他社の分析ですか?」
このスキルには 3 つのモードがあります。ほかの作業に着手する前に、該当するモードを特定してください。
3 つのモード
モード 1 — 監査
サイトを取得し、関連するチェックをすべて実行して、スコア付きレポートを作成します。すべての指摘事項に、重大度、根拠、影響の説明、修正指示が含まれます。出力:SEO ヘルススコア+優先順位付きの指摘事項 — 完全なテンプレートと手順については、references/procedures/02-full-site-audit.md を参照してください。
モード 2 — アクションプラン
監査結果(またはサイトの説明)を、段階的で優先順位付きの実行可能なロードマップにまとめます。曖昧な助言は避け、各項目で、変更する具体的なページ、要素、パターン、期待される結果、必要な作業量を明記します。出力:実装フェーズの表+クイックウィン — references/procedures/16-strategy-roadmap.md および references/procedures/02-full-site-audit.md のモード 2 形式を参照してください。
モード 3 — 実行
作業を実施します。メタタグの書き換え、スキーママークアップの生成、リダイレクトマップの作成、コンテンツ概要の作成、hreflang の修正、検証スクリプトの実行、納品ファイルの出力を行います。実行タスクはすべて、検証ステップで完了します — references/procedures/02-full-site-audit.md のモード 3 のループを参照してください。
generate_report.py の実行後は、サマリーの action_plan をレーンの順序に従って進めます。まず Auto(安全で、承認不要)、次に Assisted(高リスクゲートを適用)を実行し、Human/Decision の項目と open_questions はユーザーに戻します。未解決の質問は不足しているデータであり、指摘事項ではありません。
多くのリクエストでは、3 つすべてを順番に実施します:監査 → 計画 → 実行。監査結果がすでにある場合はモード 2 から開始し、実施する修正をユーザーが具体的に指定している場合はモード 3 から開始します。
受付チェックリスト
質問は 3 つだけです。ユーザーのメッセージですでに回答されている質問は省略してください。
| # | 質問 | 重要な理由 |
|---|---|---|
| 1 | URL は何ですか? | 3 つすべてのモードで必要です |
| 2 | 主な目標は何ですか?(トラフィック/AI による引用/ローカルでの見込み客獲得/トラフィック減少/特定のキーワード) | 最初に実行するモジュールを決定します |
| 3 | どのモードですか? 監査/監査+計画/監査+計画+実行 | 作業の範囲を決定します — 不明な場合は 3 つすべてを既定とします |
その他の情報(分析へのアクセス、CMS、業種)は、監査中に確認します。
モードのルーティング
User request + URL
│
├─ "audit", "analyze", "full check", "what's wrong"
│ └─ Mode 1 → read procedures/02-full-site-audit.md
│
├─ "give me a plan", "roadmap", "what to fix first"
│ └─ Mode 2 → procedures/16-strategy-roadmap.md (run Mode 1 first if no audit exists)
│
├─ "fix this", "generate schema", "rewrite my titles", "run the scripts"
│ └─ Mode 3 → procedures/21-script-toolbox.md; topical procedure file for the task
│
├─ Traffic drop / rankings lost
│ └─ Mode 1 focused → procedures/10-analytics-reporting.md first, then procedures/06-content-eeat-and-pruning.md / procedures/04-technical-seo.md
│
├─ AI citations / GEO question
│ └─ Mode 1 focused → procedures/03-geo-ai-search.md first
│
├─ Domain / CMS migration
│ └─ Mode 1 focused → procedures/20-site-migration.md
│
└─ No mode stated + URL / "audit + fix everything"
└─ Mode 1 → 2 → 3 (procedures/02, then 16, then execute top findings)
トピックからセクションへのルーティング表:references/procedures/01-request-detection-routing.md(旧 SKILL §1 と同じ内容)。
モードごとの「完了」の定義
監査完了の条件:SEO ヘルススコアを提示している(または理由とともに「スコア対象外」としている)、すべての重大および高の指摘事項を、指摘事項/根拠/影響/修正/確信度/反証可能性/先行指標の形式で文書化している(重大/高の項目には第一原則に基づく観察と依存関係も含める)、前提条件の監査セクションがある、理由を明示せずに省略したセクションがない。
計画完了の条件:指摘事項を 4 つの実装フェーズ(基盤/拡張/拡大/権威性)に分類している。各項目に、実施責任者のアクション、期待される結果、作業量の見積もり、依存関係の列(ブロック要因/解決される項目)が含まれている。計画は依存関係に基づいてトポロジカルソートされている。
実行完了の条件:すべての修正を実施し、検証している — 該当する検証スクリプトを実行し、出力を確認し、元の指摘事項が解決されたことを確かめている。
コンテキスト予算への配慮
コンテキスト長や実行時間に制限のあるモデルまたは構成(高速モデルのサブエージェント、CI パイプライン、エージェント型チェーンなど)で実行している場合は、限界に達する前に、適切に縮退してください。
- 実行前に見積もってください。
generate_report.pyとすべてのスクリプトを使った Mode 1 の完全な監査では、出力が 50k トークン以上になることがあります。実効予算が 32k トークン未満の場合は、対象を絞った監査に切り替え、ユーザーの主な懸念に関連するスクリプトのみを実行してください。 - タイムアウトするより、部分的に提供してください。 コンテキストまたは時間の上限が近づいている場合は、現時点での内容(Health Score と完了した調査結果)を提供し、スキップしたセクションとその理由を記載してください。不足箇所が明確な部分監査のほうが、何も出力されないタイムアウトより役に立ちます。
- Web の取得にはコストがかかります。 サイトを取得するたびに遅延とトークンが増えます。対象を絞ったタスク(スキーマのみ、robots.txt の確認、GEO のガイダンスなど)では、サイト全体をクロールするのではなく、ユーザーの説明と提供された URL をもとに回答してください。
- コンパクションのフォールバック。 監査の途中でコンテキストがいっぱいになった場合は、
references/procedures/21-script-toolbox.mdの Context Management に従って、完了したセクションを要約の箇条書きに圧縮し、残りのセクションを続けてください。
これはフォールバックであり、デフォルトではありません。コンテキスト予算に余裕がある場合は、常に完全な監査パイプラインを優先してください。
全体的なガードレール(常に適用)
これらのルールはすべてのモードに適用されます。表の全項目と評価者によるチェック: references/procedures/19-quality-gates-hard-rules.md。
エビデンスの完全性(データなしに断定しない)
| 主張 | 記載できる条件 |
|---|---|
| LCP / INP / CLS / パフォーマンススコア | pagespeed.py が正常に実行された、またはユーザーが PageSpeed Insights / CrUX の出力を貼り付けた |
| 被リンク数または参照ドメイン数 | link_profile.py が実行され、データを返した |
| オーガニックトラフィックまたは表示回数 | GSC / GA4 へのアクセスが確認され、データを取得できた |
| Health Score /100 | 内部 Mode で generate_report.py により重み付きチェックを 5 件以上測定した。overall の値を変更せずに報告する。そうでない場合は「スコア未算出」とする |
| スキーマのエラーまたは検証ステータス | ページに対して validate_schema.py が実行された |
| CMS サイトでスキーマが「見つからない」 | Rich Results Test またはブラウザーの JS で確認された(生の HTML では JS によって挿入されるスキーマを検出できません) |
データがない場合: [metric] 未測定 — 実データを得るには [script] を実行 と記載するか、ユーザーに提供を求めてください。
調査結果の形式(必須)
各調査結果には、Finding/Evidence/Impact/Fix/Confidence(Confirmed / Likely / Hypothesis)/Falsifiability(何があればこの内容が誤りだと証明できるか)/Leading Indicator(修正後に何を監視するか)を含めてください。Critical と High の調査結果には、First-Principle Observation と Dependency も必要です。references/thinking-framework.md の PERCEIVE → ANALYZE → VALIDATE → ACT フレームワークを適用してください。レポートの抜粋例:references/audit-output-example.md。
High-Risk の実行ゲート
robots.txt、canonical タグ、リダイレクトマップ、noindex、hreflang、一括 CMS テンプレートなどのHigh-Riskな変更は、平易な言葉で説明し、コードやファイルの内容を出力する前にユーザーの確認を取ってください。メタデータ、alt テキスト、ほとんどのスキーマ、コンテンツの書き換え、llms.txt などの安全な変更は、そのまま出力できます。分類表の全項目:references/procedures/02-full-site-audit.md(Mode 3)。
Mode 1 の監査を提供する前に
シェルを利用できる場合は、python scripts/report_lint.py report.md --summary summary.json を実行し、その後 references/procedures/19-quality-gates-hard-rules.md の内部自己評価パス(Evaluator-Optimizer チェックリスト)を実施してください。