seo-audit

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

プロセス

1. ホームページをレンダリング："${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py <url> --mode auto --json を使用して、必要に応じて生のHTML、レンダリング済みHTML、抽出テキスト、SPAのステータス、アクセシビリティデータを取得します
2. ビジネスタイプを検出：seo orchestratorに従って、ホームページのシグナルを分析します
3. サイトをクロール：内部リンクをたどって最大500ページをクロールし、robots.txtを尊重します
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-agentic -- Lighthouse Agentic Browsingの割合（X/N）、エージェント向けアクセシビリティツリー、AIエージェントのアクセス方針、Markdownとディスカバリーファイル、WebMCP（AI検索への対応状況に分析結果を反映するため、完全監査には必ず含めます）
   • seo-local -- GBPのシグナル、NAPの一貫性、レビュー、ローカルスキーマ、業界固有のローカル要因（ローカルサービス業界（実店舗型、SAB、ハイブリッド型のビジネスタイプ）が検出された場合に起動します）
   • seo-maps -- ジオグリッド順位の追跡、GBP監査、レビュー分析、競合の商圏マッピング（ローカルサービスが検出され、DataForSEO MCPが利用可能な場合に起動します）
   • seo-google -- CWVのフィールドデータ（CrUX）、URLのインデックス登録状況（GSC）、オーガニックトラフィック（GA4）（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check でGoogle APIの認証情報が検出された場合に起動します）
   • seo-matomo -- Matomo Reporting API：オーガニックトラフィック、ランディングページ、デバイス／国別の内訳、参照元分析（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run matomo_auth.py --check でMatomoの認証情報が検出された場合に起動します。両方が設定されている場合は seo-google と並行して実行し、GA4が設定されていない場合はGA4の代替として実行します）
   • seo-backlinks -- 被リンクプロファイルデータ：DA/PA、参照ドメイン、アンカーテキスト、有害なリンク（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check でMozまたはBing APIの認証情報が検出された場合に起動します。または、Common Crawlのドメインレベルの指標を必ず含めます）
   • seo-cluster -- セマンティッククラスタリング分析（コンテンツ戦略のシグナル（ブログ、ピラーページ、トピッククラスター）が検出された場合に起動します）
   • seo-sxo -- 検索体験の分析：ページタイプの不一致、ユーザーストーリー、ペルソナのスコアリング（完全監査には必ず含めます）
   • seo-drift -- ドリフト分析：保存済みのベースラインとの比較（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_history.py <url> でそのURLのドリフトベースラインが確認された場合に起動します）
   • seo-ecommerce -- 商品スキーマ、マーケットプレイス分析（Eコマース業界が検出された場合に起動します）
5. スコアを算出 -- SEOヘルススコア（0～100）に集約します
6. 監査成果物を保存 -- すべての出力を {domain}-audit/ の下に書き込みます
7. レポート -- 優先順位付けしたアクションプランと、オプションのPDF／HTMLレポートを生成します

クロール設定

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

出力ファイル

