fixing-metadata

ワークフロー

1. メタデータ（タイトル、説明、canonical、OG タグ）が不足している、または正しくないページを特定します
2. 以下の優先順位ルールに照らして監査し、重大な問題（重複、インデックス登録）から修正します
3. タイトル、説明、canonical、og:url がすべて一致していることを確認します
4. localhost ではなく、実際の URL でソーシャルカードが正しく表示されることを確認します
5. 差分はメタデータのみに限定し、関係のないコードはリファクタリングしません

適用する場合

以下の作業では、このガイドラインを参照してください。

• ページタイトル、説明、canonical、robots の追加または変更
• Open Graph または Twitter カードのメタデータの実装
• ファビコン、アプリアイコン、マニフェスト、theme-color の設定
• 共通 SEO コンポーネントやレイアウトのメタデータのデフォルト値の構築
• 構造化データ（JSON-LD）の追加
• ロケール、代替言語、canonical ルーティングの変更
• 新しいページ、マーケティングページ、共有可能なリンクの公開

優先順位別のルールカテゴリ

優先度	カテゴリ	影響
1	正確性と重複	重大
2	タイトルと説明	高
3	canonical とインデックス登録	高
4	ソーシャルカード	高
5	アイコンとマニフェスト	中
6	構造化データ	中
7	ロケールと代替言語	低〜中
8	ツールの境界	重大

クイックリファレンス

1. 正確性と重複（重大）

• ページごとにメタデータを一か所で定義し、競合する仕組みを避けます
• title、description、canonical、robots タグを重複して出力しないでください
• メタデータは決定的なものにし、ランダムな値や不安定な値を使わないでください
• ユーザー生成文字列や動的な文字列は、エスケープしてサニタイズしてください
• すべてのページに、安全な title と description のデフォルト値を設定してください

2. タイトルと説明（高）

• すべてのページに title を設定してください
• サイト全体で一貫したタイトル形式を使用してください
• タイトルは短く読みやすくし、キーワードの詰め込みを避けてください
• 共有または検索が可能なページには、meta description を設定してください
• description はプレーンテキストにし、Markdown や引用符の多用は避けてください

3. canonical とインデックス登録（高）

• canonical は、そのページの優先 URL を指すようにしてください
• noindex は、非公開、重複、または一般公開されないページにのみ使用してください
• robots meta は、実際のアクセス意図と一致させてください
• 可能な場合、プレビューやステージング用のページはデフォルトで noindex にしてください
• ページ分割されたページでは、canonical を正しく設定してください

4. ソーシャルカード（高）

• 共有可能なページには、Open Graph の title、description、image を設定してください
• Open Graph と Twitter の画像には、絶対 URL を使用してください
• 適切な画像サイズと安定したアスペクト比を優先してください
• og:url は canonical URL と一致させてください
• 適切な og:type を使用してください。通常は website または article です
• twitter:card を適切に設定してください。デフォルトでは summary_large_image を使用します

5. アイコンとマニフェスト（中）

• すべてのブラウザーで機能するファビコンを少なくとも 1 つ含めてください
• 該当する場合は apple-touch-icon を含めてください
• マニフェストは有効なものにし、使用する場合は参照してください
• UI の表示が不一致にならないよう、theme-color を意図的に設定してください
• アイコンのパスは安定しており、キャッシュ可能なものにしてください

6. 構造化データ（中）

• ページの実際のコンテンツに明確に対応していない限り、JSON-LD を追加しないでください
• JSON-LD は有効で、実際にレンダリングされる内容を反映している必要があります
• 評価、レビュー、価格、組織の詳細を捏造しないでください
• 必要な場合を除き、ページごとに構造化データのブロックは 1 つにしてください

7. ロケールと代替言語（低〜中）

• html の lang 属性を正しく設定してください
• ローカライズがある場合は og:locale を設定してください
• ページが実際に存在する場合にのみ、hreflang の代替言語を追加してください
• ローカライズされたページは、ロケールごとに正しく canonical を設定してください

8. ツールの境界（重大）

• 変更は最小限にとどめ、関係のないコードをリファクタリングしないでください
• 依頼されていない限り、フレームワークや SEO ライブラリを移行しないでください
• プロジェクトで既に採用されているメタデータのパターン（Next.js metadata API、react-helmet、手動の head など）に従ってください

レビューの指針

• 重大な問題（重複、canonical、インデックス登録）を優先して修正してください
• title、description、canonical、og:url の内容が一致していることを確認してください
• ソーシャルカードは localhost ではなく、実際の URL で確認してください
• 独創的または動的なメタデータより、安定したシンプルなメタデータを優先してください
• 差分はメタデータのみに限定し、最小限にしてください