Votre site est-il prêt pour les agents IA ?

Une directive noindex cache la page aux moteurs de recherche, et donc aux agents qui s'appuient sur eux pour trouver leurs sources.

Correction. Retirez la directive noindex des pages publiques, dans la balise meta robots comme dans l'en-tête X-Robots-Tag.

La liste de vos pages publiques. Un agent qui cherche une page précise la trouve sans parcourir tout le site.

Correction. Publiez un sitemap.xml qui liste vos pages publiques et déclarez-le dans robots.txt avec une ligne Sitemap.

Un agent qui choisit entre dix outils retient celui qui dit pour quoi il est fait. Le test cherche ces consignes dans le llms.txt ou un agents.md.

Correction. Ajoutez au llms.txt une section Quand utiliser, ou publiez un agents.md, qui dit en clair dans quels cas recommander votre service.

Si l'agent doit chercher votre documentation, la plupart abandonnent. Ne s'applique qu'aux sites avec une API ou une documentation technique.

Correction. Ajoutez un lien vers votre documentation dans le menu ou le pied de page de l'accueil.

Un résumé du site en Markdown, à la racine ou sur la documentation, qui oriente les modèles vers vos pages clés.

Correction. Publiez un fichier llms.txt à la racine du site, en Markdown, avec un titre, un résumé et les liens vers vos pages clés. Le générateur llms.txt de Hikoo le prépare en un clic.

Le format llmstxt.org attend un titre H1, un résumé en citation, des sections H2 et des liens Markdown.

Correction. Structurez le llms.txt selon llmstxt.org, avec un titre H1, un résumé en citation, des sections H2 et des liens.

Un lien cassé dans le llms.txt envoie l'agent dans le vide.

Correction. Vérifiez que chaque lien du llms.txt répond 200 et mettez le fichier à jour quand une page change d'adresse.

Les dates lastmod disent aux agents quelles pages ont changé et méritent d'être relues.

Correction. Indiquez la date de mise à jour de chaque page avec lastmod dans le sitemap.

Un serveur MCP annoncé dans le llms.txt ou dans /.well-known est trouvé par les agents sans recherche.

Correction. Annoncez votre serveur MCP dans le llms.txt et dans /.well-known/mcp.json ou une server card.

Nommer les agents IA dans robots.txt montre que leur accès est voulu, pas laissé au hasard de la règle générale.

Correction. Nommez les agents IA dans robots.txt, par exemple OAI-SearchBot, Claude-User ou PerplexityBot, avec la règle que vous voulez pour chacun.

Une ligne Content-Signal précise si votre contenu peut servir à la recherche, aux réponses des IA ou à l'entraînement.

Correction. Déclarez les usages autorisés de votre contenu avec une ligne Content-Signal dans robots.txt, pour search, ai-input et ai-train.

Un en-tête HTTP Link signale vos ressources pour agents dès la première réponse, sans lire la page.

Correction. Ajoutez un en-tête HTTP Link qui pointe vers vos ressources pour agents, version Markdown, llms.txt ou description d'API.

Le fichier /.well-known/ard.json liste en un seul endroit ce que vous offrez aux agents, serveurs MCP, API et skills.

Correction. Publiez /.well-known/ard.json pour lister ce que vous offrez aux agents, serveurs MCP, API et skills.

La page est demandée comme ChatGPT-User, OAI-SearchBot, Claude-User et PerplexityBot, les agents qui naviguent pour vos clients. Un pare-feu ou une règle robots.txt qui les arrête rend le site invisible.

Correction. Vérifiez votre pare-feu, votre outil anti-bot et robots.txt. Les agents de ChatGPT, Claude et Perplexity doivent recevoir la page, pas une vérification ni un refus.

Les agents lisent le HTML brut et exécutent rarement le JavaScript. Le test mesure le texte livré, le titre H1 et la part de texte dans le HTML hors scripts.

Correction. Rendez le contenu principal côté serveur, en SSR ou en génération statique, avec un titre H1. Visez au moins 5 % de texte dans le HTML hors scripts en allégeant le balisage.

Un agent sans JavaScript reste bloqué sur une page qui redirige en JavaScript ou par meta refresh, et se perd quand une redirection passe par un autre domaine.

Correction. Servez le site en HTTPS, redirigez http vers https côté serveur, et remplacez les redirections meta refresh ou JavaScript par des redirections HTTP 301 sur votre propre domaine.

Le test ouvre plusieurs pages liées depuis l'accueil. Une page derrière une connexion est invisible pour un agent.

Correction. Gardez publiques les pages qui décrivent votre offre, vos prix et votre documentation. Réservez la connexion à l'espace client.

Une adresse inexistante doit répondre 404. La note complète demande aussi un message en Markdown quand l'agent demande text/markdown, pour qu'il sache où aller ensuite.