• {domain}-audit/FULL-AUDIT-REPORT.md：包括的な調査結果
• {domain}-audit/ACTION-PLAN.md：優先順位付きの推奨事項（Critical > High > Medium > Low）
• {domain}-audit/audit-data.json：レポート生成用の構造化された監査データ
• {domain}-audit/findings/*.md：カテゴリ別の専門的な調査結果（technical.md、content.md、schema.md、performance.md、visual.mdなど）
• {domain}-audit/screenshots/：デスクトップとモバイルのキャプチャ（Playwrightが利用可能な場合）
• PDFレポート（推奨）："${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type full --data {domain}-audit/audit-data.json --domain <domain> --output-dir {domain}-audit/を使用して、プロフェッショナルなA4 PDFを生成します。目次、エグゼクティブサマリー、グラフ（Lighthouseゲージ、クエリバー、インデックスドーナツ）、指標カード、しきい値テーブル、工数見積もり付きの優先順位別推奨事項、実装ロードマップを備えた、白い表紙のエンタープライズ向けレポートが作成されます。監査の完了後は、必ずPDFの生成を提案してください。

構造化監査データのエンベロープ

Google APIデータが利用できない場合でも、"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type full --data {domain}-audit/audit-data.json --domain <domain> --output-dir {domain}-audit/でレポートを生成できるよう、次の形式で{domain}-audit/audit-data.jsonを作成します。

{
  "summary": {
    "health_score": 0,
    "business_type": "detected type",
    "top_findings": [],
    "quick_wins": []
  },
  "categories": [
    {
      "name": "Technical SEO",
      "score": 0,
      "what_works": [],
      "findings": [
        {
          "title": "Finding title",
          "severity": "Critical|High|Medium|Low|Info",
          "description": "Evidence-backed detail",
          "recommendation": "Specific fix"
        }
      ]
    }
  ],
  "action_plan": {
    "phases": [
      {"name": "Phase 1: Critical Fixes", "timeframe": "Week 1", "items": []},
      {"name": "Phase 2: High-Impact Improvements", "timeframe": "Weeks 2-3", "items": []},
      {"name": "Phase 3: Content & Authority", "timeframe": "Month 2", "items": []},
      {"name": "Phase 4: Monitoring & Iteration", "timeframe": "Ongoing", "items": []}
    ]
  },
  "artifacts": {
    "findings_dir": "findings/",
    "screenshots_dir": "screenshots/"
  }
}

スコアの重み付け

カテゴリ	重み
技術的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検索への対応状況

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

優先度の定義

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

DataForSEOとの連携（任意）

DataForSEO MCPツールが利用可能な場合は、既存のサブエージェントとともにseo-dataforseoエージェントを起動し、実際のSERP順位、スパムスコア付きの被リンクプロフィール、オンページ分析（Lighthouse）、ビジネスリスティング、AI可視性チェック（ChatGPTスクレーパー、LLMへの言及）などのライブデータで監査内容を充実させます。

Google APIとの連携（任意）

Google APIの認証情報が設定されている場合（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check）、seo-googleエージェントを起動し、実際のGoogleフィールドデータで監査内容を充実させます。具体的には、CrUX Core Web Vitals（ラボデータのみの推定値を置き換えます）、GSCのURLインデックス登録状況、検索パフォーマンス（クリック数、表示回数、CTR）、GA4のオーガニックトラフィックの推移などです。フィールドデータは、パフォーマンス（CWV）カテゴリのスコアに最も効果があります。

Matomo 連携（任意）

Matomo の認証情報が設定されている場合（"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run matomo_auth.py --check）、seo-matomo エージェントを起動して、セルフホスト型の分析データで監査を充実させます。対象は、オーガニック訪問数の推移、上位のランディングページ、デバイス別・国別の内訳、チャネル別／検索エンジン別の内訳、オーガニックキーワードです。GA4 の代替（Matomo のみが設定されている場合）または補完（GA4 と Matomo の両方が設定されている場合）として機能します。セグメントの違い（referrerType==search と sessionDefaultChannelGroup == "Organic Search"）やアトリビューション期間のルールにより、Matomo の数値は GA4 と完全には一致しません。

Google アップデートとの相関

トラフィックやランキングの変化を何かに関連付ける前に、一次情報に基づく記録から、その期間中に確認された Google アップデートを列挙します。

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run seo_updates.py --since <yyyy-mm> --json

各項目には Google が所有する URL が記載されています。freshness.stale が true の場合は、記録に最近のアップデートが反映されていない可能性があることを伝え、結論を出す前に status.search.google.com を確認してください。日付の重なりは仮説であり、原因の証明ではありません。

エラー処理

シナリオ	対応
URL にアクセスできない（DNS エラー、接続拒否）	エラーを明確に報告します。サイトの内容を推測してはいけません。ユーザーに URL を確認して再試行するよう提案します。
robots.txt によってクロールがブロックされる	ブロックされているパスを報告します。アクセス可能なページのみを分析し、レポートに制約を記載します。
レート制限（429 レスポンス）	待機して、同時リクエスト数を減らします。完了できなかったセクションを記載して、部分的な結果を報告します。
大規模サイト（500+ ページ）でタイムアウトする	タイムアウトの上限でクロールを打ち切ります。クロールしたページの調査結果を報告し、サイト全体の規模を推定します。
大規模サイトでサブエージェントが maxTurns の上限に達する	調査結果は失われません。各監査サブエージェントは最初の分析パスの後に部分的な output_dir/findings/*.md を書き込み、終了前に完全な調査結果で上書きします。存在する調査結果ファイルを読み取ってレポートに統合し、部分的な内容である可能性を記載します。