クロールでは、画像ごとにファイル容量、alt属性、読み込めるかどうかを記録します。Screaming Frogのエクスポートも、sf runでオフラインで分析できます。検出結果から、代替テキストのない画像、容量の上限を超えた画像、widthとheightの指定がなく、ページの読み込み中にレイアウトがずれる画像が分かります。
images-optimizeは、ローカルの画像を再圧縮、リサイズ、またはWebPやAVIFに変換します。保存済みのスキャンで宣言された画像も対象にでき、1回の実行で最大50点（重複を除く）です。widthとheightの上限を指定しても、画像が拡大されることはありません。品質は10〜100で指定するか、自動で決められます。
最適化の結果は、別のディレクトリに書き込みます。元のファイルを変更するには、in-placeフラグの明示が必要です。その場合もバックアップは既定で作成されます。既存のファイルを置き換えるには、overwriteフラグが必要です。
ネイティブクロールでは、画像ごとにファイル容量、alt属性、読み込めるかどうかを記録します。Screaming Frogのエクスポートも、seohead sf runでオフラインで分析できます。
images-optimizeは、WebPやAVIFを別のディレクトリに書き出します。画像を拡大することはなく、in-placeで編集する前にはバックアップを作成します。
sf run --tasksは、再現手順付きの開発者向けタスクリストを出力します。ファイル名を変えた場合は、新旧URLのペアからredirects-generateで301リダイレクトを作成します。
| チェック項目 | 意味 | 重要度 | 根拠 |
|---|---|---|---|
IMG_MISSING_ALT | 画像に代替テキストがない | Important | 画像のURLと、その画像を使うページ |
IMG_MISSING_ALT_ATTRIBUTE | img要素にalt属性そのものがない（alt=""もない）。ネイティブクロール。 | Important | ページのURLと、alt属性のないimg要素の数 |
IMG_OVER_KB | 画像のファイル容量がしきい値（既定は150KB）より大きい。リソース取得を有効にしたネイティブクロールで計測します。 | Important | 画像のURL、バイト数、上限値 |
IMG_BROKEN | 画像のURLが4xxまたは5xxのエラーを返し、ブラウザーに何も表示されない。ネイティブクロール。 | Important | 画像のURL、HTTPステータス、参照元のページ |
IMG_MISSING_DIMENSIONS | img要素にwidthとheightの宣言がなく、レイアウト用の領域が確保されない | Tip | 画像のURLと参照元のページ |
IMG_ALT_TOO_LONG | 代替テキストが設定した上限（既定は100文字）より長い。ネイティブクロール。 | Tip | 画像のURL、代替テキストの長さ、代替テキスト |
seohead images-optimize --files ./images --output-dir ./optimized --format webp先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。