Correction. Répondez 404 aux adresses inconnues, jamais 200. Quand la requête demande text/markdown, renvoyez un court message en Markdown avec un lien vers le plan du site ou le llms.txt.

Un agent qui demande text/markdown sur l'accueil reçoit une version propre de la page, sans menus ni scripts, et dépense moins de tokens.

Correction. Servez une version Markdown de l'accueil et de vos pages quand l'en-tête Accept demande text/markdown, avec Content-Type text/markdown et Vary Accept. Gardez le HTML pour les navigateurs.

Un agent charge le texte de chaque page dans sa fenêtre de contexte. Au delà de 25 000 tokens, il tronque et perd la fin.

Correction. Découpez les pages trop longues, comme les conditions générales ou les grandes FAQ, en pages plus courtes et liées entre elles.

Une balise link alternate de type text/markdown annonce la version Markdown de la page.

Correction. Ajoutez dans le head une balise link rel alternate de type text/markdown qui pointe vers la version Markdown de la page.

Le JSON-LD schema.org dit en clair ce que décrit la page, produit, article, entreprise ou FAQ.

Correction. Ajoutez du JSON-LD schema.org dans le HTML, Organization, WebSite, Product ou Article selon la page.

Titre, description, langue, URL canonique, og:image et og:type résument la page avant même sa lecture et évitent les citations erronées.

Correction. Renseignez un titre, une meta description, l'attribut lang, une URL canonique et les balises Open Graph og:image et og:type.

Un bloc Organization complet relie le site à la bonne entité et donne aux agents de quoi vérifier qui vous êtes.

Correction. Décrivez l'entreprise avec un bloc Organization qui donne le nom, l'URL, le logo, les profils officiels dans sameAs, un contactPoint et l'adresse.

Les pages À propos, Contact et Confidentialité permettent à un agent de vérifier qui est derrière le site avant de le recommander.

Correction. Liez depuis l'accueil vos pages À propos, Contact et Confidentialité ou Mentions légales.

Un agent qui compare des solutions pour un client écarte celles dont il ne trouve pas le prix. Ne s'applique qu'aux sites qui vendent.

Correction. Rendez vos prix lisibles par un agent, avec une page tarifs liée depuis l'accueil, des offres en JSON-LD ou un fichier pricing.md.

Des liens sameAs vers Wikidata, LinkedIn ou Crunchbase relient votre marque à une entité connue des modèles.

Correction. Listez dans sameAs du bloc Organization au moins deux profils officiels, par exemple Wikidata et LinkedIn.

Des types comme FAQPage, Product, Service ou Review donnent aux agents des réponses toutes prêtes.

Correction. Ajoutez les types qui correspondent à la page, par exemple Service, FAQPage, Product ou AggregateRating.

Un fichier pricing.md donne vos offres et vos prix en Markdown, sans page à interpréter.

Correction. Publiez /pricing.md avec vos offres, leurs prix et ce qu'elles incluent, et liez-le depuis le llms.txt.

Un H1 unique, des titres sans saut de niveau et des repères main et nav donnent à l'agent le plan de la page.

Correction. Gardez un seul H1 par page, des niveaux de titres sans saut et des repères main et nav.

Du texte caché qui donne des ordres aux agents est traité comme une injection de prompt et fait perdre leur confiance.

Correction. Retirez des attributs et du texte invisible toute consigne adressée aux IA. Dites ce que vous faites en clair, dans le contenu visible.

Pour un site qui propose une API, la spécification OpenAPI est la façon dont un agent l'intègre sans lire la documentation. Elle est cherchée aux adresses habituelles et dans la documentation.

Correction. Publiez votre spécification OpenAPI à une adresse stable, par exemple /openapi.json, et liez-la depuis la documentation et le llms.txt.

Quand un appel échoue, l'agent a besoin d'une erreur structurée en JSON, pas d'une page HTML. Le test appelle une adresse inexistante de l'API.

Correction. Faites répondre votre API en JSON sur toutes les erreurs, 404 compris, avec un code et un message lisibles.

Un agent doit pouvoir obtenir un accès de façon standard. Le test cherche les métadonnées OAuth de votre API ou de votre serveur MCP.

Correction. Publiez les métadonnées de votre serveur d'autorisation à /.well-known/oauth-authorization-server (RFC 8414) sur l'hôte de l'API ou du serveur MCP.

Des scopes nommés permettent de donner à un agent seulement l'accès dont il a besoin. Le test les cherche dans la spécification OpenAPI et les métadonnées RFC 9728.

Correction. Déclarez des scopes OAuth nommés, par exemple read et write, dans les securitySchemes de la spécification ou dans scopes_supported des métadonnées de ressource protégée.

Le test appelle l'API annoncée par la spécification, ou api suivi de votre domaine, et vérifie qu'elle répond.

