seo-audit

ウェブサイト全体のSEO監査

共有データキャッシュ

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

情報を収集する前に、関連するSEOスキルで再利用可能なコンテキストがないか .seo-cache/ を確認します。 スキーマと依存関係マップについては、../seo/references/shared-data-cache.md を参照してください。

以下のキャッシュファイルがある場合は確認します：

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

• .seo-cache/audit-scores.json：以前の全体監査の優先事項

• .seo-cache/pages/{url-slug}/page-analysis.json：URL が指定されている場合のページ単位のコンテキスト

• 見つかった場合：明らかに有効なフィールドを解析して使用します（「[日付] の [X] をキャッシュから使用」と記録します）

• 見つからない場合、破損している場合、または関連性がない場合：新たな根拠を使って続行します

• ユーザーが「refresh」または「re-run」と指定した場合：キャッシュの読み取りを無視し、書き込み時に上書きします

プロセス

1. ホームページを取得する：scripts/fetch_page.py を使用して HTML を取得します
2. ビジネスタイプを検出する：SEO オーケストレーターに従ってホームページのシグナルを分析します
3. サイトをクロールする：robots.txt を遵守し、最大 500 ページまで内部リンクをたどります
4. サブエージェントに委任する（利用できる場合。できない場合は順番にインラインで実行します）：
   • seo-technical -- robots.txt、サイトマップ、canonical、Core Web Vitals、セキュリティヘッダー
   • seo-content -- E-E-A-T、読みやすさ、内容の薄いコンテンツ、AI による引用への対応状況
   • seo-schema -- 検出、検証、生成に関する推奨事項
   • seo-sitemap -- 構造分析、品質ゲート、不足しているページ
   • seo-performance -- LCP、INP、CLS の測定
   • seo-visual -- スクリーンショット、モバイルテスト、ファーストビュー分析
   • seo-geo -- AI クローラーのアクセス、llms.txt、引用可能性、ブランド言及のシグナル
   • seo-local -- GBP のシグナル、NAP の一貫性、レビュー、ローカルスキーマ、業種固有のローカル要因（ローカルサービス業と検出された場合に起動：実店舗型、SAB、またはハイブリッド型のビジネスタイプ）
   • seo-maps -- ジオグリッド順位追跡、GBP 監査、レビューインテリジェンス、競合の半径マッピング（ローカルサービス業と検出され、DataForSEO MCP が利用可能な場合に起動）
   • seo-google -- CWV のフィールドデータ（CrUX）、URL のインデックス登録状況（GSC）、オーガニックトラフィック（GA4）（python scripts/google_auth.py --check により Google API の認証情報が検出された場合に起動）
   • seo-backlinks -- バックリンクプロファイルデータ：DA/PA、参照ドメイン、アンカーテキスト、有害なリンク（python scripts/backlinks_auth.py --check により Moz または Bing API の認証情報が検出された場合に起動するか、常に Common Crawl のドメインレベル指標を含めます）
   • seo-cluster -- セマンティッククラスタリング分析（コンテンツ戦略のシグナルが検出された場合に起動：ブログ、ピラーページ、トピッククラスター）
   • seo-sxo -- 検索体験の分析：ページタイプの不一致、ユーザーストーリー、ペルソナのスコアリング（完全監査には常に含めます）
   • seo-drift -- ドリフト分析：保存済みのベースラインと比較します（python scripts/drift_history.py <url> によって URL のドリフトベースラインが存在する場合に起動）
   • seo-ecommerce -- 商品スキーマ、マーケットプレイスインテリジェンス（E コマース業と検出された場合に起動）
5. スコアを算出する -- SEO 健全性スコア（0～100）に集計します
6. レポートを作成する -- 優先順位を付けたアクションプランを生成します

クロール設定

Max pages: 500
Respect robots.txt: Yes
Follow redirects: Yes (max 3 hops)
Timeout per page: 30 seconds
Concurrent requests: 5
Delay between requests: 1 second

出力ファイル

