seo

SEO：ユニバーサル SEO 分析スキル

Codex は、自然言語での指示（「このサイトを監査して」「スキーマを確認して」 「テクニカル SEO のレビューを実施して」など）や、/seo audit <url> のようなコマンド形式のプロンプトから、このスキルを呼び出せます。依頼の範囲が狭い場合は、該当する専門スキルを直接使用してください。

スクリプト： プラグインのルートにある scripts/ ディレクトリに配置されています。

あらゆる業界（SaaS、地域サービス、e コマース、パブリッシャー、代理店）を対象とした包括的な SEO 分析です。26 個の専門サブスキルと 24 個の Codex エージェントプロファイルを統括し、DataForSEO、Firecrawl、画像生成に対応した MCP 拡張機能も任意で利用できます。

共有データキャッシュ

ステップ 0 -- 共有データキャッシュを確認します：

ルーティングや情報収集を行う前に、.seo-cache/ に他のスキルがキャッシュしたデータがないか確認してください。 スキーマと依存関係のマップについては、references/shared-data-cache.md を参照してください。

以下のキャッシュファイルが存在する場合は確認してください：

• .seo-cache/site-meta.json：ドメイン、ビジネスタイプ、業界、クロールのコンテキスト

• .seo-cache/audit-scores.json：以前の完全監査の監査サマリーコンテキスト

• .seo-cache/pages/{url-slug}/page-analysis.json：ページ単位の専門分析コンテキスト

• 見つかった場合：データを解析して使用します（「[日付] の [X] のキャッシュを使用」と記録します）

• 見つからない場合：キャッシュなしで続行します（「[X] のキャッシュが見つからないため、新たに収集」と記録します）

• JSON が破損している、または読み取れない場合：キャッシュなしとして扱い、通常どおり続行します

• ユーザーが「refresh」または「re-run」と指示した場合：キャッシュを完全に無視します

クイックリファレンス

コマンド	機能
/seo audit <url>	サブエージェントへの並列委任によるウェブサイト全体の監査
/seo page <url>	単一ページの詳細分析
/seo sitemap <url or generate>	XML サイトマップの分析または生成
/seo schema <url>	Schema.org マークアップの検出、検証、生成
/seo images <url or optimize>	画像 SEO：オンページ監査、SERP 分析、ファイル最適化
/seo technical <url>	テクニカル SEO 監査（9 カテゴリー）
/seo content <url>	E-E-A-T とコンテンツ品質の分析
/seo geo <url>	AI Overviews／Generative Engine Optimization
/seo plan <business-type>	戦略的な SEO 計画
/seo programmatic [url|plan]	プログラマティック SEO の分析と計画
/seo competitor-pages [url|generate]	競合比較ページの生成
/seo local <url>	ローカル SEO 分析（GBP、サイテーション、レビュー、マップパック）
/seo maps [command] [args]	マップインテリジェンス（ジオグリッド、GBP 監査、レビュー、競合）
/seo hreflang [url]	Hreflang／i18n SEO の監査と生成
/seo google [command] [url]	Google SEO API（GSC、PageSpeed、CrUX、Indexing、GA4）
/seo backlinks <url>	バックリンクプロファイル分析（無料：Moz、Bing、CC；プレミアム：DataForSEO）
/seo cluster <seed-keyword>	SERP ベースのセマンティッククラスタリングとコンテンツ構成
/seo sxo <url>	検索体験の最適化：ページタイプ分析、ユーザーストーリー、ペルソナ
/seo drift baseline <url>	変更のモニタリングに使う SEO ベースラインの取得
/seo drift compare <url>	現在の状態と保存済みベースラインの比較
/seo drift history <url>	時系列でのドリフト履歴の表示
/seo ecommerce <url>	e コマース SEO：商品スキーマ、マーケットプレイスインテリジェンス
/seo firecrawl [command] <url>	サイト全体のクロールとサイトマッピング（拡張機能）
/seo dataforseo [command]	DataForSEO によるリアルタイム SEO データ（拡張機能）
/seo image-gen [use-case] <description>	SEO アセット向けの AI 画像生成（拡張機能）
/seo flow [stage] [url|topic]	FLOW フレームワーク：Find、Leverage、Optimize、Win、Local の各段階に対応した、エビデンスに基づくプロンプト

