Docs

Comment ajouter des données structurées (JSON-LD) à mon site avec Claude Code ou Codex ?

Demandez à l'agent de générer le JSON-LD dans vos modèles de pages, à partir des mêmes données que celles affichées, avec seulement les types et les valeurs que le lecteur voit, rendu côté serveur. Écrivez cette règle dans CLAUDE.md ou AGENTS.md pour que chaque nouvelle page la suive. Testez ensuite l'URL publiée, pas le code, dans le Test des résultats enrichis de Google.

Données clés

Quels types de schéma demander à l'agent ?

Demandez le type qui correspond à ce que montre chaque page, et rien d'autre :

PageType de schémaPropriétés clés
Accueil ou à proposOrganization (ou LocalBusiness)name, url, logo, sameAs
Guide ou article de blogArticleheadline, author, datePublished, dateModified, publisher
Page produitProductname, offers avec le prix affiché sur la page
Page avec questions et réponses visiblesFAQPageSeulement les questions imprimées sur la page

Quel prompt donner à Claude Code ou Codex ?

Donnez-lui un jeu de règles unique, applicable à tous les modèles, avec l'interdiction d'inventer des valeurs :

Add JSON-LD structured data to this site.
- Build it in the page templates from the same data the page renders.
  Never hardcode a value the page does not show.
- Organization (name, url, logo, sameAs) on the home page only.
- Article on guides and blog posts: headline, author, datePublished,
  dateModified (the real last change), publisher = the Organization.
- Product, LocalBusiness or FAQPage only where that content is visible.
- If a value is unknown, leave the property out. Do not invent it.
- Render it on the server, in a <script type="application/ld+json">.
- List every page you changed and the types each one now carries.

Où mettre la règle pour que les nouvelles pages aient aussi du schéma ?

Dans le fichier d'instructions que l'agent charge seul. Claude Code lit ./CLAUDE.md ou ./.claude/CLAUDE.md au début de chaque session, et /init en crée une première version. Codex lit AGENTS.md à la racine du projet avant tout travail. Une règle courte y garde la page suivante cohérente avec la précédente.

Comment vérifier que l'agent n'a rien inventé ?

Testez l'URL publiée dans le Test des résultats enrichis, puis comparez chaque valeur avec la page que voit le lecteur. Un test par URL exécute le JavaScript de la page, ce que ne fait pas un code collé. Utilisez ensuite l'outil d'inspection d'URL de Search Console pour confirmer que Google a trouvé le balisage. Un test valide ne prouve que la syntaxe : c'est à vous de vérifier les valeurs.

Le schéma fera-t-il citer mon site par ChatGPT ou par l'IA de Google ?

Pas à lui seul. Google indique que les AI Overviews et le Mode IA n'exigent aucun schéma particulier, et il ne garantit pas de résultats enrichis pour un balisage valide. Un JSON-LD correct aide les moteurs à comprendre qui vous êtes et ce qu'est la page ; ce qui est cité reste la réponse écrite sur la page.

Étape par étape

  1. Listez vos types de pages. Accueil, à propos, guides, produits : un type de schéma pour chacun.
  2. Donnez le prompt à l'agent. Demandez-lui de construire le JSON-LD dans les modèles à partir des données propres à la page, sans valeur inventée.
  3. Enregistrez la règle. Ajoutez-la à CLAUDE.md ou AGENTS.md pour que les pages suivantes la suivent.
  4. Relisez le diff et déployez. Vérifiez que les valeurs viennent des données de la page, et non d'un texte en dur.
  5. Testez l'URL en ligne. Lancez le Test des résultats enrichis sur la page publiée, puis l'outil d'inspection d'URL dans Search Console.

Erreurs fréquentes

  • Laisser l'agent remplir des notes, des prix ou des auteurs que la page n'affiche pas.
  • Ajouter du balisage FAQPage pour des questions qui ne sont pas imprimées sur la page.
  • Tester du code collé au lieu de l'URL en ligne, ce qui manque ce que le JavaScript affiche.
  • Mettre dateModified à jour à chaque build au lieu de quand le contenu change.

Comment easyIndex le résout

easyIndex ne modifie jamais votre site : votre agent de codage écrit les pages et le schéma, et easyIndex audite chaque page à l'envoi, puis la vérifie de nouveau sur le site en ligne après publication, y compris la présence d'un JSON-LD et d'une vraie date de mise à jour. Une étape ne se termine que sur cette preuve, pas sur le rapport de l'agent.

Questions fréquentes

JSON-LD, Microdata ou RDFa ?

JSON-LD. Google accepte les trois et recommande le JSON-LD lorsque votre configuration le permet.

L'agent peut-il injecter le JSON-LD avec JavaScript ?

Google traite le JSON-LD présent après le rendu, mais un balisage rendu côté serveur est plus sûr pour les robots qui n'exécutent pas de JavaScript.

Organization doit-il figurer sur chaque page ?

Google le demande sur la page d'accueil ou sur une page à propos de l'organisation ; les autres pages peuvent la référencer comme publisher.

Cursor ou un autre agent fonctionne-t-il de la même façon ?

Oui. Tout agent qui modifie vos modèles peut suivre le même prompt ; seul le nom du fichier d'instructions change.

Lire la suite

Dernière vérification le .

Données structurées (JSON-LD) avec Claude Code ou Codex