seo

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

呼び出し： /seo $1 $2。$1 はコマンド、$2 は URL または引数です。

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

あらゆる業界（SaaS、地域密着型サービス、E コマース、出版社、代理店）を対象とした包括的な SEO 分析です。24 個のサブスキル（コア 21 個＋フレームワーク統合 1 個＋拡張ミラー 2 個）と 18 個のサブエージェントを連携させます。別途、オプションの Firecrawl 拡張機能もインストールできます（下記「オプションの拡張機能」を参照）。

クイックリファレンス

コマンド	内容
/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 content-brief <topic or url>	対象キーワード、アウトライン、内部リンクを含む詳細な SEO コンテンツブリーフを生成
/seo geo <url>	AI Overviews／生成エンジン最適化
/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／国際化 SEO の監査と生成
/seo google [command] [url]	Google SEO API（GSC、PageSpeed、CrUX、インデックス登録、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. 10 原則フレームワークを使って統合します（以下の「統合方法」を参照）。問題点を「重大／高／中／低」に分類する前に、PERCEIVE → ANALYZE → VALIDATE → ACT の順に進めます
14. 依存関係の順序付けと推奨事項ごとの反証可能性を含む、優先順位付きのアクションプランを作成します
15. PDF レポートを提案します：「プロフェッショナルな PDF レポートを生成しますか？/seo google report full を使用してください」

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

統合方法

監査は単に問題点を見つけるだけではなく、それらを一貫性のある戦略に統合するものです。seo-skills は、4 つのフェーズにまとめられた 10 原則の思考フレームワークを使用します：PERCEIVE（observe-external・observe-internal・listen）、ANALYZE（think・connect-lateral・connect-system）、VALIDATE（feel・accept）、ACT（create・grow）。

完全な監査（/seo audit、/seo page）では、アクションプランを出力する前にすべてのフェーズを実行します。範囲を絞ったコマンド（/seo schema、/seo images など）では、出力前に少なくとも THINK + ACCEPT を実行します（原則を最初に確認し、反証可能性を明示します）。優先度を「重大／高／中／低」に分類することは、検証の結果であり、検証に代わるものではありません。

方法論の全容と原則ごとの SEO 対応表：references/thinking-framework.md。

出力する各推奨事項には、以下を含めます：

• 根拠となる第一原理の観察事項（THINK）
• 他の推奨事項への依存関係、またはその実行を可能にする関係（CONNECT-system）
• 「これが失敗したと、どうすればわかるか？」を確認する明確な方法（ACCEPT）
• 監査を再実行せずにユーザーが監視できる先行指標（GROW）

業界の判定

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

• 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 以上の場合は警告を表示（独自のコンテンツを 60％ 以上にする）
• ロケーションページが 50 以上の場合はハードストップ（ユーザーによる理由の説明が必要）
• HowTo スキーマは推奨しないでください（2023 年 9 月に廃止）
• Google のリッチリザルト向け FAQ スキーマ：政府機関および医療機関のサイトに限ります（2023 年 8 月の制限）。商用サイトに既存の FAQPage がある場合は、AI／LLM に引用される利点に言及し、優先度を「情報」（「重大」ではない）として指摘します。新たな FAQPage の追加は、Google 向けの効果がないため推奨しません
• Core Web Vitals への言及では、必ず INP を使用し、FID は使用しません

参照ファイル

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

• 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%

優先度

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

サブスキル

このスキルは24個のサブスキル（コア21個＋フレームワーク連携1個＋拡張ミラー2個）を統括します。統括スキル自体（seo）はskills/内の25番目ですが、自身を統括しないため、以下には列挙していません。

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

オプションの拡張機能

以下はskills/ではなくextensions/に含まれており、有効化には別途インストーラーが必要です（各拡張機能のinstall.sh／install.ps1を参照してください）。

• seo-firecrawl -- Firecrawl MCPによるサイト全体のクロールとサイトマッピング。extensions/firecrawl/install.sh（Unix）またはextensions/firecrawl/install.ps1（Windows）でインストールします。インストール後は、/seo firecrawl <command>で呼び出します。

サブエージェント

監査中に並行分析を行います。

• 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-flow -- FLOW フレームワークのプロンプト（条件付き：コンテンツ戦略のワークフローで起動）
• seo-dataforseo -- 最新の SERP、キーワード、バックリンク、ローカル SEO のデータ（拡張機能、任意）
• seo-image-gen -- SEO 画像監査と生成計画（拡張機能、任意）

エラー処理

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