Correction. Exposez votre API sur une adresse stable, annoncée dans la spécification OpenAPI, qui répond en JSON même sans authentification.

Chaque opération a besoin d'un operationId et d'une description pour qu'un agent sache laquelle appeler.

Correction. Donnez à chaque opération de la spécification un operationId unique et un résumé d'une phrase.

Un agent transforme une opération en outil quand elle a un identifiant, des paramètres typés et une réponse typée.

Correction. Typez les paramètres, le corps et les réponses de chaque opération avec des schémas JSON dans la spécification.

Une réponse décrite par un schéma permet à l'agent de lire le résultat sans deviner sa forme.

Correction. Décrivez la réponse 2xx de chaque opération avec un schéma JSON dans la spécification.

Des erreurs décrites par un schéma commun permettent à l'agent de comprendre l'échec et de corriger sa requête.

Correction. Définissez un schéma d'erreur dans components.schemas et référencez-le dans les réponses 4xx et 5xx.

Un agent évite une API qui peut changer sans prévenir. Le test cherche une version dans les adresses et une politique de dépréciation.

Correction. Versionnez l'API, par exemple avec /v1, et signalez ce qui disparaît avec deprecated dans la spécification ou les en-têtes Sunset et Deprecation.

Des en-têtes de limite permettent à un agent de ralentir de lui-même au lieu d'être bloqué.

Correction. Renvoyez les en-têtes RateLimit ou X-RateLimit sur les réponses de l'API, et Retry-After sur les 429.

Un serveur MCP permet aux assistants comme Claude ou ChatGPT d'utiliser votre service directement. Le test l'interroge sans compte.

Correction. Gardez l'authentification de votre serveur MCP et vérifiez avec un client autorisé que ses outils se listent correctement.

Un outil en ligne de commande permet aux agents de code d'utiliser votre produit sans écrire d'intégration.

Correction. Publiez un outil en ligne de commande officiel sur npm, PyPI ou Homebrew, et mentionnez-le dans le llms.txt.

Le fichier /.well-known/api-catalog de la RFC 9727 pointe vers vos API et leurs spécifications.

Correction. Publiez /.well-known/api-catalog au format linkset, avec un lien service-desc vers chaque spécification OpenAPI.

WebMCP expose les actions de la page, recherche, réservation ou panier, comme des outils qu'un agent appelle dans le navigateur.

Correction. Déclarez les actions clés de la page comme outils WebMCP avec navigator.modelContext, pour qu'un agent les appelle sans deviner l'interface.

Un index de skills propose aux agents de code des instructions prêtes à l'emploi pour intégrer votre produit.

Correction. Publiez /.well-known/agent-skills/index.json pour proposer aux agents de code des instructions prêtes à l'emploi.

Si un agent représente votre service, sa carte A2A permet à d'autres agents de le trouver et de lui parler.

Correction. Si un agent représente votre service, publiez sa carte A2A à /.well-known/agent-card.json.

Un portail où créer un compte, obtenir une clé et suivre son intégration sans écrire à personne.

Correction. Publiez une documentation pour développeurs avec inscription et clés d'API en libre service.

Un serveur MCP protégé doit dire à l'agent où s'authentifier, avec un en-tête WWW-Authenticate qui pointe vers ses métadonnées OAuth.

Correction. Renvoyez un 401 avec WWW-Authenticate Bearer et resource_metadata vers /.well-known/oauth-protected-resource.

Les métadonnées RFC 9728 disent à l'agent quel serveur d'autorisation utiliser pour votre API ou votre serveur MCP.

Correction. Publiez /.well-known/oauth-protected-resource sur l'hôte de l'API ou du serveur MCP, avec resource, authorization_servers et scopes_supported.

PKCE protège la connexion OAuth d'un agent qui ne peut pas garder de secret.

Correction. Acceptez PKCE avec la méthode S256 et annoncez-la dans code_challenge_methods_supported.

Un div cliquable n'existe pas pour un agent qui lit l'arbre d'accessibilité. Seuls les vrais boutons, liens et champs sont utilisables.

Correction. Remplacez les div et span cliquables par des balises button, a et input.

Les agents qui naviguent cliquent à partir de l'arbre d'accessibilité. Un bouton sans nom est un bouton qu'ils n'utilisent pas.

Correction. Donnez un texte ou un aria-label à chaque lien et bouton, et un attribut alt à chaque image.

Un agent remplit un formulaire en lisant l'étiquette de chaque champ. Sans étiquette, il devine.

Correction. Associez un label à chaque champ avec l'attribut for, ou donnez-lui un aria-label.

Une pagination par curseur permet à un agent de parcourir une liste sans sauter ni répéter d'éléments.

Correction. Paginez les listes de l'API avec un curseur, par exemple cursor ou starting_after, décrit dans la spécification.