Contrôle de la structure des titres

Contrôlez le plan des titres d’une page ou d’un crawl : H1 absent ou multiple, doublons entre URL, niveaux sautés, titres avant le premier H1, et titres placés dans le gabarit plutôt que dans le contenu.

Ce qu'elle fait

Plan dans l’ordre du DOM

Les contrôles des titres lisent le document analysé dans l’ordre, avec le niveau, le texte et la zone de la page de chaque titre. Un niveau sauté ou un titre égaré dans la navigation devient ainsi visible. Compter seulement les éléments H1 ne permet de voir ni l’un ni l’autre.

  • Niveau, texte et zone pour chaque titre
  • Niveaux sautés, par exemple H2 puis H4
  • Titres placés avant le premier H1
  • Titres dans l’en-tête, la navigation, la barre latérale ou le pied de page

Contrôles des H1

Une page doit avoir un H1 clair et unique. Les contrôles signalent les pages sans H1, avec plusieurs H1, avec un H1 composé uniquement d’un texte alternatif d’image, ou avec un H1 trop long. Un même texte de H1 sur plusieurs URL est signalé comme doublon, et un H2 manquant sous un H1 existant donne lieu à une simple notification.

  • Absence de H1, H1 multiples et doublons de H1 entre URL
  • H1 constitué uniquement d’un texte alternatif d’image
  • H2 manquant sur une page qui possède un H1

Corriger le gabarit une seule fois

Les titres présents dans l’en-tête, la navigation, la barre latérale ou le pied de page sont regroupés par texte répété, avec le nombre de pages concernées. Une seule modification du gabarit suffit alors à lever le constat sur toutes les pages qui le partagent.

  • Regroupement par texte de titre répété
  • Nombre de pages par groupe
  • Règles de zone à ajouter pour les menus construits avec de simples div

Trois étapes, un seul scan enregistré

  1. Crawlez le site ou analysez une page

    Un crawl enregistre le plan de chaque page dans l’ordre du DOM. parse renvoie les niveaux de titres et le plan d’une seule URL.

  2. Lisez l’ordre, pas seulement les comptages

    Chaque titre conserve son niveau, son texte et sa zone dans la page : un niveau sauté ou un titre égaré dans le menu devient visible.

  3. Corrigez le gabarit une seule fois

    Les titres de l’en-tête, de la navigation, de la barre latérale ou du pied de page sont regroupés par texte répété, avec un nombre de pages. Une seule correction du gabarit couvre donc toutes les pages.

Contrôles de cette fonctionnalité

ContrôleSignificationGravitéPreuve
H1_MISSINGLa page n’a pas de titre H1ImportantURL de la page, sans H1 dans le document analysé
H1_MULTIPLELa page comporte plus d’un H1ImportantURL de la page et textes des H1 en cause
H1_DUPLICATELe même texte de H1 apparaît sur plusieurs URL dans une même exécutionTipTexte du H1 et URL qui le partagent
HEADING_BEFORE_H1Un ou plusieurs titres précèdent le premier H1 dans l’ordre du DOMTipNombre de titres, niveaux et premiers textes de titre avant le H1
HEADING_SKIPUn titre de contenu saute plus d’un niveau, par exemple de H2 à H4TipNiveaux de départ et d’arrivée avec les textes des titres, dans la zone de contenu uniquement
HEADING_IN_PAGE_CHROMEUn titre se trouve dans l’en-tête, la navigation, la barre latérale ou le pied de page, et non dans le contenuTipZone, niveau et texte, avec le nombre de pages qui partagent les mêmes titres de gabarit
Aussi dans le registre des contrôles
H1_TOO_LONGH1_ALT_TEXT_ONLYH2_MISSING

Une seule commande

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

Commencez par installer : guide d'installation. Chaque commande fonctionne aussi comme outil MCP pour les agents IA.

Ce qu'il vous faut

  • Une URL pour parse, afin de voir le plan
  • Un scan crawl-site pour les contrôles du plan
  • Des règles link_position facultatives pour les menus au balisage personnalisé

Limites

  • Les contrôles du plan exigent l’ordre du DOM : ils tournent donc sur un crawl natif, et non sur un export de Screaming Frog
  • Sans repère de contenu principal ni règle correspondante, la zone n’est pas mesurée et le contrôle est ignoré pour cette page
  • La limite par défaut de crawl-site est de 200 URL
  • Les contrôles vérifient la structure, et non la qualité rédactionnelle des titres

Questions

Est-ce que parse lance les contrôles des titres ?
Non. parse renvoie les niveaux de titres et le plan d’une seule page. Les contrôles s’exécutent dans un crawl : crawl-site enregistre le plan et signale HEADING_BEFORE_H1, HEADING_IN_PAGE_CHROME et HEADING_SKIP. H1_MISSING, H1_MULTIPLE et H1_DUPLICATE s’exécutent aussi dans un crawl.
Pourquoi l’ordre des titres n’apparaît-il pas dans un export de Screaming Frog ?
Un export de Screaming Frog contient les titres sous forme d’ensemble non ordonné. Il ne conserve aucun plan : HEADING_BEFORE_H1, HEADING_IN_PAGE_CHROME et HEADING_SKIP sont donc ignorés, par leur nom. Ces trois contrôles nécessitent un crawl natif.
Pourquoi un titre de mon menu n’a-t-il pas été signalé, ou a-t-il été classé comme gabarit ?
Les zones proviennent du repère de contenu principal de la page : un élément main, role=main, un article, ou un sélecteur que vous configurez. Sans repère, et sans règle de position correspondante, la zone n’est pas mesurée. Le contrôle est alors ignoré pour cette page, et l’exécution indique la raison. Le résultat n’est jamais présenté comme propre. Pour les menus construits avec de simples div, ajoutez des règles sous link_position.rules.
L’outil modifie-t-il mon site ?
Non. Il ne fait que des requêtes en lecture et respecte le robots.txt. La limite par défaut de crawl-site est de 200 URL, ce qui vous laisse maîtriser le périmètre.
Plus d’un H1 est-il toujours une erreur ?
Le registre le classe en avertissement, car un seul H1 énonce le sujet de la page le plus clairement. Ce n’est pas une règle imposée par les moteurs de recherche : décidez au cas par cas, template par template.