seo-images-media

seo-images-media (M9)

アクセシブルで十分に説明されたメディアは、ランキングシステムと AI 抽出ツールの両方に読み取られます。画像の主要な意味的な手掛かりとなるのは alt テキストです。参照先：references/schema-tier1.md（VideoObject の行）。

入力

ディスパッチエンベロープで指定された PageSnapshot を使用します。<run_dir>/pages/<slug>.json から parsed を読み取ります（images[] の alt_present／sized／lazy、iframes、jsonld[]）。改変されていない証拠を確認するには、pages/<slug>.html を Grep します。サイトのアーティファクトは <run_dir>/site/{robots.json,sitemaps.json,discovery.json} にあります。audit.mjs がすでに出力した決定論的な検出結果は <run_dir>/findings.deterministic.json に記載されています。これらの ID は再出力せず、モデルの判定による検出結果のみを追加してください。スナップショットがなく、URL／パスを直接指定して呼び出された場合は、まず node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs" を実行し、出力されたスナップショットのパスを使用してください。

監査

PageSnapshot を使用して作業します（render.used が none でなければ parsed_rendered、そうでなければ parsed）。

1. alt の有無：コンテンツ用の <img> すべてに alt 属性があることを確認します。装飾画像（alt="" と role="presentation" の組み合わせは適切であり、検出結果には該当しません）と、alt 自体がない場合（不合格）を区別します。
2. alt の品質：コンテンツ画像の alt が空でないこと、ファイル名（IMG_2031.jpg）ではないこと、異なる画像間で一字一句同じものが重複していないこと、キーワードを詰め込んでいないこと（カンマ区切りのキーワードリストはアンチパターンです）を確認します。alt は、周囲のコンテンツに即した説明的なものにしてください。目安の長さは約 80～140 文字です。具体性を保ちつつ、スクリーンリーダーや AI によって途中で切り詰められない長さにします。
3. 寸法：レイアウトシフトを防ぐため、<img> に width と height を設定するか、CSS でアスペクト比を確保します（レイアウトシフトは Core Web Vitals の指標の一つです。CWV の測定自体は perf モジュールに任せます）。
4. 形式：より小さいバイト数で配信できる最新形式（WebP／AVIF）やレスポンシブな <picture>／srcset を利用できるにもかかわらず、従来の jpg／png が使われている場合は、指摘します。
5. 動画：埋め込み動画（<video>、YouTube／Vimeo の iframe）に VideoObject JSON-LD がない場合は、M5 と連携します。必須／推奨のプロパティは references/schema-tier1.md を参照してください。

修正

• 自動修正（fixable: auto）：ソースアセットの固有寸法から <img> に width／height を追加します（決定論的、追加のみ、検証可能）。fix 用の差分として出力されます。
• 提案（fixable: proposed）：画像と、周囲の見出し／キャプション／段落から推測した文脈に即した alt テキストを生成します。各案の適用には、人による個別の承認が必要です（alt は編集上の判断を伴います）。画像に何が写っているかを、ページの文脈で裏付けられる範囲を超えて決して捏造しないでください。文脈が不十分な場合は、明確に印を付けた TODO: describe image のプレースホルダーを残すか、ユーザーに確認してください。
• 参考情報（fixable: advisory）：形式のアップグレード（WebP／AVIF、srcset）。このツールはバイナリをトランスコードできないため、これらを書き込むことはありません。推奨のみ行います。

検証

• メソッド dom_assert：スナップショットを再解析し、条件（alt が空でない、width と height がある、ファイル名ではない、など）を検証します。
• 寸法の確認にリモートアセットの固有サイズが必要で、利用可能な取得手段がない場合、ステータスは pass ではなく needs_api になります。

検出結果

schema/finding.schema.json に従って検出結果を出力します。軸は both、モジュール全体の重大度は 3 です。重大度ポリシー：5 は、サイト／テンプレートのスコープで適格性を失わせる壊滅的な事実に限ります。4 は重大、3 は中程度、2 は軽微、1 はごく軽微、0 は情報提供です。また、アクティブなカテゴリで established の重大度 5 の fail のみがスコアの上限を設定できます（references/scoring-model.md）。M9 に重大度 4 に達するものはありません。

• M9.alt.missing — alt 属性のないコンテンツ用の <img>。status fail、fixable: proposed、confidence established。evidence.observed には該当する <img> タグを引用します。
• M9.img.no_dimensions — width／height のない <img>。status warn、fixable: auto、confidence directional（CLS への関連）。
• M9.video.missing_videoobject — VideoObject スキーマのない埋め込み動画。status warn、fixable: proposed、confidence established。 各検出結果では、evidence.observed にページからの引用を含めます。verification.reproduce は実行可能な形式にします。例：node "${CLAUDE_PLUGIN_ROOT}/scripts/parse-html.mjs" --snapshot <pages/<slug>.json>（または --url <u>）を実行し、images ブロック（missing_alt、empty_alt、missing_dimensions）を確認します。expected_impact は範囲と信頼度タグを付けて示します（単独の % 表記は不可）。

誠実さ

• 代替テキストはアクセシビリティと画像／AI による理解に役立ちます。ランキング向上は directional として扱い、確実な効果として保証しないでください。代替テキストを書き換えればトラフィックが増えると約束してはいけません。
• キーワードを詰め込んだ代替テキストは有害であり、役に立ちません。問題として指摘し、生成してはいけません。
• WebP／AVIF はバイト数を削減します（実際のパフォーマンス要因です）が、フォーマットだけでランキングが上がることは、文書化された要因ではありません。advisory／low の大きさにとどめてください。