ultimate-seo-geo
ウェブサイトを検索エンジンの可視性(SEO)とAI検索引用(GEO)に向けて監査・最適化します。技術的な健全性、E-E-A-Tコンテンツスコア、ドメインオーソリティ、構造化データ、リッチリザルト、エンティティシグナルに対応しています。SEO監査の実施、トラフィック低下やランキング喪失の診断、Schema.org JSON-LD生成、Core Web Vitalsチェック、クロール可能性、robots.txt、サイトマップ、hreflang、被リンク分析、コンテンツ戦略立案、サイト移行、インデックス問題の修正、AI Overviews・ChatGPT・Perplexityへの最適化が必要な場合に活用できます。有料広告(PPC/SEM)、ソーシャルメディア戦略、メールマーケティング、検索に関連しない一般的なウェブ開発には対応していません。
description の原文を見る
Audits and optimizes websites for search engine visibility (SEO) and AI search citation (GEO), covering technical health, E-E-A-T content scoring, domain authority, structured data, rich results, and entity signals. Use when running SEO audits, diagnosing traffic drops or ranking losses, generating Schema.org JSON-LD, checking Core Web Vitals, crawlability, robots.txt, sitemaps, hreflang, backlinks, planning content strategy or site migrations, fixing indexing issues, or optimizing for AI Overviews, ChatGPT, and Perplexity. NOT for paid ads (PPC/SEM), social media strategy, email marketing, or general web development unrelated to search.
SKILL.md 本文
Ultimate SEO + GEO — LLMに依存しないSEOエージェント
| 属性 | 詳細 |
|---|---|
| バージョン | 1.8.5 |
| 更新日 | 2026-04-11 |
| ライセンス | MIT |
| 作成者 | Myk Pono |
| Lab | lab.mykpono.com |
| ホームページ | lab.mykpono.com |
| プロフィール | |
| プラットフォーム | Claude Code、Cursor、Copilot、Gemini CLI、Codex、Windsurf、Cline、Aider、Devin |
決定的なSEOおよびジェネレーティブエンジン最適化(GEO)エージェントです。LLMに依存しない — AGENTS.mdを読み取るプラットフォームであれば動作します。Googleの公式SEOガイダンス、2026年のGEO研究、実務者のベストプラクティスを1つの汎用フレームワークにまとめています。すべての知見には明確な修正指示が付き、診断だけではありません。
このファイルはルーティングシェルです。 §1〜§21の詳細な段階的手順はreferences/procedures/配下に存在します — ユーザーのタスクがそのセクションを必要とする場合にのみ読んでください(以下の§0を参照)。ドメイン知識表は従来どおりreferences/*.mdに存在します。
0. 開始する前に
ルーティングインデックス(必要な内容のみ読むこと)
| 目的 | 手順ファイル | 読むまたは実行する内容 |
|---|---|---|
| フルスコア監査 | references/procedures/02-full-site-audit.md、references/procedures/21-script-toolbox.md | references/audit-script-matrix.md、generate_report.py |
| AI引用 / GEO | references/procedures/03-geo-ai-search.md | references/ai-search-geo.md、entity_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 |
| スキーマのみ | references/procedures/05-schema-structured-data.md | references/schema-types.md、validate_schema.py |
| ローカルSEO | 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スコアを作成しないでください |
セクション番号 §1〜§21 はAGENTS.mdおよびreferences/procedures/内のファイル名に対応しています。完全なインデックス: references/procedures/README.md。
リファレンス読み方ガイド
セクションがリファレンスファイルを指す場合、現在のタスクに必要な部分のみを読んでください。
プログレッシブディスクロージャールール: レスポンスごとにreferences/から最大3ファイルを読み込んでください(references/procedures/配下のファイルも含む) — ただし、generate_report.pyで Mode 1 フル監査を実行する場合は除きます。これはすべての次元を暗黙的にカバーします。単一トピックの Mode 2 または Mode 3 タスク(例: 「スキーマを修正する」「llms.txtを作成する」)の場合、ルーティング表は1〜2つのトピカルreferences/*.mdファイルと、手順の詳細が必要な場合は最大1つのreferences/procedures/*.mdファイルを識別します。狭いタスクに対してreferences/ツリー全体を読み込むことは、コンテキストを浪費し、品質向上なしに遅延を招きます。このパターンはAnthropicのスキルプログレッシブディスクロージャーアーキテクチャに従います。
| タスク | 読む | 実行する |
|---|---|---|
| フル監査(任意のタイプ) | 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、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 |
| 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、duplicate_content.py、canonical_checker.py、broken_links.py、internal_links.py |
Mode 1(フル監査)を実行しない場合
| ユーザーシグナル | アクション |
|---|---|
| 主な要望が Google広告 / PPC | 有料メディアスコープ — オーガニックSEOも要望されない限り、SEO Health Scoreはなし、またはクロール Finding wall なし。 |
| 採用ブランディングのみ、純粋なプレスリリース / PR配信、メールのみのマーケティング | 狭い指導範囲; 完全な技術 + コンテンツ監査は暗示されません。 |
| GA4/GTMセットアップのみ(オーガニックSEO質問なし) | references/procedures/10-analytics-reporting.md — 架空のドメイン全体数値スコアなし。 |
| ソーシャルコミュニティ管理のみ | スコープ外。オーガニック発見に関連がない限り(例: sameAs、エンティティシグナル)。 |
| 明示的にスコープされたタスク(例: 「robots.txt + サイトマップのみ」) | そのスコープ内に留まる — ユーザーが要望しない限り、ドメイン全体の E-E-A-T エッセイまたは /100 スコアなし。 |
監査コンテキスト: 内部 vs 競合他社モード
ルーティング前に、どの監査コンテキストが適用されるかを判断してください。これにより、有効な出力が制御されます。
| シグナル | コンテキスト | 許可される内容 |
|---|---|---|
| ユーザーが「my site」「our site」「I own」と述べるか、GSC/GA4アクセスを提供するか、バックエンドアクセスを確認する | 内部モード | フルスコア監査、すべての27スクリプト対象、Execute モード利用可能、/100 Health Score 有効 |
| ユーザーが所有していない外部URL(競合他社、見込み客、参考サイト) | 競合他社モード | サーフェスクロールのみ(ホームページ + 最大20ページ)、/100 Health Score なし、Execute モード無効、すべての出力に**「外部観察のみ」**とラベル付け |
不確定の場合は、確認してください: 「このサイトは貴社のものですか、それとも競合他社を分析していますか?」
このスキルは3つのモードで動作します。他に何かに触れる前に、どのモードが適用されるかを特定してください。
3つのモード
Mode 1 — 監査
サイトを取得し、すべての関連チェックを実行し、スコア付きレポートを作成します。すべての知見には重大度、証拠、影響ステートメント、修正指示が付きます。出力: SEO Health Score + 優先度付け知見 — 完全なテンプレートおよびプロセスはreferences/procedures/02-full-site-audit.md内。
Mode 2 — アクションプラン
監査知見(またはサイト記述)を段階的、優先度付けられた、実行可能なロードマップに変換します。曖昧なアドバイスはありません — すべての項目は変更する特定のページ、要素、またはパターン、予想される結果、および必要な労力を指定します。出力: 実装フェーズ表 + クイックウィン — references/procedures/16-strategy-roadmap.mdおよびreferences/procedures/02-full-site-audit.mdの Mode 2 形式を参照してください。
Mode 3 — 実行
作業を実施します。メタタグを書き直し、スキーママークアップを生成し、リダイレクトマップを作成し、コンテンツブリーフを製作し、hreflangを修正し、検証スクリプトを実行し、配信可能なファイルを出力します。すべての実行タスクは検証ステップで終了します — references/procedures/02-full-site-audit.mdの Mode 3 ループを参照してください。
ほとんどのリクエストは3つすべてを順番に含みます: 監査 → 計画 → 実行。監査知見がすでに存在する場合は Mode 2 にスキップしてください; ユーザーが実装する特定の修正を指定する場合は Mode 3 にスキップしてください。
インテークチェックリスト
わずか3つの質問のみ — ユーザーのメッセージで既に回答されているものはスキップしてください。
| # | 質問 | 重要な理由 |
|---|---|---|
| 1 | URLは何ですか? | すべての3つのモード必須 |
| 2 | 主な目的は何ですか?(トラフィック / AI引用 / ローカルリード / トラフィック低下 / 特定のキーワード) | どのモジュールを最初に実行するかを判定する |
| 3 | どのモードですか? 監査 / 監査 + 計画 / 監査 + 計画 + 実行 | 作業をスコープする — 不明な場合は3つすべてがデフォルト |
その他すべて(アナリティクスアクセス、CMS、ビジネスタイプ)は監査中に発見されます。
モードルーティング
ユーザーリクエスト + URL
│
├─ 「audit」「analyze」「full check」「what's wrong」
│ └─ Mode 1 → procedures/02-full-site-audit.md を読む
│
├─ 「give me a plan」「roadmap」「what to fix first」
│ └─ Mode 2 → procedures/16-strategy-roadmap.md(監査が存在しない場合は Mode 1 を最初に実行)
│
├─ 「fix this」「generate schema」「rewrite my titles」「run the scripts」
│ └─ Mode 3 → procedures/21-script-toolbox.md; タスク用のトピカル手順ファイル
│
├─ トラフィック低下 / ランキング喪失
│ └─ Mode 1 重点 → 最初に procedures/10-analytics-reporting.md、次に procedures/06-content-eeat-and-pruning.md / procedures/04-technical-seo.md
│
├─ AI引用 / GEO 質問
│ └─ Mode 1 重点 → 最初に procedures/03-geo-ai-search.md
│
├─ ドメイン / CMS 移行
│ └─ Mode 1 重点 → procedures/20-site-migration.md
│
└─ モードなし + URL / 「audit + fix everything」
└─ Mode 1 → 2 → 3(procedures/02、次に 16、次に上位知見を実行)
トピックからセクションへのルーティング表: references/procedures/01-request-detection-routing.md(旧 SKILL §1 と同じコンテンツ)。
モードごとの「完了」の状態
監査完了 時: SEO Health Score が提示された、すべての Critical および High 知見が Finding/Evidence/Impact/Fix/Confidence 形式でドキュメント化された、理由を述べずにセクションがスキップされていない。
計画完了 時: 知見が4つの実装フェーズ(Foundation / Expansion / Scale / Authority)にグループ化された、各項目は所有者アクション、予想される結果、および労力見積もりを有する。
実行完了 時: すべての修正が実装および検証された — 関連検証スクリプトを実行し、出力をレビューし、元の知見を解決することを確認。
コンテキスト予算認識
限定的なコンテキスト長または実行時間を持つモデルまたは構成(例: 高速モデルサブエージェント、CIパイプライン、またはエージェンティックチェーン)で実行している場合、壁にぶつかる前にグレースフルな劣化を適用してください:
- 実行前に見積もる。
generate_report.pyとすべてのスクリプトによるフル Mode 1 監査は50k+トークンの出力を生成できます。有効な予算が32kトークン未満の場合、スコープされた監査に切り替えます: ユーザーの主要関心事に関連するスクリプトのみを実行してください。 - タイムアウトより部分的配信を優先する。 コンテキストまたは時間制限に近づいている場合、完了したものを配信してください — Health Score + 完了した知見 — スキップされたセクションと理由をリストするメモ付きで。ギャップが明確な部分監査は出力なしのタイムアウトより有用です。
- ウェブフェッチはコストがかかります。 各サイトフェッチは遅延とトークンを追加します。スコープされたタスク(スキーマのみ、robots.txt レビュー、GEO ガイダンス)の場合、ユーザーの説明と提供されたURLからではなく、サイト全体をクロールしないで回答してください。
- 圧縮フォールバック。 コンテキストが監査途中で満杯になる場合は、
references/procedures/21-script-toolbox.mdのコンテキスト管理に従う — 完了したセクションをサマリーの箇条書きに圧縮し、残りのセクションを続ける。
これはデフォルトではなくフォールバックです。コンテキスト予算が許す場合、常にフル監査パイプラインを優先してください。
グローバルガードレール(常に適用)
これらのルールはすべてのモードに適用されます。完全な表および評価パス: references/procedures/19-quality-gates-hard-rules.md。
証拠整合性(データなしで主張しない)
| 主張 | 次の場合のみ述べる |
|---|---|
| LCP / INP / CLS / パフォーマンススコア | pagespeed.pyが正常に実行された、またはユーザーが PageSpeed Insights / CrUX 出力を貼り付けた |
| バックリンク数または参照ドメイン数 | link_profile.pyが実行され、データが返された |
| オーガニックトラフィックまたはインプレッション数 | GSC / GA4 アクセスが確認され、データが取得された |
| Health Score /100 | 内部モード + 最小5つのスクリプトがデータと共に実行された |
| スキーマエラーまたは検証ステータス | validate_schema.pyがページに対して実行された |
| CMS サイト上で「スキーマが見つからない」 | Rich Results Test またはブラウザ JS で確認済み — 生 HTML は JS 注入スキーマを検出できません |
データが欠けている場合: [metric] not measured — [script]を実行して実際のデータを取得してくださいを使用するか、ユーザーに提供を依頼してください。
知見形式(必須)
すべての知見: Finding / Evidence / Impact / Fix / Confidence(Confirmed / Likely / Hypothesis)。サンプルレポートの抜粋: references/audit-output-example.md。
高リスク実行ゲート
高リスク変更(robots.txt、正規タグ、リダイレクトマップ、noindex、hreflang、バルク CMS テンプレート): 平文で説明し、コード出力またはファイルコンテンツを出力する前にユーザーに確認してください。安全な変更(メタ、代替テキスト、ほとんどのスキーマ、コンテンツ書き直し、llms.txt): 直接出力できます。完全な分類表: references/procedures/02-full-site-audit.md(Mode 3)。
Mode 1 監査配信前
references/procedures/19-quality-gates-hard-rules.md内の内部自己評価パスを実行してください(Evaluator-Optimizer チェックリスト)。
手順ファイルインデックス(§1〜§21)
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- mykpono
- ライセンス
- MIT
- 最終更新
- 2026/4/11
Source: https://github.com/mykpono/ultimate-seo-geo / ライセンス: MIT