Analizador de exportaciones de Screaming Frog

Indica a SpiderHead una carpeta con exportaciones CSV o XLSX de Screaming Frog y obtén una auditoría y una lista de tareas priorizada. La ejecución por defecto es sin conexión: no hace falta tener instalado Screaming Frog, ni licencia, ni enviar ninguna petición al sitio.

Qué hace

Dos modos

El modo B analiza exportaciones que ya has hecho en Screaming Frog. Lee archivos de tu disco y no necesita licencia. El modo A controla una CLI de Screaming Frog instalada por separado y con licencia: deja que rastree y luego analiza el resultado.

  • Modo B: sf run con --exports-dir, totalmente sin conexión.
  • Modo A: --crawl URL, --crawl-list FILE o --load-crawl FILE.seospider, con tu propia licencia de Screaming Frog.
  • sf doctor comprueba la configuración local antes de empezar.

Qué obtienes

La carpeta del informe contiene audit.json y audit.md. Con --tasks también incluye tasks.json y tasks.md, un backlog priorizado. Cada tarea enumera los pasos de reproducción, la posición del enlace en la página y la corrección sugerida.

  • --format json,md elige los formatos del informe.
  • Una comprobación cuya exportación falta se marca como omitida con su motivo, nunca como superada.
  • --fail-on critical o warning establece un código de salida distinto de cero para CI.

Añade datos de búsqueda y tráfico

Con --project DIR, sf run cruza con las páginas auditadas el último historial completo de 28 días de Search Console, GA4 y Metrika guardado en ese proyecto. Mientras lo hace, no contacta con ningún proveedor. Un --gsc-inspect separado, activado de forma explícita, lee el estado de indexación que Google da a una muestra de hasta 50 URL.

  • Los hallazgos de los proveedores conservan su origen en audit.json y audit.md.
  • Las vinculaciones que faltan y las lecturas con límite se quedan como no disponibles o parciales.
  • Los hallazgos negativos, como las páginas huérfanas, requieren una cobertura completa del proveedor y un rastreo completo.

Tres pasos, un análisis guardado

  1. Indica tus exportaciones

    Indica una carpeta con exportaciones CSV o XLSX de Screaming Frog. El análisis se ejecuta sin conexión y no envía peticiones al sitio.

  2. Ejecuta el registro de comprobaciones

    El mismo registro puntúa todas las exportaciones. Una comprobación sin datos se marca como omitida con su motivo, nunca como superada.

  3. Obtén un backlog priorizado

    audit.json, audit.md y tasks.md/tasks.json enumeran cada incidencia con los pasos de reproducción, la posición del enlace y la corrección.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
BROKEN_PAGE_4XXLa página devuelve una respuesta 4xxCriticalExportación de Response Codes 4xx
BROKEN_INTERNAL_LINKUn enlace interno apunta a una URL 4xxCriticalExportación de Inlinks: página de origen y posición del enlace
REDIRECT_LOOPLa cadena de redirecciones vuelve a una URL que ya visitóCriticalInforme Redirect Chains
TITLE_MISSINGLa página no tiene elemento titleCriticalDerivado de los datos de títulos de página
REDIRECT_CHAINDos o más saltos de redirección antes de la URL finalImportantInforme Redirect Chains
DESC_DUPLICATELa misma meta descripción en más de una páginaImportantDerivado de los datos de meta descripción
TITLE_TOO_LONGEl título supera el umbral de longitud configuradoTipDerivado de los datos de títulos de página

Un solo comando

bash
seohead sf run --exports-dir ./exports --out ./report --tasks

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

Qué necesitas

  • Una carpeta con exportaciones CSV o XLSX de Screaming Frog (--exports-dir)
  • Opcional: un config.json con los umbrales (--config)
  • Solo modo A: una CLI de Screaming Frog con licencia y una URL de inicio, una lista de URL o un archivo .seospider guardado

Límites

  • La auditoría solo ve lo que contienen las exportaciones. Una comprobación sin su exportación se omite.
  • El modo A necesita una licencia de Screaming Frog que SpiderHead no proporciona ni incluye.
  • Las comprobaciones de red de los datos de sitemap y robots solo se hacen si añades --live-recheck.
  • Las correcciones sugeridas no se aplican a tu sitio.

Preguntas

¿Necesito tener instalado Screaming Frog para usar esto?
Para el análisis, no. El modo B lee exportaciones que ya has hecho en Screaming Frog y no envía peticiones al sitio. Solo necesitas Screaming Frog y una licencia para el modo A, en el que SpiderHead controla la CLI de Screaming Frog para rastrear. SpiderHead no necesita clave ni cuenta.
¿Qué pasa con una comprobación que no tiene datos?
Se marca como omitida con el motivo. Nunca se informa como superada, así que 0 incidencias siempre significa que la comprobación se ejecutó.
¿Cambia algo en mi sitio o en mis archivos?
No. Lee las exportaciones y escribe los informes en la carpeta de salida que indiques. Las correcciones sugeridas las aplicas tú.
¿Cuál es la diferencia entre audit.md y tasks.md?
audit.md enumera las incidencias. tasks.md es el backlog priorizado, con pasos de reproducción, posiciones de enlace y una corrección para cada incidencia. Para obtenerlo, añade --tasks.
¿Puedo usarlo en CI?
Sí. Añade --fail-on critical (o warning) y el comando devuelve un código de salida distinto de cero cuando aparece esa gravedad.
¿Puedo analizar exportaciones de otro rastreador?
No con sf run, que espera exportaciones de Screaming Frog. Para otras herramientas, crawl-import lee un paquete CSV que asignas con un manifiesto. Produce un documento de rastreo de terceros independiente, no una auditoría.

Pruébalo en tu propio sitio