• FULL-AUDIT-REPORT.md：包括的な調査結果
• ACTION-PLAN.md：優先順位を付けた推奨事項（重大 > 高 > 中 > 低）
• screenshots/：デスクトップとモバイルのキャプチャ（Playwright が利用可能な場合）
• PDF レポート（推奨）：scripts/google_report.py --type full を使用して、プロフェッショナルな A4 PDF を生成します。目次、エグゼクティブサマリー、グラフ（Lighthouse のゲージ、クエリバー、インデックスのドーナツグラフ）、指標カード、しきい値テーブル、工数の見積もりを含む優先順位付き推奨事項、実装ロードマップを備えた、白い表紙のエンタープライズレポートを生成します。監査の完了後は、必ず PDF の生成を提案してください。

スコアの重み付け

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

レポートの構成

エグゼクティブサマリー

• SEO の総合健全性スコア（0～100）
• 検出されたビジネスタイプ
• 重大な問題のトップ 5
• すぐに実施できる改善策のトップ 5

テクニカル SEO

• クロール可能性の問題
• インデックス登録の問題
• セキュリティ上の懸念
• Core Web Vitals のステータス

コンテンツ品質

• E-E-A-T の評価
• 内容の薄いページ
• 重複コンテンツの問題
• 可読性スコア

オンページ SEO

• タイトルタグの問題
• メタディスクリプションの問題
• 見出し構造
• 内部リンクの不足箇所

スキーマと構造化データ

• 現在の実装状況
• 検証エラー
• 未活用の機会

パフォーマンス

• LCP、INP、CLS のスコア
• リソース最適化の必要性
• サードパーティスクリプトの影響

画像

• alt テキストの不足
• サイズが大きすぎる画像
• 推奨フォーマット

AI 検索への対応状況

• 引用可能性スコア
• 構造上の改善点
• 権威性を示すシグナル

優先度の定義

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

DataForSEO との統合（任意）

DataForSEO MCP ツールが利用可能な場合は、既存のサブエージェントと並行して seo-dataforseo エージェントを起動し、監査に最新データを追加します。具体的には、実際の SERP 順位、スパムスコア付きのバックリンクプロファイル、オンページ分析（Lighthouse）、ビジネスリスティング、AI での可視性チェック（ChatGPT スクレイパー、LLM での言及）を取得します。

Google API との統合（任意）

Google API の認証情報が設定されている場合（python scripts/google_auth.py --check）、seo-google エージェントを起動して、実際の Google のフィールドデータを監査に追加します。具体的には、CrUX Core Web Vitals（ラボデータのみの推定値を置き換えます）、GSC の URL インデックス登録状況、検索パフォーマンス（クリック数、表示回数、CTR）、GA4 のオーガニックトラフィックの傾向を取得します。パフォーマンス（CWV）カテゴリのスコアは、フィールドデータによる恩恵が最も大きくなります。

エラー処理

シナリオ	対応
URL に到達できない（DNS エラー、接続拒否）	エラーを明確に報告します。サイトの内容を推測しないでください。URL を確認して再試行するようユーザーに提案します。
robots.txt によってクロールがブロックされている	ブロックされているパスを報告します。アクセス可能なページのみ分析し、レポートに制限事項を記載します。
レート制限（429 応答）	待機時間を設け、同時リクエスト数を減らします。完了できなかったセクションを明記して、部分的な結果を報告します。
大規模サイト（500 ページ以上）でのタイムアウト	タイムアウトの上限でクロールを打ち切ります。クロールしたページの調査結果を報告し、サイト全体の規模を推定します。

共有データキャッシュへの書き込み

すべての作業が完了したら、ワークフローで永続的な調査結果が得られた場合に、簡潔な JSON サマリーを .seo-cache/ に書き込みます。 ../seo/references/shared-data-cache.md に記載されているスキーマと命名規則に従い、少なくとも cache_type、analyzed_at、ソース URL／ドメイン、主な調査結果、問題、推奨事項、ツールの制限事項を含めます。.gitignore に .seo-cache/ が記載されていない場合は追加します。