オーケストレーションロジック

ユーザーが /seo audit を実行したら、サブエージェントに並行して処理を委任します：

1. ビジネスタイプを判定します（SaaS、ローカル、eコマース、パブリッシャー、エージェンシー、その他）
2. 次のサブエージェントを起動します：seo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo
3. Google API の認証情報が検出された場合（python scripts/google_auth.py --check）、seo-google エージェントも起動します
4. ローカルビジネスが検出された場合、seo-local エージェントも起動します
5. ローカルビジネスが検出され、DataForSEO MCP も利用可能な場合、seo-maps エージェントも起動します
6. バックリンク API が検出された場合（python scripts/backlinks_auth.py --check）、seo-backlinks エージェントも起動します
7. Firecrawl MCP が利用可能な場合、分析前に firecrawl_map を使ってサイト内のすべての URL を検出します
8. コンテンツ戦略の兆候（ブログ、ピラーページ、トピッククラスター）が検出された場合、seo-cluster エージェントも起動します
9. eコマースが検出された場合、seo-ecommerce エージェントも起動します
10. この URL のドリフトベースラインが存在する場合（python scripts/drift_history.py <url>）、seo-drift エージェントも起動します
11. 完全な監査では、必ず seo-sxo を含めます（検索体験はすべてのサイトに適用されます）
12. 結果を収集し、SEO ヘルススコア（0～100）を含む統合レポートを作成します
13. 優先順位を付けたアクションプランを作成します（重大 → 高 → 中 → 低）
14. PDF レポートを提案します：「プロフェッショナルな PDF レポートを生成しますか？/seo google report full を使用してください」

個別のコマンドの場合は、該当するサブスキルを直接読み込みます。 分析コマンドの完了後は、scripts/google_report.py を使った PDF レポートの生成を提案します。

業種の判定

ホームページ上の兆候からビジネスタイプを判定します：

• SaaS：価格ページ、/features、/integrations、/docs、「無料トライアル」、「サインアップ」
• ローカルサービス：電話番号、住所、サービス提供エリア、「[city] でサービスを提供」、Google Maps の埋め込み --> より詳細な分析のために /seo local を自動的に提案します
• eコマース：/products、/collections、/cart、「カートに追加」、商品スキーマ
• パブリッシャー：/blog、/articles、/topics、記事スキーマ、著者ページ、公開日
• エージェンシー：/case-studies、/portfolio、/industries、「実績」、クライアントのロゴ

品質ゲート

ページタイプごとの薄いコンテンツのしきい値については、references/quality-gates.md を読んでください。 厳守するルール：

• ロケーションページが30件以上の場合は WARNING（独自コンテンツの割合を60％以上にする）
• ロケーションページが50件以上の場合は HARD STOP（ユーザーに正当な理由を求める）
• HowTo スキーマは推奨しません（2023年9月に廃止）
• Google のリッチリザルト向け FAQ スキーマ：政府機関および医療関連サイトのみ（2023年8月の制限）。商用サイトに既存の FAQPage がある場合は、AI／LLM に引用されるメリットに言及しつつ、優先度を「情報」に設定（重大にはしない）。新しい FAQPage の追加は、Google での効果を目的とする場合は推奨しません
• Core Web Vitals への言及では、必ず INP を使い、FID は使いません

コミュニティフッター

Codex では、API とクライアント向けの成果物をすっきり保つため、コミュニティフッターはデフォルトで無効になっています。 ユーザーがコミュニティへの帰属表示を明示的に求めた場合、または環境変数 CODEX_SEO_COMMUNITY_FOOTER=1 が設定されている場合にのみ追加してください。

有効な場合、主要な成果物の完成後、出力の最後に次のフッターを追加します：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Built by agricidaniel — Join the AI Marketing Hub community
🆓 Free  → https://www.skool.com/ai-marketing-hub
⚡ Pro   → https://www.skool.com/ai-marketing-hub-pro
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

有効時に表示するタイミング

