Comparar rastreos antes y después

Compara dos auditorías o escaneos guardados sin volver a rastrear. Mira qué incidencias entraron, cuáles salieron y qué cambió en una migración de URL declarada.

Qué hace

Cuatro grupos, una regla

Cada incidencia cae en uno de estos grupos: entered, left, appeared o disappeared. Left significa que ambos rastreos obtuvieron la URL y la incidencia ya no está. Disappeared significa que el rastreo posterior nunca obtuvo la URL, así que no demuestra nada sobre una corrección.

  • Las configuraciones de rastreo distintas que quedaron registradas se rechazan, salvo que pases --force.
  • Los rastreos nativos y las exportaciones de Screaming Frog pueden encontrar conjuntos de URL distintos, así que compáralos solo con un alcance compatible.
  • Una comprobación saltada en la ejecución posterior mantiene una advertencia en sus grupos.

Migraciones

Para comparar a través de un cambio de URL, declara los pares en un archivo url-correspondence.v1 y pásalo con --correspondence. La coincidencia es exacta: SpiderHead no adivina pares a partir de títulos, redirecciones ni contenido. El resultado es una revisión de publicación con datos de cada página y diferencias de incidencias para cada par declarado.

  • origin_map cubre los traslados de origen completo.
  • Una declaración admite como máximo 10 000 pares explícitos y 10 000 orígenes.
  • Las declaraciones más grandes se rechazan, nunca se truncan.

Auditorías grandes y URL sueltas

Las auditorías de más de 10 000 páginas o incidencias necesitan un --out-dir explícito. Recibe una carpeta nueva compare.v2 con flujos NDJSON y un manifiesto, con gzip opcional. Después se lee sin volver a calcular.

  • compare-read lee las páginas de un flujo, con filtros y orden.
  • compare-report escribe un resumen en Markdown que no contiene URL de páginas.
  • compare-url muestra los datos antes y después de una URL exacta.
  • compare-status y --resume continúan un trabajo interrumpido.

Tres pasos, un análisis guardado

  1. Guarda un escaneo de cada lado

    Ejecuta crawl-site antes y después del cambio, o importa una auditoría de Screaming Frog. Cada ejecución deja un archivo guardado que puedes comparar después.

  2. Compara los dos archivos guardados

    compare-crawls lee ambos archivos y ordena cada incidencia en entered, left, appeared o disappeared. No descarga nada.

  3. Distingue una corrección de una página que falta

    left significa que ambos rastreos obtuvieron la URL y la incidencia ya no está. disappeared significa que la URL no se volvió a comprobar, así que no prueba nada. Usa verify-fixes para obtener un veredicto sobre incidencias concretas.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
BROKEN_PAGE_4XXUna página devuelve un 4xx. La diferencia muestra si entró (rotura nueva) o salió (corregida en una URL que obtuvieron ambos rastreos).CriticalFilas de incidencia antes y después para la misma URL
SERVER_ERROR_5XXUna página devuelve un 5xx. Entre los dos rastreos se aplica la misma lógica de entered, left o disappeared.CriticalFilas de incidencia antes y después para la misma URL
TITLE_MISSINGFalta el elemento title en una página. Una regresión aparece como fila entered y una corrección como fila left.CriticalFilas de incidencia antes y después para la misma URL
REDIRECT_CHAINUna cadena de redirecciones tiene dos o más saltos. Sirve tras una migración para confirmar que no se añadieron cadenas.ImportantFilas de incidencia antes y después para la misma URL
CANONICAL_MISSINGUna página indexable no tiene URL canonical. Detecta etiquetas canonical perdidas al publicar una plantilla.ImportantFilas de incidencia antes y después para la misma URL
URL_NOT_IN_SITEMAPUna página indexable falta en el sitemap. Muestra si el sitemap se actualizó con la publicación.TipFilas de incidencia antes y después para la misma URL

Un solo comando

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

Primero, instala SpiderHead: guía de instalación. Cada comando también funciona como herramienta MCP para agentes de IA.

Qué necesitas

  • Dos archivos audit.json guardados o dos archivos SQLite scan.v1 (--before, --after)
  • Opcional: un archivo url-correspondence.v1 para una migración
  • Una carpeta de salida nueva (--out-dir) para auditorías grandes

Límites

  • Una incidencia que desaparece no es una corrección. Usa verify-fixes para obtener un veredicto sobre incidencias concretas.
  • Una comprobación no medida o saltada no puede demostrar una corrección, aunque su incidencia haya salido.
  • No hay coincidencia de URL más allá de los pares que declaras.
  • Una carpeta de salida que ya existe se rechaza; nunca se sobrescribe.

Preguntas

¿compare-crawls vuelve a rastrear el sitio?
No. Lee dos archivos de auditoría o escaneo guardados y no hace ninguna petición. verify-fixes es el comando que vuelve a pedir las URL seleccionadas.
¿Puedo comparar un rastreo nativo con una exportación de Screaming Frog?
Solo con un alcance y una configuración compatibles. Los rastreos nativos y Screaming Frog pueden encontrar conjuntos de URL distintos. Si la configuración de rastreo registrada difiere, la comparación se rechaza salvo que pases --force.
Una página desapareció del segundo rastreo. ¿Está corregida?
No se sabe. Una incidencia que desapareció significa que la página no se volvió a comprobar. Solo left significa que ambos rastreos obtuvieron la URL y la incidencia ya no está.
¿Y los sitios grandes?
Las auditorías de más de 10 000 páginas o incidencias necesitan un --out-dir explícito. La salida es una carpeta nueva compare.v2 con archivos NDJSON y un manifiesto. Añade --compression gzip para reducir el tamaño de los archivos.
¿Puede asociar URL antiguas con nuevas tras una migración?
Solo con un archivo url-correspondence.v1 que liste pares de origen y ruta (--correspondence). No adivina pares a partir de títulos ni de contenido.
¿Qué escribe en disco?
Las comparaciones pequeñas se devuelven en línea. Con --out-dir escribe una carpeta nueva con el manifiesto y un archivo por flujo. No se envía nada a ningún lugar.

Pruébalo en tu propio sitio