検出結果はすべて、`entered`、`left`、`appeared`、`disappeared`のいずれかに分類されます。`left`は、両方のクロールがURLを取得できていて、検出結果が消えた場合です。`disappeared`は、後のクロールがそのURLを取得しなかった場合で、修正の証拠にはなりません。
URLが変わる前後を比較するには、ペアをurl-correspondence.v1ファイルで宣言し、--correspondenceで渡します。照合は完全一致です。SpiderHeadが、タイトルやリダイレクト、コンテンツからペアを推測することはありません。結果は、宣言したペアごとのページ情報と検出結果の差分をまとめた、リリースレビューになります。
ページ数または問題の件数が10,000を超える監査では、--out-dirの明示が必要です。出力先には、NDJSONストリームとマニフェストを含む、新しいcompare.v2フォルダが作られます。gzip圧縮も任意で使えます。結果は、再計算せずにあとから読めます。
変更の前と後にcrawl-siteを実行するか、Screaming Frogの監査をインポートします。実行ごとに保存ファイルが1つ残り、あとから比較できます。
compare-crawlsは2つのファイルを読み、すべての検出結果を`entered`、`left`、`appeared`、`disappeared`に分類します。何も取得しません。
`left`は、両方のクロールでURLを取得でき、検出結果が消えた状態です。`disappeared`は、URLが再確認されていないため、修正の証拠になりません。個別の検出結果の判定には、verify-fixesを使います。
| チェック項目 | 意味 | 重要度 | 根拠 |
|---|---|---|---|
BROKEN_PAGE_4XX | ページが4xxを返しています。差分では、`entered`（新たな不具合）か、`left`（両方のクロールで取得できたURLでの修正）かがわかります。 | Critical | 同じURLの、変更前と変更後の検出結果の行 |
SERVER_ERROR_5XX | ページが5xxを返しています。2つのクロールの間で、`entered`、`left`、`disappeared`の判定は同じ考え方です。 | Critical | 同じURLの、変更前と変更後の検出結果の行 |
TITLE_MISSING | ページにtitle要素がありません。リグレッションは`entered`の行、修正は`left`の行に表れます。 | Critical | 同じURLの、変更前と変更後の検出結果の行 |
REDIRECT_CHAIN | リダイレクトチェーンが2ホップ以上あります。移行後に、チェーンが増えていないかの確認に役立ちます。 | Important | 同じURLの、変更前と変更後の検出結果の行 |
CANONICAL_MISSING | インデックス可能なページに、canonical URLがありません。テンプレートのリリースで、canonicalが抜けた箇所を検出します。 | Important | 同じURLの、変更前と変更後の検出結果の行 |
URL_NOT_IN_SITEMAP | インデックス可能なページが、サイトマップにありません。リリースにサイトマップの更新が追いついているかがわかります。 | Tip | 同じURLの、変更前と変更後の検出結果の行 |
seohead compare-crawls --before ./scans/before.sqlite --after ./scans/after.sqlite先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。