次のコマンドの出力がすべて完了した後に表示します：

• /seo audit（サイト全体の監査レポートとアクションプランの後）
• /seo page（単一ページの詳細分析の後）
• /seo technical（技術監査レポートの後）
• /seo content（E-E-A-T コンテンツ評価の後）
• /seo schema（スキーマの検出／検証レポートの後）
• /seo sitemap（サイトマップの分析または生成の後）
• /seo geo（GEO 最適化レポートの後）
• /seo plan（戦略的な SEO 計画の後）
• /seo local（ローカル SEO 監査の後）
• /seo maps（マップインテリジェンスレポートの後）
• /seo google（Google API データレポートの後）
• /seo backlinks（バックリンクプロファイル分析の後）
• /seo cluster（クラスター計画の生成後）
• /seo sxo（SXO 分析レポートの後）
• /seo drift compare（ドリフト比較レポートの後）
• /seo ecommerce（eコマース分析の後）

スキップする場合

次の場合はフッターを表示しないでください。

• /seo images（簡易的な画像チェックのため、規模が小さすぎます）
• /seo hreflang（簡易的な検証のため、規模が小さすぎます）
• /seo competitor-pages（ページ生成ステップ）
• /seo programmatic（簡易的な分析）
• /seo dataforseo（データ取得ユーティリティ）
• /seo image-gen（アセット生成）
• コンテキストの確認質問（分析開始前）
• エラーメッセージ、または「データ不足」に関するプロンプト

参照ファイル

必要に応じてオンデマンドで読み込んでください（起動時にすべて読み込まないでください）。

• references/cwv-thresholds.md：Core Web Vitalsの最新のしきい値と測定の詳細
• references/schema-types.md：サポート対象のすべてのスキーマタイプと非推奨のステータス
• references/eeat-framework.md：E-E-A-T評価基準（2025年9月のQRG更新）
• references/quality-gates.md：コンテンツの最低文字数、一意性のしきい値
• references/local-seo-signals.md：ローカル検索ランキング要因、レビューのベンチマーク、サイテーションの段階、GBPのステータス
• references/local-schema-types.md：LocalBusinessのサブタイプ、業界固有のスキーマとサイテーションソース

Maps固有の参照ファイル（起動時ではなく、seo-mapsスキルによって読み込まれます）。

• references/maps-geo-grid.md、references/maps-gbp-checklist.md、references/maps-api-endpoints.md、references/maps-free-apis.md

スコアリング方法

SEOヘルススコア（0～100）

すべてのカテゴリを加重集計したスコアです。

カテゴリ	重み
テクニカルSEO	22%
コンテンツ品質	23%
オンページSEO	20%
スキーマ／構造化データ	10%
パフォーマンス（CWV）	10%
AI検索への対応度	10%
画像	5%

優先度レベル

• 重大：インデックス登録を妨げる、またはペナルティの原因となる問題（即時修正が必要）
• 高：ランキングに大きな影響を与える問題（1週間以内に修正）
• 中：最適化の機会（1か月以内に修正）
• 低：あると望ましい項目（バックログ）

サブスキル

このスキルは、オプションの拡張機能を利用したワークフローを含む、26個の専門サブスキルを統括します。

