Quelles règles SEO mettre dans AGENTS.md ou CLAUDE.md ?

Mettez une courte liste de règles vérifiables pour chaque nouvelle page : une question et un seul H1, un titre et une description uniques, une canonique, hreflang, un texte rendu côté serveur, un JSON-LD qui correspond au texte visible, une entrée dans le sitemap, des faits sourcés, et ne jamais toucher aux pages qui fonctionnent. Les règles guident l'agent ; elles ne prouvent pas que la page en ligne est juste.

Données clés

AGENTS.md est utilisé par plus de 60 000 projets open source et est géré par l'Agentic AI Foundation, sous l'égide de la Linux Foundation, à la date du 13 octobre 2026. (AGENTS.md)
Claude Code v2.1.277 et versions ultérieures lit AGENTS.md lorsque le projet n'a pas de CLAUDE.md, et un CLAUDE.md peut l'inclure avec la ligne @AGENTS.md. (Documentation Claude Code : comment Claude se souvient de votre projet, en anglais)
Anthropic conseille de garder chaque CLAUDE.md sous 200 lignes et indique que Claude le traite comme du contexte, non comme une configuration imposée. (Documentation Claude Code : comment Claude se souvient de votre projet, en anglais)
Codex combine les fichiers AGENTS.md de ~/.codex et ceux allant de la racine du projet vers le dossier courant, dans la limite de 32 Kio par défaut. (Documentation OpenAI Codex : AGENTS.md, en anglais)
Google indique que les données structurées doivent représenter fidèlement la page et ne doivent pas baliser un contenu que le lecteur ne voit pas. (Google Search Central : consignes générales sur les données structurées, en anglais)

Quel fichier doit contenir les règles, AGENTS.md ou CLAUDE.md ?

Utilisez AGENTS.md si plus d'un agent de codage travaille sur le dépôt, car Codex et Cursor le lisent et Claude Code le lit ou l'importe. Gardez CLAUDE.md pour les notes propres à Claude, avec une ligne d'import pour que Claude reçoive aussi les règles communes :

# CLAUDE.md
@AGENTS.md

Quelles règles faut-il copier ?

Ces règles sont courtes, concrètes et vérifiables, ce que recommande la documentation des agents eux-mêmes. Collez-les comme une section du fichier :

## SEO rules for new pages

- Only add new content pages. Never change the home page or a page that already works.
- One question per page. The H1 is that question; the first paragraph answers it.
- Unique <title> (up to 60 characters) and meta description (70 to 165).
- Self-referencing rel="canonical" on every page.
- Each language version links the others with hreflang; canonical stays in its own language.
- The text is in the server-rendered HTML, not loaded only by JavaScript.
- JSON-LD describes only what the page visibly says.
- Every number or date in a fact links to the source that states it. Invent nothing.
- Add the page to the sitemap and link to it from a related page.
- A page is done when it is checked on the live URL, not when the build passes.

Pourquoi chaque règle ?

Chaque règle répond à une façon connue dont les pages échouent :

Règle	Pourquoi
Canonique sur chaque page	Google traite rel=canonical comme un signal fort, et le sitemap comme un signal faible
hreflang entre les langues	Google utilise les versions alternatives hreflang pour les langues, avec une canonique dans la même langue
Texte rendu côté serveur	Sinon, les robots qui n'exécutent pas JavaScript voient une page vide
JSON-LD qui correspond au texte visible	Les consignes de Google sur les données structurées interdisent de baliser un contenu caché
Ne jamais toucher aux pages qui fonctionnent	Une réécriture peut faire perdre le trafic qu'une page gagne déjà

Que ne peuvent pas garantir les règles ?

Les règles ne peuvent pas garantir le résultat publié : la documentation de Claude Code indique elle-même que le fichier est du contexte, non une configuration imposée. Un déploiement raté, une mauvaise canonique ou un rendu vide n'apparaissent que sur l'URL en ligne : vérifiez donc chaque page à cet endroit, et suivez l'indexation dans Search Console.

Étape par étape

Choisissez le fichier. Utilisez AGENTS.md à la racine du dépôt ; ajoutez @AGENTS.md dans CLAUDE.md si vous en gardez un.
Collez les règles. Copiez le bloc de règles et adaptez les chemins et les langues à votre site.
Restez court. Restez bien en dessous de 200 lignes ; placez les règles d'un seul dossier dans un fichier imbriqué.
Vérifiez en ligne. Après chaque déploiement, ouvrez les nouvelles URL et confirmez le titre, la canonique, le contenu et le JSON-LD.

Erreurs fréquentes

Écrire des règles vagues comme « suivre les bonnes pratiques SEO » que l'agent ne peut pas vérifier.
Garder CLAUDE.md et AGENTS.md sans import, si bien que Claude Code ne lit jamais les règles communes.
Coller un long manuel SEO qui noie les règles importantes.
Considérer le fichier de règles comme la preuve que les pages publiées sont justes.

Comment easyIndex le résout

easyIndex donne à votre agent de codage les règles de page étape par étape, via MCP, audite chaque page à sa soumission et la vérifie sur le site en ligne après publication ; une étape n'est terminée que sur des preuves que easyIndex contrôle, et non sur le rapport de l'agent.

Il ne modifie jamais votre site ni votre dépôt, et fonctionne avec Claude Code, Codex, Cursor ou tout client MCP, pour 30 $US par site et par mois après 7 jours d'essai gratuit.

Questions fréquentes

Claude Code lit-il AGENTS.md ?

Oui, à partir de la v2.1.277 quand il n'y a pas de CLAUDE.md ; avec un CLAUDE.md, ajoutez la ligne @AGENTS.md pour l'inclure.

Ces règles feront-elles citer mon site par ChatGPT ?

Aucune règle ne peut le promettre. Elles rendent les pages claires et lisibles par les robots ; la citation reste la décision de ChatGPT.

Faut-il ajouter llms.txt aux règles ?

C'est facultatif. Les pages rendues côté serveur, les canoniques et le sitemap comptent d'abord.

Un sous-dossier peut-il avoir ses propres règles ?

Oui. Les agents lisent l'AGENTS.md le plus proche dans l'arborescence, donc un fichier imbriqué peut contenir les règles de ce dossier.

Lire la suite

Dernière vérification le 13 octobre 2026.