seo-page

単一ページ分析

共有データキャッシュ

ステップ 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」と指定した場合：キャッシュの読み取りを無視し、書き込み時に上書きします

分析対象

オンページ SEO

• タイトルタグ：50～60 文字、主要キーワードを含み、固有であること
• メタディスクリプション：150～160 文字、魅力的で、キーワードを含むこと
• H1：ちょうど 1 つ、ページの意図に合致し、キーワードを含むこと
• H2～H6：論理的な階層（レベルを飛ばさないこと）、内容がわかる見出しであること
• URL：短く、内容がわかりやすく、ハイフンで区切られ、パラメーターがないこと
• 内部リンク：十分な数があり、関連性の高いアンカーテキストを使用し、孤立したページがないこと
• 外部リンク：信頼できる情報源へのリンクで、数が適切であること

コンテンツの品質

• ページ種別ごとの最低文字数との比較（quality-gates.md を参照）
• 読みやすさ：Flesch Reading Ease スコア、学年レベル
• キーワード密度：自然であること（1～3％）、意味的なバリエーションが含まれていること
• E-E-A-T シグナル：著者プロフィール、資格、実体験を示す要素
• コンテンツの鮮度：公開日、最終更新日

技術要素

• Canonical タグ：存在し、自己参照または正しく設定されていること
• メタ robots：意図的にブロックしていない限り、index/follow であること
• Open Graph：og:title、og:description、og:image、og:url
• Twitter Card：twitter:card、twitter:title、twitter:description
• Hreflang：多言語の場合、正しく実装されていること

スキーママークアップ

• すべてのタイプを検出する（JSON-LD を推奨）
• 必須プロパティを検証する
• 不足している機会を特定する
• HowTo（非推奨）や FAQ（政府・医療分野に限定）を決して推奨しない

画像

• Alt テキスト：設定され、内容を具体的に説明し、自然な場合はキーワードを含むこと
• ファイルサイズ：200KB 超は警告、500KB 超は重大として指摘する
• 形式：JPEG/PNG より WebP/AVIF を推奨する
• 寸法：CLS 防止のため width/height を設定する
• 遅延読み込み：ファーストビューより下の画像に loading="lazy" を設定する

Core Web Vitals（参考のみ。HTML だけでは測定できません）

• LCP の潜在的な問題を指摘する（巨大なヒーロー画像、レンダリングをブロックするリソース）
• INP の潜在的な問題を指摘する（重い JS、async/defer がない）
• CLS の潜在的な問題を指摘する（画像の寸法指定がない、コンテンツが挿入される）

出力

ページスコアカード

Overall Score: XX/100

On-Page SEO:     XX/100  ████████░░
Content Quality: XX/100  ██████████
Technical:       XX/100  ███████░░░
Schema:          XX/100  █████░░░░░
Images:          XX/100  ████████░░

見つかった問題

優先度順に整理：重大 -> 高 -> 中 -> 低

推奨事項

期待される効果を添えた、具体的で実行可能な改善案

スキーマの提案

検出された機会に対応する、そのまま使える JSON-LD コード

DataForSEO 連携（任意）

DataForSEO MCP ツールを利用できる場合は、実際の SERP 順位に serp_organic_live_advanced を、被リンクデータとスパムスコアに backlinks_summary を使用します。

エラー処理

シナリオ	対応
URL にアクセスできない（DNS エラー、接続拒否）	エラーを明確に報告します。ページの内容を推測してはいけません。ユーザーに URL の確認と再試行を提案します。
ページに認証が必要（401/403）	ページが認証で保護されていることを報告します。ユーザーに、レンダリング済み HTML を直接提供するか、一般公開されている URL を提示するよう提案します。
JavaScript でレンダリングされるコンテンツ（HTML の本文が空）	重要なコンテンツがクライアント側でレンダリングされている可能性があることを記載します。利用可能な HTML を分析し、結果が不完全な可能性があることを明示します。利用可能であれば、ブラウザーでレンダリングしたスナップショットの使用を提案します。

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

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