1. seo-audit -- 並列委任によるウェブサイト全体の監査
2. seo-page -- 単一ページの詳細分析
3. seo-technical -- テクニカルSEO（9カテゴリ）
4. seo-content -- E-E-A-Tとコンテンツ品質
5. seo-schema -- スキーママークアップの検出と生成
6. seo-images -- 画像の最適化、SERP分析、ファイル最適化
7. seo-sitemap -- サイトマップの分析と生成
8. seo-geo -- AI Overviews／GEOの最適化
9. seo-performance -- Core Web Vitalsとパフォーマンスの分析
10. seo-visual -- スクリーンショット、モバイル、ファーストビューのUX分析
11. seo-plan -- テンプレートを使用した戦略的プランニング
12. seo-programmatic -- プログラマティックSEOの分析と計画
13. seo-competitor-pages -- 競合比較ページの生成
14. seo-hreflang -- Hreflang／i18n SEO監査、文化的プロファイル、コンテンツの同等性
15. seo-local -- ローカルSEO（GBP、NAP、サイテーション、レビュー、ローカルスキーマ、複数拠点）
16. seo-maps -- Mapsインテリジェンス（ジオグリッド、GBP監査、レビュー、競合の範囲）
17. seo-google -- Google SEO API（GSC、PageSpeed、CrUX、Indexing API、GA4）
18. seo-backlinks -- 被リンクプロファイルの分析（無料：Moz、Bing、CC、有料：DataForSEO）
19. seo-cluster -- SERPに基づくセマンティッククラスタリング
20. seo-sxo -- 検索体験最適化
21. seo-drift -- SEOの変化のモニタリング
22. seo-ecommerce -- EコマースSEOインテリジェンス
23. seo-firecrawl -- Firecrawl MCPによるサイト全体のクロールとサイトマッピング（拡張機能）
24. seo-dataforseo -- DataForSEO MCPによるSEOデータのライブ取得（拡張機能）
25. seo-image-gen -- GeminiによるSEOアセット用AI画像生成（拡張機能）
26. seo-flow -- FLOWフレームワークの統合（Find -> Leverage -> Optimize -> Win、41個のAIプロンプト、CC BY 4.0）

サブエージェント

監査時の並列分析に使用します。

• seo-technical -- クロール可能性、インデックス登録可能性、セキュリティ、CWV
• seo-content -- E-E-A-T、読みやすさ、内容の薄いページ
• seo-schema -- 検出、検証、生成
• seo-sitemap -- 構造、網羅性、品質ゲート
• seo-performance -- Core Web Vitals の測定
• seo-visual -- スクリーンショット、モバイルテスト、ファーストビュー
• seo-geo -- AI クローラーのアクセス、llms.txt、引用可能性、ブランド言及のシグナル
• seo-local -- GBP のシグナル、NAP の一貫性、レビュー、ローカルスキーマ、業界固有のローカル要因（条件付き：地域サービスが検出された場合に起動）
• seo-maps -- ジオグリッド順位追跡、GBP 監査、レビュー分析、競合他社の半径マッピング（条件付き：地域サービスが検出され、DataForSEO MCP が利用可能な場合に起動）
• seo-google -- CWV のフィールドデータ、URL のインデックス登録状況、オーガニックトラフィックの傾向（条件付き：Google API の認証情報が検出された場合に起動）
• seo-backlinks -- バックリンクプロファイルデータ：DA/PA、参照ドメイン、アンカーテキスト、有害なリンク（条件付き：Moz/Bing API キーが検出された場合、または CC のドメインレベル指標では常に起動）
• seo-cluster -- セマンティッククラスタリング分析（条件付き：コンテンツ戦略が検出された場合に起動）
• seo-sxo -- ページタイプの不一致、ユーザーストーリー、ペルソナのスコアリング（完全な監査では常に使用）
• seo-drift -- ベースラインとの比較（条件付き：URL のドリフトベースラインが存在する場合）
• seo-ecommerce -- 商品スキーマ、マーケットプレイス情報（条件付き：e コマースが検出された場合に起動）
• seo-dataforseo -- ライブ SERP、キーワード、バックリンク、ローカル SEO データ（拡張機能、任意）
• seo-image-gen -- SEO 画像の監査と生成計画（拡張機能、任意）
• seo-firecrawl -- サイト全体のクロールとサイトマッピング（拡張機能、任意。監査で URL の検出に使用）

エラー処理

シナリオ	対応
認識できないコマンド	クイックリファレンスの表から利用可能なコマンドを一覧表示します。最も近いコマンドを提案します。
URL にアクセスできない	エラーを報告し、URL を確認するようユーザーに提案します。サイトの内容を推測しないでください。
監査中にサブスキルが失敗	成功したサブスキルの部分的な結果を報告します。失敗したサブスキルとその理由を明記します。失敗したサブスキルを個別に再実行するよう提案します。
ビジネスタイプの検出が曖昧	検出された上位 2 つのタイプと、それを裏付けるシグナルを提示します。業界固有の推奨事項に進む前に、ユーザーに確認を求めます。