Réglages des cookies

Les cookies nécessaires gardent le site fonctionnel. L'analytics montre quelles pages sont utiles. Vous pouvez changer votre choix à tout moment depuis le pied de page.

Politique de cookies — le détail : catégories de cookies, stockage de votre choix dans le navigateur et retrait du consentement.

Nécessaires

Fonctions de base du site et votre choix de consentement. Toujours actifs.

Mesure d'audience

Aide à comprendre comment le site est utilisé. Chargé uniquement avec votre accord.

GitHubTélécharger le ZIP

Validateur de données structurées Schema.org

Validez le JSON-LD, les Microdata et le RDFa avec le vocabulaire Schema.org embarqué et les règles locales de Google pour les résultats enrichis, puis rédigez du nouveau JSON-LD avec schema-build.

Voir sur GitHubDémarrage rapide

Ce qu'elle fait

  • Application de bureau SpiderHead : l'onglet « Schema » de l'URL, qui signale les blocs JSON-LD détectés et analysés.
  • SpiderHead dans le terminal : seohead schema-check

Deux niveaux de validation

Le premier niveau vérifie que le balisage est du Schema.org valide : le type existe, la propriété est autorisée sur ce type, les propriétés héritées comptent et la valeur correspond au type attendu. Le second niveau contrôle les conditions visibles localement pour les résultats enrichis de Google, comme les propriétés obligatoires. Réussir le second niveau ne garantit pas que Google affichera un résultat enrichi.

  • Vocabulaire Schema.org embarqué, utilisable hors ligne
  • Propriétés héritées prises en compte : un author sur un Article ne produit pas une fausse erreur
  • Propriétés obligatoires, et propriétés dont une seule est requise, pour les types de résultats enrichis
  • Erreurs d'analyse signalées lorsqu'un bloc JSON-LD n'est pas du JSON valide

Le balisage comme graphe

Les entités se relient par des références @id. Le contrôle indique quelles entités portent un @id, lesquelles sont liées, lesquelles sont isolées et si une référence pointe vers un @id inexistant. Une entité isolée est un constat utile, car les moteurs de recherche ne peuvent pas la rattacher au reste de la page.

  • Entités sans @id ou sans lien vers le reste de la page
  • Références à un @id inexistant
  • Balisage lu en JSON-LD, Microdata et RDFa

Construction

schema-build rédige un @graph connecté pour le type de page, en n'utilisant que les faits visibles sur la page. Il montre les signaux utilisés et son degré de certitude sur le type. Vous définissez vous-même le type avec --type lorsque la déduction est faible, et vous relisez le brouillon avant sa mise en ligne.

  • Faits repris de la page uniquement
  • Déduction du type avec signaux et niveau de confiance
  • --type pour remplacer la déduction
  • Champs recommandés manquants listés

Trois étapes, un seul scan enregistré

  1. Valider avec le vocabulaire Schema.org

    schema-check lit les données structurées de la page et teste chaque type et chaque propriété avec le vocabulaire Schema.org embarqué.

  2. Contrôler le balisage comme un graphe

    Il indique quelles entités portent un @id, lesquelles sont liées, lesquelles sont isolées, et si une référence @id mène à un @id inexistant.

  3. Construire le balisage manquant

    schema-build propose un @graph connecté, en n'utilisant que les faits visibles sur la page, et liste les champs recommandés qui manquent encore.

Contrôles de cette fonctionnalité

ContrôleSignificationGravitéPreuve
SCHEMA_VALIDATION_ERRORLes données structurées de la page comportent des erreurs de validation par rapport au vocabulaire Schema.orgImportantNombre d'erreurs de validation par page
STRUCTURED_DATA_PARSE_ERRORUn bloc JSON-LD est présent mais n'est pas du JSON valide, et les moteurs de recherche l'ignorentImportantBlocs trouvés et blocs analysés
STRUCTURED_DATA_MISSINGLa page ne contient aucun balisage Schema.orgTipPage sans aucun bloc de données structurées
Aussi dans le registre des contrôles
STRUCTURED_DATA_SCHEMA_ERRORSTRUCTURED_DATA_SCHEMA_WARNINGSTRUCTURED_DATA_RICH_RESULT_REQUIRED_MISSING

Une seule commande

bash
seohead schema-check --url https://example.com/product

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

Ce qu'il vous faut

  • Une URL de page, ou le HTML lui-même (argument html) pour un contrôle hors ligne
  • Un nom de type pour schema-build quand la déduction est faible
  • Aucune clé d'API

Limites

  • Un contrôle statique ne peut pas dire si Google affichera réellement un résultat enrichi.
  • Il ne voit que le HTML qu'on lui fournit : le balisage injecté par JavaScript passe inaperçu, sauf si le HTML a d'abord été rendu.
  • Le RDFa, la taille du HTML et celle du graphe sont bornés ; atteindre une limite donne un résultat partiel explicite.
  • schema-build rédige du balisage, il ne le publie pas.

Questions

Quelle commande faut-il lancer ?
seohead schema-check --url https://example.com/product. Pour vérifier le balisage hors ligne, passez le HTML lui-même dans l'argument html, par exemple avec --input et un objet JSON.
L'outil vérifie-t-il aussi l'éligibilité aux résultats enrichis ?
Oui, en local. Le premier niveau repose sur le vocabulaire Schema.org : il vérifie si un type existe, si une propriété est autorisée sur ce type et si le type de valeur correspond. Le second niveau vérifie les propriétés obligatoires pour chaque type de résultat enrichi de Google pour lequel il dispose de règles. Il ne peut pas savoir si Google affichera le résultat.
Quels formats de balisage sont lus ?
Le JSON-LD, les Microdata et le RDFa. Un bloc JSON-LD qui ne s'analyse pas est signalé comme erreur d'analyse, car les moteurs de recherche l'ignorent.
schema-build va-t-il inventer des faits pour ma page ?
Non. Il construit le graphe à partir des faits visibles sur la page. Il montre les signaux et son niveau de confiance. Si la déduction du type est faible, définissez le type vous-même avec --type.
Modifie-t-il mon site ?
Non. Les deux commandes se contentent de lire la page. Le JSON-LD rédigé est une suggestion que vous relisez et déployez vous-même.
Fonctionne-t-il aussi dans un crawl ?
Oui. Un crawl enregistre des constats de données structurées par page : balisage manquant, erreurs d'analyse, erreurs de schéma et propriétés obligatoires des résultats enrichis manquantes.

Pour aller plus loin

Du blog et du glossaire

Schema.org JSON-LD : les données structurées pour la recherche GoogleBlogSchema.orgGlossaireJSON-LD : données structurées exprimées en JSON liéGlossaireDonnées structuréesGlossaire

Autres dans ce groupe · Audit

Audit SEO techniqueFonctionnalitéContrôle des redirections : chaînes, boucles et 302FonctionnalitéVérificateur de liens cassés avec source et emplacementFonctionnalitéContrôle des balises canonicalFonctionnalitéContrôle hreflangFonctionnalitéContrôle des balises title et meta descriptionFonctionnalitéContrôle de la structure des titresFonctionnalitéContrôle des contenus dupliqués et pauvresFonctionnalitéContrôle SEO des images et optimisationFonctionnalitéAudit du maillage interne et de la profondeur de crawlFonctionnalitéContrôle du poids des pages et de la vitesseFonctionnalitéContrôle HTTPS et des en-têtes de sécuritéFonctionnalitéVisibilité dans la recherche IA (GEO/AEO)Fonctionnalité

Essayez-le sur votre site

Télécharger le ZIPToutes les fonctionnalités