fixing-metadata

ワークフロー

1. メタデータが欠落または不正確なページを特定 (タイトル、説明、canonical、OGタグ)
2. 以下の優先ルールに照らし合わせて監査 — 重大な問題 (重複、インデックス設定) を最初に修正
3. タイトル、説明、canonical、og:url がすべて互いに一致していることを確認
4. localhost ではなく実際の URL でソーシャルカードが正しくレンダリングされることを確認
5. 差分を最小限に保ち、メタデータのみにスコープを絞る — 無関係なコードはリファクタリングしない

適用するタイミング

以下のガイドラインに従う場合に参照してください:

• ページタイトル、説明、canonical、robots を追加または変更する場合
• Open Graph または Twitter カードメタデータを実装する場合
• favicon、アプリアイコン、manifest、theme-color を設定する場合
• 共有 SEO コンポーネントまたはレイアウトメタデータのデフォルトを構築する場合
• 構造化データ (JSON-LD) を追加する場合
• ロケール、代替言語、または canonical ルーティングを変更する場合
• 新しいページ、マーケティングページ、または共有可能なリンクを公開する場合

ルールカテゴリー (優先度別)

優先度	カテゴリー	影響度
1	正確性と重複の排除	重大
2	タイトルと説明	高
3	canonical とインデックス設定	高
4	ソーシャルカード	高
5	アイコンと manifest	中
6	構造化データ	中
7	ロケールと代替ページ	低～中
8	ツールの境界	重大

クイックリファレンス

1. 正確性と重複の排除 (重大)

• ページあたり 1 つの場所にメタデータを定義し、競合するシステムを避ける
• 重複した title、description、canonical、robots タグを出力しない
• メタデータは確定的であることが必須、ランダムまたは不安定な値は使用しない
• ユーザー生成またはダイナミック文字列をエスケープとサニタイズする
• すべてのページにはタイトルと説明の安全なデフォルトが必要

2. タイトルと説明 (高)

• すべてのページにはタイトルが必須
• サイト全体で一貫したタイトル形式を使用する
• タイトルは短く読みやすく、詰め込まない
• 共有可能またはサーチ可能なページにはメタ説明が必要
• 説明はプレーンテキストであること、マークダウンまたはスパムを含めない

3. canonical とインデックス設定 (高)

• canonical はページの優先 URL を指す必要がある
• noindex は非公開、重複、または公開されていないページにのみ使用する
• robots メタは実際のアクセス意図と一致する必要がある
• プレビューまたはステージングページは可能な限りデフォルトで noindex にする
• ページネーションされたページには正しい canonical 動作が必須

4. ソーシャルカード (高)

• 共有可能なページは Open Graph のタイトル、説明、画像を設定する必須
• Open Graph と Twitter 画像は絶対 URL を使用する
• 正しい画像寸法と安定したアスペクト比を優先する
• og:url は canonical URL と一致する必須
• 理に適った og:type を使用、通常は website または article
• twitter:card を適切に設定、デフォルトは summary_large_image

5. アイコンと manifest (中)

• ブラウザ全体で機能する favicon を少なくとも 1 つ含める
• 関連がある場合は apple-touch-icon を含める
• manifest は有効で、使用時に参照される必須
• theme-color は意図的に設定し、UI chrome の不一致を回避する
• アイコンパスは安定でキャッシュ可能であること

6. 構造化データ (中)

• 実際のページコンテンツに明確にマップされない限り JSON-LD を追加しない
• JSON-LD は有効であり、実際にレンダリングされるものを反映する必須
• 存在しない評価、レビュー、価格、または組織詳細を作成しない
• 必要でない限り 1 ページあたり 1 つの構造化データブロックを優先する

7. ロケールと代替ページ (低～中)

• html の lang 属性を正しく設定する
• ローカライゼーションが存在する場合は og:locale を設定する
• ページが実際に存在する場合にのみ hreflang 代替を追加する
• ローカライズされたページはロケールごとに正しく canonical 化する必須

8. ツールの境界 (重大)

• 最小限の変更を優先し、無関係なコードをリファクタリングしない
• 要求がない限り framework または SEO ライブラリを移行しない
• プロジェクトの既存メタデータパターンに従う (Next.js metadata API、react-helmet、手動 head など)

レビューガイダンス

• 重大な問題を最初に修正 (重複、canonical、インデックス設定)
• タイトル、説明、canonical、og:url が互いに一致していることを確認
• localhost ではなく実際の URL でソーシャルカードを確認
• 巧妙またはダイナミックなメタデータより、安定した退屈なメタデータを優先する
• 差分を最小限に保ち、メタデータのみにスコープを絞る