Mise en œuvre des données structurées Schema.org — Compétence de workflow complet
Cette compétence fournit une méthodologie de bout en bout pour analyser des sites web, concevoir un balisage schema.org et produire des tickets prêts pour les développeurs. Elle a été affinée lors de projets réels de mise en œuvre de données structurées sur des sites web multilingues et multirégionaux.
La méthodologie est agnostique en termes de client. Elle fonctionne pour tout site web dont l'objectif est une couverture complète de schema.org avec un transfert aux développeurs via un outil de gestion de projet (JIRA, Wrike ou similaire).
Licence : Cette compétence est publiée sous la licence Creative Commons Attribution 4.0 International (CC BY 4.0). Vous êtes libre de partager et d'adapter cette compétence à toute fin, à condition d'accorder le crédit approprié à l'auteur original.
Audits associés : la phase 5 de cette compétence vérifie la sortie en direct par rapport aux spécifications conçues lors de la phase 2. Lorsque la tâche consiste plutôt à vérifier un correctif signalé entre les locales (« corrigé pour toutes les langues », « déployé partout »), exécutez un audit de validation JSON-LD, avec les disciplines de vérification des affirmations que cette compétence ne couvre pas : la barrière de vidage du cache, l'énumération de la population à partir de l'index du sitemap / de l'ensemble hreflang en direct, et le contrôle positif. La partie audit du travail sur le fil d'Ariane est un audit de navigation par fil d'Ariane ; cette compétence gère sa partie ticket.
Comment fonctionne cette compétence
Il s'agit d'une compétence de projet, généralement réalisée en 1 à 3 heures réparties sur 1 à 2 sessions pour la plupart des sites web. Les sites multilingues complexes avec de nombreux types de pages peuvent prendre plus de temps. La compétence définit cinq phases de livraison séquentielles : Phase 0 (Configuration), Phase 1 (Découverte), Phase 2 (Conception du schéma), Phase 3 (Création des tickets) et Phase 4 (Régénération et livraison) — suivies de deux phases post-déploiement qui s'exécutent une fois que le développeur a livré : Phase 5 (Vérification post-déploiement) et Phase 6 (Mesure de l'impact). Claude doit identifier la phase dans laquelle se trouve l'utilisateur et le guider à travers celle-ci.
L'utilisateur fournit : Contexte du projet, retours sur l'analyse et les ébauches de tickets, règles spécifiques au projet, résolution des questions en suspens. Claude fournit : Découverte des types de pages, analyse HTML, conception du schéma, ébauches de tickets (parent + enfant) et un ensemble final régénéré de tickets.
Note de terminologie : Cette compétence utilise « ticket » comme terme générique pour le livrable destiné aux développeurs. Le format réel dépend de la plateforme de gestion de projet choisie lors de la phase 0 (tickets JIRA, tâches Wrike, etc.).
Fichiers de référence — chargement à la demande
Les phases 1 à 6 se trouvent dans des fichiers de référence, un fichier par phase. Chaque pointeur nomme son déclencheur. Ces chargements sont des étapes obligatoires : lorsqu'une phase commence, chargez son fichier avant d'effectuer le travail — n'improvisez jamais une phase à partir de ce fichier central. Si vous remarquez qu'une phase a été traitée sans que son fichier soit chargé, indiquez-le, chargez-le et revérifiez le travail effectué jusqu'à présent par rapport à celui-ci.
references/discovery.md— Phase 1 : catalogue des types de pages, tri, vérification des consignes Google, analyse par type de page (schéma existant dans les trois formats, tri conditionnel du schéma, livraison par locale), sauvegarde des données réelles, consolidation, classification. À charger avant de créer le catalogue de types de pages et avant d'analyser le HTML d'un type de page.references/schema-design.md— Phase 2, sections 2.1–2.7 : schéma global et spécifique à la page, références croisées@id, dépréciation vs suppression, dispositions de migration de format, règles de sélection des propriétés, valeurs de propriétés multilingues, vérification des hypothèses, règles du projet. À charger avant de choisir les types ou propriétés de schéma pour tout type de page.references/ticket-writing.md— Phase 3 : pré-vérification, le modèle de ticket, directives pour les sous-agents, les règles numérotées de rédaction de tickets (1–46), le ticket parent, la liste de contrôle pré-livraison, le workflow de feedback, et les Décisions de schéma courantes (§3.7). À charger avant de rédiger, réviser ou vérifier un ticket, avant de préparer un sous-agent pour les tickets, et lorsqu'une décision du §3.7 survient lors de la conception.references/delivery.md— Phase 4 : plan de régénération, formatage spécifique à la plateforme (Wrike, JIRA, éditeurs de texte enrichi, outils protégés par WAF), l'arbre de décision du format de livraison, la passe éditoriale, les vérifications de cohérence entre les tickets, le packaging, la feuille de calcul XLS de Wrike et le collage HTML. À charger avant la régénération finale et avant de formater les tickets pour l'outil cible.references/post-deployment-verification.md— Phase 5 : les déclencheurs de balayage de la population complète, la liste de contrôle pré-vol de la phase 5, les techniques de vérification et de récupération multilingues, les quatre catégories de constats et le squelette du rapport, les commentaires de suivi, la vérification des URL et des valeurs sources, la réconciliation et le diagnostic des erreurs GSC, les faux positifs de récupération unique, les audits de couverture à partir des exports de crawl. À charger avant de vérifier tout schéma déployé, avant de confirmer un ticket comme terminé, avant de répondre à un écart signalé par le client, et avant de diagnostiquer une erreur de données structurées dans la Search Console.references/measuring-impact.md— Phase 6 : la répartition de l'apparence dans la recherche, la déclaration d'attentes, les canaux mesurables, la conservation des données. À charger lorsque le client demande ce que les données structurées ont apporté, avant de tirer des chiffres d'impact.
Les numéros de section (§1.2, §5.4) et les numéros de règle (Règle 35, anti-patron 21) sont les mêmes dans chaque fichier, donc une référence croisée se résout via cette carte.
Phase 0 : Configuration et outils
Objectif : Évaluer les outils et accès disponibles, mettre en place le workflow le plus efficace et recueillir les préférences du projet avant de commencer le travail sur le contenu.
0.1 Évaluer les outils disponibles
Avant de commencer le travail d'analyse, déterminez les capacités disponibles :
- Accès au navigateur (par exemple, Claude dans une extension Chrome, outils de navigateur Cowork) — Permet à Claude de naviguer directement sur les pages, de capturer le HTML rendu, d'extraire des données et de vérifier les faits de manière autonome. C'est le workflow le plus efficace.
- Recherche web — Permet à Claude de cartographier la structure du site, de trouver les sitemaps et de découvrir les types de pages sans accès au navigateur.
- Accès au système de fichiers — Permet de sauvegarder les documents d'analyse et les ébauches de tickets de manière incrémentielle.
- Accès direct au site — Certains sites bloquent l'accès automatisé (erreurs 403). Si la récupération web échoue, l'accès au navigateur ou le téléchargement manuel du HTML sont des alternatives.
0.2 Guider l'utilisateur vers l'accès au navigateur
L'analyse assistée par navigateur est le workflow recommandé principal pour cette compétence. Elle permet à Claude de :
- Découvrir et cartographier les types de pages de manière autonome
- Capturer le HTML rendu de n'importe quelle page sans copier-coller manuel
- Extraire les signaux de détection, les sources de données et les structures de modèles en quelques minutes
- Vérifier les faits (modèles d'URL, variantes linguistiques, disponibilité des champs) avant de rédiger les tickets
Si l'accès au navigateur n'est pas encore disponible, expliquez les avantages et guidez l'utilisateur dans la configuration. Le rôle de l'utilisateur passe de « collecteur de HTML » (fastidieux, peu de valeur) à « relecteur et décideur » (grande valeur, là où son expertise du domaine compte).
Si l'accès au navigateur est indisponible ou que le site bloque complètement la navigation automatisée, utilisez le workflow manuel décrit dans la phase 1.2.
Conscience des coûts : L'accès au navigateur permet l'analyse la plus approfondie, mais il est considérablement plus coûteux en utilisation de tokens — les appels aux outils Chrome renvoient de gros volumes de données qui augmentent de manière quadratique à mesure que la conversation s'allonge. Réservez les workflows de navigateur pour les phases de découverte initiale et de vérification où l'inspection en temps réel de la page apporte une réelle valeur ajoutée. Pour les tâches où l'inventaire des types de pages est déjà établi (par exemple, la rédaction de tickets à partir d'un audit terminé), les workflows sans navigateur sont tout aussi efficaces et beaucoup moins chers. Lorsque le navigateur est utilisé, privilégiez les appels ciblés (get_page_text, find, javascript_tool pour une extraction chirurgicale) plutôt que les appels lourds (read_page pour le DOM complet, read_network_requests pour le trafic complet).
0.3 Recueillir les préférences du projet
Avant de commencer le travail sur le contenu, demandez à l'utilisateur :
- Plateforme de gestion de projet — « Dans quel système ces tickets seront-ils créés ? (JIRA, Wrike, Asana, etc.) » Cela détermine la terminologie (tickets vs tâches vs éléments), les contraintes de formatage (par exemple, Wrike ne rend pas les blocs de code imbriqués dans les éléments de liste — voir §4.4 Passe de formatage spécifique à la plateforme dans
references/delivery.md) et la convention de nommage des fichiers livrables. - Structure du ticket — « Votre organisation a-t-elle une structure de ticket ou un modèle établi pour les tâches des développeurs ? Si oui, veuillez partager un modèle ou des directives de création de tickets. J'adapterai les tickets de schéma pour qu'ils correspondent aux conventions de votre équipe. » Si aucun modèle n'existe, utilisez la structure par défaut de la compétence.
- Salutation et ton — par exemple, « Bonjour l'équipe, » avec un ton pair à pair, ou formel.
- Règles spécifiques au projet — Contraintes de confidentialité, terminologie, règles de marque, etc. (Ils peuvent également être recueillis lors de la phase 2.)
Phase 1 : Découverte et catalogue des types de pages
Objectif : Créer un inventaire complet de tous les types de pages du site web, avec les signaux de détection, la couverture de schéma existante et les données réelles sauvegardées pour les exemples de code des tickets.
Chargez references/discovery.md avant de commencer cette phase. Il contient toute la phase :
- 1.1 Rassembler la liste des types de pages
- 1.1b Évaluation des priorités / Triage
- 1.1c Vérifier les consignes actuelles de Google
- 1.2 Analyser chaque type de page
- 1.3 Sauvegarder les données réelles pour les exemples de code des tickets
- 1.4 Documenter les constats
- 1.5 Identifier les opportunités de consolidation
- 1.6 Classifier chaque type de page
Phase 2 : Conception du schéma
Objectif : Décider quels types et propriétés de schéma utiliser pour chaque type de page, et comment les schémas sont liés les uns aux autres sur l'ensemble du site.
Chargez references/schema-design.md avant de choisir les types ou propriétés de schéma. Il contient les sections 2.1–2.7 :
- 2.1 Concevoir le schéma global/partagé
- 2.2 Concevoir les schémas spécifiques aux pages
- 2.3 Concevoir les références croisées
- 2.4 Dépréciation vs suppression
- 2.4b Tickets de migration de format — Disposition du format existant
- 2.5 Appliquer les règles de sélection des propriétés
- 2.5b Valeurs de propriétés multilingues
- 2.6 Vérifier les hypothèses avant de finaliser
- 2.7 Règles spécifiques au projet
Le §2.8 reste dans ce fichier central car chaque ticket et chaque vérification l'applique :
2.8 Exigences techniques universelles
Elles s'appliquent à chaque projet :
- Le schéma doit être rendu côté serveur — Présent dans le HTML initial renvoyé par le serveur, pas injecté dynamiquement par JavaScript. Il s'agit d'une bonne pratique SEO, pas d'une préférence spécifique au projet.
- Format JSON-LD — Toujours implémenter comme
<script type="application/ld+json">dans la section<head>. - Balises script séparées — Chaque type de schéma a sa propre balise
<script>. - Format @context — Toujours utiliser
https://schema.org(sans barre oblique finale). Appliquez cela de manière cohérente dans tous les tickets. - Émettre via un sérialiseur JSON réel — Ne jamais assembler manuellement du JSON-LD par concaténation de chaînes / modélisation de valeurs CMS. Le JSON-LD fabriqué à la main est sujet à toute une classe de pannes, plus large que la simple présence de caractères non échappés : guillemets non échappés dans les valeurs interpolées, substitution de guillemets courbes / guillemets simples (U+201C/U+201D/U+201E là où un
"droit doit se trouver), et erreurs structurelles telles que des accolades parasites ou dupliquées (par exemple, une valeur@identourée d'un jeu supplémentaire d'accolades). Un sérialiseur élimine toute la classe ; les règles d'échappement seules ne suffisent pas. - Décoder les entités HTML dans les valeurs textuelles — Une propriété textuelle porte le caractère décodé (
',&), jamais l'entité HTML (',&) qu'un champ CMS ou la source de la page stocke. Lorsque le champ source contient du texte encodé, le modèle le décode avant de sérialiser. - Dates en ISO 8601, date-heure avec un décalage horaire — Chaque propriété de date et de date-heure (
datePublished,dateModified,startDate,validFrom…) utilise ISO 8601 ; une date-heure porte son décalage (YYYY-MM-DDThh:mm:ss+hh:mm), jamais une heure locale brute ou un format d'affichage copié de la page.
Phase 3 : Création des tickets
Objectif : Produire des tickets prêts pour les développeurs — un ticket parent pour les schémas partagés, un ticket enfant par type de page (ou groupe consolidé).
Chargez references/ticket-writing.md avant de rédiger, réviser ou vérifier un ticket. Il contient toute la phase :
- 3.1 Vérification pré-vol
- 3.2 Modèle de structure du ticket
- 3.2b Directives d'utilisation des sous-agents
- 3.3 Règles de rédaction des tickets
- 3.4 Rédaction du ticket parent
- 3.5 Liste de contrôle pré-vol (avant la livraison)
- 3.6 Workflow de feedback et d'itération
- 3.7 Décisions de schéma courantes
Phase 4 : Régénération finale et livraison
Objectif : Régénérer tous les tickets en une seule passe, en appliquant chaque règle, décision et correction accumulée pour assurer la cohérence entre les tickets.
Chargez references/delivery.md avant la passe de régénération finale. Il contient toute la phase :
- 4.1 Élaborer un plan de régénération
- 4.2 Résoudre d'abord toutes les questions en suspens
- 4.3 Régénérer en séquence
- 4.4 Passe de formatage spécifique à la plateforme
- Arbre de décision du format de livraison
- 4.5 Passe éditoriale
- 4.6 Vérifications de cohérence entre les tickets
- 4.7 Conditionner pour la livraison
- 4.8 Livraison Wrike — Structure XLS + Collage HTML
Phase 5 : Vérification post-déploiement
Objectif : Une fois que le développeur a déployé le schéma, confirmer que la sortie en direct correspond aux spécifications — avec une attention particulière à la couverture multilingue et à l'exactitude des types numériques.
Chargez references/post-deployment-verification.md avant de vérifier le schéma déployé, de confirmer un ticket comme terminé, ou de diagnostiquer une erreur de la Search Console. Il contient toute la phase :
- Préambule de la phase — note de périmètre (la vérification des correctifs signalés va à un audit de validation JSON-LD), les deux déclencheurs d'un balayage de population complète, et l'inventaire du modèle de ticket à l'échelle du site
- Liste de contrôle pré-vol de la phase 5 (avant d'envoyer le rapport)
- 5.1 Modèle de vérification multilingue
- 5.2 Catégories de constats d'audit
- 5.3 Quand rouvrir les spécifications
- 5.4 Vérification des URL — Procédure de pré-publication
- 5.5 Vérification des valeurs sources — Les audits miroirs ne suffisent pas
- 5.6 Réconcilier les comptes d'erreurs GSC avec un crawl en direct
- 5.7 Faux positifs de récupération unique sur les champs rendus dynamiquement
- 5.8 Diagnostiquer « Données structurées non analysables / Type de valeur incorrect » de GSC sur des URL de même type de page
- 5.9 Audit de couverture à partir des exports de crawl
Phase 6 : Mesure de l'impact
Objectif : Mesurer l'impact des données structurées mises en œuvre sur l'apparence dans la recherche et les indicateurs de performance clés, en fournissant une déclaration claire des attentes et un suivi des canaux mesurables avant de tirer des conclusions.
Chargez references/measuring-impact.md avant de commencer cette phase. Il contient toute la phase :
- 6.1 Répartition de l'apparence dans la recherche
- 6.2 Déclaration d'attentes
- 6.3 Canaux mesurables
- 6.4 Conservation des données