Compare rastreamentos antes e depois

Compare duas auditorias ou varreduras salvas sem rastrear de novo. Veja quais problemas entraram, quais saíram e o que mudou em uma migração de URLs declarada.

O que faz

Quatro grupos, uma regra

Todo problema cai em `entered`, `left`, `appeared` ou `disappeared`. `left` significa que os dois rastreamentos buscaram a URL e o problema sumiu. `disappeared` significa que o rastreamento posterior nunca buscou a URL, então não prova nada sobre uma correção.

  • Configurações de rastreamento registradas diferentes são recusadas, a não ser que você use --force.
  • Rastreamentos nativos e exportações do Screaming Frog podem encontrar conjuntos de URLs diferentes, então compare-os só com escopo compatível.
  • Uma verificação pulada na execução mais recente mantém um aviso nos seus grupos.

Migrações

Para comparar após uma mudança de URL, declare os pares em um arquivo url-correspondence.v1 e passe-o com --correspondence. A correspondência é exata: o SpiderHead não adivinha pares a partir de títulos, redirecionamentos ou conteúdo. O resultado é uma revisão de release, com fatos de página e variações de problemas para cada par declarado.

  • origin_map cobre mudanças de origem inteira.
  • Uma declaração tem no máximo 10.000 pares explícitos e 10.000 origens.
  • Declarações maiores são recusadas, nunca truncadas.

Auditorias grandes e URLs isoladas

Auditorias acima de 10.000 páginas ou problemas precisam de um --out-dir explícito. Ele recebe uma nova pasta compare.v2 com fluxos NDJSON e um manifesto, com gzip opcional. Depois, é possível lê-la sem recalcular.

  • compare-read percorre um fluxo com filtros e ordenação.
  • compare-report gera um resumo em Markdown que não contém URLs de páginas.
  • compare-url mostra os fatos antes e depois de uma URL exata.
  • compare-status e --resume retomam um trabalho interrompido.

Três passos, um rastreamento salvo

  1. Salve uma varredura de cada lado

    Rode crawl-site antes e depois da mudança, ou importe uma auditoria do Screaming Frog. Cada execução gera um arquivo salvo que você pode comparar depois.

  2. Compare os dois arquivos salvos

    compare-crawls lê os dois arquivos e separa cada problema em `entered`, `left`, `appeared` ou `disappeared`. Ele não busca nada.

  3. Separe correção de página ausente

    `left` significa que a URL foi buscada pelos dois rastreamentos e o problema sumiu. `disappeared` significa que a URL não foi verificada de novo, então não prova nada. Use verify-fixes para ter um veredito sobre problemas específicos.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
BROKEN_PAGE_4XXUma página retorna 4xx. A comparação mostra se ela entrou (quebra nova) ou saiu (corrigida em uma URL que os dois rastreamentos buscaram).CriticalLinhas de problema antes e depois para a mesma URL
SERVER_ERROR_5XXUma página retorna 5xx. A mesma lógica de entered, left ou disappeared vale entre os dois rastreamentos.CriticalLinhas de problema antes e depois para a mesma URL
TITLE_MISSINGO elemento title está ausente na página. Uma regressão aparece como linha entered, e uma correção, como linha left.CriticalLinhas de problema antes e depois para a mesma URL
REDIRECT_CHAINUma cadeia de redirecionamentos tem dois ou mais saltos. Útil depois de uma migração para confirmar que nenhuma cadeia foi criada.ImportantLinhas de problema antes e depois para a mesma URL
CANONICAL_MISSINGUma página indexável não tem URL canonical. Pega canonicals removidos em uma release de template.ImportantLinhas de problema antes e depois para a mesma URL
URL_NOT_IN_SITEMAPUma página indexável está fora do sitemap. Mostra se o sitemap acompanhou a release.TipLinhas de problema antes e depois para a mesma URL

Um comando

bash
seohead compare-crawls --before ./scans/before.sqlite --after ./scans/after.sqlite

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Dois arquivos audit.json salvos ou arquivos SQLite scan.v1 (--before, --after)
  • Opcional: um arquivo url-correspondence.v1 para uma migração
  • Uma nova pasta de saída (--out-dir) para auditorias grandes

Limites

  • Um problema que desapareceu não é uma correção. Use verify-fixes para ter um veredito sobre problemas específicos.
  • Uma verificação não medida ou pulada não consegue mostrar correção, mesmo que o problema tenha saído.
  • Não há comparação de URLs além dos pares que você declarar.
  • Uma pasta de saída já existente é recusada, nunca sobrescrita.

Perguntas

O compare-crawls rastreia o site de novo?
Não. Ele lê dois arquivos salvos de auditoria ou varredura e não faz requisições. O verify-fixes é o comando que busca de novo as URLs selecionadas.
Posso comparar um rastreamento nativo com uma exportação do Screaming Frog?
Só com escopo e configurações compatíveis. Rastreamentos nativos e do Screaming Frog podem encontrar conjuntos diferentes de URLs. Se as configurações registradas forem diferentes, a comparação é recusada, a não ser que você use --force.
Uma página sumiu do segundo rastreamento. Ela está corrigida?
Não se sabe. Um problema que desapareceu significa que a página não foi verificada de novo. Só `left` quer dizer que a URL foi buscada pelos dois rastreamentos e o problema sumiu.
E os sites grandes?
Auditorias acima de 10.000 páginas ou problemas precisam de um --out-dir explícito. A saída é uma nova pasta compare.v2 com arquivos NDJSON e um manifesto. Use --compression gzip para reduzir o tamanho dos arquivos.
Ele consegue associar URLs antigas às novas depois de uma migração?
Só com um arquivo url-correspondence.v1 declarado, que lista pares de origem e caminho (--correspondence). Ele não adivinha pares a partir de títulos ou conteúdo.
O que ele grava no disco?
Comparações pequenas são devolvidas na própria resposta. Com --out-dir, ele grava uma nova pasta com o manifesto e um arquivo por fluxo. Nada é enviado para lugar nenhum.

Teste no seu próprio site