Configuración de cookies

Las cookies necesarias mantienen el sitio funcionando. La analítica muestra qué páginas son útiles. Puedes cambiar tu elección en cualquier momento desde el pie de página.

Política de cookies de este sitio — todos los detalles: categorías de cookies, cómo guardamos tu elección en el navegador y cómo retirar el consentimiento.

Necesarias

Funciones básicas del sitio y tu elección de consentimiento. Siempre activas.

Analítica

Ayuda a entender cómo se usa el sitio. Se carga solo si lo permites.

GitHubDescargar ZIP

Auditoría técnica de SEO

Un único registro de comprobaciones impulsa cada auditoría, tanto si las pruebas vienen de exportaciones de Screaming Frog como de un rastreo de SpiderHead. La gravedad, la fuente de la prueba y la corrección salen del mismo registro que lee el motor de reglas, así que una incidencia nunca afirma más de lo que el motor puede demostrar.

Ver en GitHubInicio rápido

Qué hace

  • App de escritorio de SpiderHead: la pantalla Issues, con las incidencias agrupadas por gravedad y los grupos de comprobaciones más grandes.
  • SpiderHead en la terminal: seohead audit-summary

Pruebas, no suposiciones

Cada incidencia indica la URL, lo que se observó y una corrección. En las incidencias de enlaces, también muestra dónde está el enlace en la página. Una comprobación sin datos sobre los que ejecutarse se informa como omitida, con el motivo, nunca como superada.

  • Niveles de gravedad: critical, warning y notice
  • Posición del enlace y XPath en las incidencias de enlaces (de las exportaciones Inlinks de Screaming Frog)
  • Cada incidencia incluye un texto de corrección del registro

Cobertura honesta

El informe cuenta cuántas comprobaciones pudieron ejecutarse con las pruebas que recibió. Cuando la cobertura está por debajo de la mitad, no se muestra la puntuación de salud. Una cobertura menor también marca la puntuación como no comparable con una ejecución que tuvo pruebas completas.

  • Las comprobaciones omitidas se listan con el dato que falta
  • Sin puntuación con pocas pruebas
  • Vuelve a ejecutar con más exportaciones para subir la cobertura

De las incidencias al backlog de tareas

Si añades --tasks, la auditoría también escribe tasks.json y tasks.md: una lista priorizada para desarrolladores, con la corrección junto a cada incidencia. La misma auditoría puede hacer fallar una compilación de CI cuando haya incidencias de la gravedad elegida.

  • Lista de tareas en JSON y Markdown
  • Falla si hay incidencias critical o warning, con un código de salida distinto de cero
  • Formatos de informe: json y md

Tres pasos, un análisis guardado

  1. Apunta a tus exportaciones

    Indica una carpeta con exportaciones CSV o XLSX de Screaming Frog. Cada comprobación lee el mismo registro, sea cual sea la forma en que se recogieron las pruebas.

  2. Ejecuta cada comprobación que permitan las pruebas

    Cada comprobación devuelve incidencias, sale limpia o se omite con un motivo cuando faltan los datos que necesita.

  3. Obtén las correcciones como lista de tareas

    Añade --tasks para obtener tasks.json y tasks.md, un backlog priorizado para desarrolladores, con la corrección junto a cada incidencia.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
BROKEN_PAGE_4XXLa página responde con un estado 4xxCriticalExportación Response Codes 4xx, con URL y estado
SERVER_ERROR_5XXLa página responde con un estado 5xxCriticalExportación Response Codes 5xx, con URL y estado
TITLE_MISSINGLa página no tiene elemento titleCriticalURL de la página
BROKEN_INTERNAL_LINKUn enlace interno apunta a una URL 4xxCriticalPágina de origen y posición del enlace, según la exportación de inlinks
H1_MISSINGLa página no tiene encabezado H1ImportantURL de la página
CANONICAL_MISSINGUna página indexable no tiene URL canónicaImportantURL de la página
THIN_CONTENTLa página tiene un recuento de palabras bajoImportantURL y recuento de palabras
HEADING_BEFORE_H1Hay encabezados antes del primer H1 de la páginaTipEsquema de encabezados de la 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, o una URL de inicio para un rastreo
  • La CLI de Screaming Frog con licencia, solo para los modos de rastreo de sf run
  • Ninguna clave de API para la auditoría sin conexión de las exportaciones

Límites

  • Las comprobaciones sin las pruebas que necesitan se omiten, no se adivinan
  • Si pueden ejecutarse pocas comprobaciones, la puntuación se retiene o se marca como no comparable
  • Para rastrear con Screaming Frog necesitas tu propia instalación con licencia
  • Las comprobaciones de páginas renderizadas necesitan un rastreo con renderizado, no exportaciones estáticas

Preguntas

¿Necesito una licencia de Screaming Frog?
No para leer exportaciones. sf run --exports-dir analiza sin conexión los archivos CSV o XLSX de Screaming Frog que ya tienes. Rastrear con la CLI de Screaming Frog (--crawl) necesita una instalación con licencia de Screaming Frog. crawl-site es el rastreador propio de SpiderHead y audita su resultado con las mismas comprobaciones.
¿Qué pasa cuando una comprobación no tiene datos sobre los que ejecutarse?
Se informa como omitida, con el motivo. Nunca se muestra como superada.
¿La auditoría cambia mi sitio?
No. Lee exportaciones o análisis guardados. Un rastreo envía solicitudes de solo lectura a la velocidad que tú configures; en los rastreos de Screaming Frog, --max-urls-per-second la fija, y de 1 a 2 solicitudes por segundo es un inicio prudente.
¿Puede un agente de IA ejecutar la auditoría?
Sí. La misma auditoría está disponible como herramientas MCP: sf_audit_run, sf_audit_issues, sf_audit_summary y sf_audit_tasks.
¿Puedo hacer fallar una compilación de CI por las incidencias?
Sí. --fail-on critical o --fail-on warning devuelve un código de salida distinto de cero cuando hay incidencias de esa gravedad. El valor por defecto es --fail-on none, así que una ejecución normal no falla por las incidencias.
¿Dónde se guardan los resultados?
En el directorio que indiques con --out, como informe local (json y md). No se sube nada.

Sigue explorando

Del blog y el glosario

Checklist de SEO para una web: más de 80 puntos para auditarBlogSEO on-page: guía completa de optimización de páginasBlogSEO (optimización para motores de búsqueda)GlosarioAuditoría de contenidoGlosario

Más de este grupo · Auditoría

Comprobador de redirecciones: cadenas, bucles y 302FunciónComprobador de enlaces rotos con origen y posiciónFunciónComprobador de etiquetas canonicalFunciónComprobador de hreflangFunciónValidador de datos estructurados y de schemaFunciónComprobador de títulos y meta descripcionesFunciónComprobador de estructura de encabezadosFunciónComprobador de contenido duplicado y pobreFunciónComprobador y optimizador de SEO de imágenesFunciónAuditoría de enlazado interno y profundidad de clicsFunciónComprobaciones de peso y velocidad de la páginaFunciónComprobación de HTTPS y cabeceras de seguridadFunciónVisibilidad en la búsqueda con IA (GEO/AEO)Función

Pruébalo en tu propio sitio

Descargar ZIPTodas las funciones