Comprobador de estructura de encabezados

Revisa el esquema de encabezados de una página o de un rastreo: ausencia de H1 o varios H1, duplicados entre URL, niveles saltados, encabezados antes del primer H1 y encabezados que están en elementos de la página (cabecera, navegación, barra lateral o pie) en lugar de en el contenido.

Qué hace

Esquema en orden del DOM

Las comprobaciones de encabezados leen el documento analizado en orden, con el nivel, el texto y la región de página de cada encabezado. Así se ve un nivel saltado o un encabezado suelto en la navegación. Contar solo los elementos H1 no basta para detectar ninguno de los dos casos.

  • Nivel, texto y región de cada encabezado
  • Niveles saltados, como de H2 a H4
  • Encabezados antes del primer H1
  • Encabezados en la cabecera, la navegación, la barra lateral o el pie

Comprobaciones de H1

Una página debería tener un único H1 claro. Las comprobaciones informan de páginas sin H1, con varios, con un H1 que solo contiene el texto alternativo de una imagen o con un H1 demasiado largo. El mismo texto de H1 en varias URL se marca como duplicado, y un H2 que falta bajo un H1 existente es un aviso.

  • Sin H1, varios H1 y duplicados de H1 entre URL
  • H1 formado solo por texto alternativo de imagen
  • H2 ausente en una página que tiene H1

Corrige la plantilla una sola vez

Los encabezados que aparecen en la cabecera, la navegación, la barra lateral o el pie se agrupan por su texto repetido, con el número de páginas. Un solo cambio en la plantilla cierra la incidencia en todas las páginas que la comparten.

  • Agrupados por texto de encabezado repetido
  • Número de páginas por grupo
  • Reglas de región que puedes añadir para menús construidos con divs genéricos

Tres pasos, un análisis guardado

  1. Rastrea el sitio o analiza una página

    Un rastreo guarda el esquema de encabezados de cada página en orden del DOM. parse devuelve los niveles de encabezado y el esquema de una sola URL.

  2. Lee el orden, no solo los recuentos

    Cada encabezado conserva su nivel, su texto y su región de página, así que se ve un nivel saltado o un encabezado suelto en el menú.

  3. Corrige la plantilla una sola vez

    Los encabezados de la cabecera, la navegación, la barra lateral o el pie se agrupan por el texto repetido, con el número de páginas, para que una sola corrección cubra todas.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
H1_MISSINGLa página no tiene encabezado H1ImportantURL de la página, sin H1 en el documento analizado
H1_MULTIPLELa página tiene más de un H1ImportantURL de la página y los textos de H1 que lo provocaron
H1_DUPLICATEEl mismo texto de H1 aparece en varias URL dentro de una ejecuciónTipEl texto de H1 y las URL que lo comparten
HEADING_BEFORE_H1Uno o más encabezados aparecen antes del primer H1 en orden del DOMTipNúmero, niveles de encabezado y los primeros textos de encabezado antes del H1
HEADING_SKIPUn encabezado de contenido salta más de un nivel, por ejemplo de H2 a H4TipNiveles de origen y destino con los textos de encabezado, solo en la región de contenido
HEADING_IN_PAGE_CHROMEUn encabezado está en la cabecera, la navegación, la barra lateral o el pie, en lugar de en el contenidoTipRegión, nivel y texto, con el número de páginas que comparten los mismos encabezados de plantilla
También en el registro de comprobaciones
H1_TOO_LONGH1_ALT_TEXT_ONLYH2_MISSING

Un solo comando

bash
seohead parse --url https://example.com/

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

Qué necesitas

  • Una URL para parse, para ver el esquema
  • Un escaneo de crawl-site para las comprobaciones de esquema
  • Reglas link_position opcionales para marcado de menús personalizado

Límites

  • Las comprobaciones de esquema necesitan el orden del DOM, así que funcionan con un rastreo nativo, no con una exportación de Screaming Frog.
  • Sin un punto de referencia de contenido principal ni una regla que coincida, la región no se mide y la comprobación se omite en esa página.
  • El límite por defecto de crawl-site es de 200 URL.
  • Las comprobaciones miden la estructura, no si los encabezados se leen bien.

Preguntas

¿parse ejecuta las comprobaciones de encabezados?
No. parse devuelve los niveles de encabezado y el esquema de una página. Las comprobaciones se ejecutan en un rastreo: crawl-site guarda el esquema e informa de HEADING_BEFORE_H1, HEADING_IN_PAGE_CHROME y HEADING_SKIP. H1_MISSING, H1_MULTIPLE y H1_DUPLICATE también se ejecutan en un rastreo.
¿Por qué no puedo ver el orden de los encabezados desde una exportación de Screaming Frog?
Una exportación de Screaming Frog guarda los encabezados como un conjunto sin orden. No incluye el esquema, así que HEADING_BEFORE_H1, HEADING_IN_PAGE_CHROME y HEADING_SKIP se omiten por su nombre. Esas tres necesitan un rastreo nativo.
¿Por qué no se marcó un encabezado de mi menú, o se marcó como parte de la cabecera?
Las regiones salen del punto de referencia de contenido principal de la página: un elemento main, role=main, un article o un selector que configures. Sin eso, y sin una regla de posición que coincida, la región no se mide. Entonces la comprobación se omite en esa página y la ejecución lo indica. No se informa como correcta. Para menús construidos con divs genéricos, añade reglas en link_position.rules.
¿El comprobador cambia mi sitio?
No. Hace solicitudes de solo lectura y respeta robots.txt. El límite por defecto de crawl-site es de 200 URL, así que tú controlas el alcance.
¿Más de un H1 es siempre un error?
En el registro se informa como advertencia, porque un solo H1 expresa el tema de la página con más claridad. No es una regla que los buscadores apliquen, así que decídelo plantilla por plantilla.

Pruébalo en tu propio sitio