Depuis début mai 2026, de nombreux stores Shopify, notamment côté Plus, exposent un fichier /agents.md, référencé dans le sitemap et relié à UCP/MCP. Ce n’est pas seulement une histoire de fichier texte. C’est le passage d’une logique “l’IA lit mon site” à une logique “l’agent peut interagir avec mon commerce”.
Mise à jour du 29 mai 2026. Plusieurs faits ont précisé et corrigé le tableau depuis la publication. (1) Agentic Storefronts est activé par défaut pour les marchands US éligibles depuis le 24 mars 2026, indépendamment du plan (pas réservé à Plus) ; Shopify a par ailleurs annoncé un plan Agentic qui ouvre son Catalog aux marques n’utilisant pas Shopify comme storefront. (2) Google a lancé le Universal Cart le 19 mai à Google I/O avec Nike, Sephora, Target, Ulta Beauty, Walmart, Wayfair, Fenty Beauty et Steve Madden (Shopify) comme partenaires de lancement aux US. (3) Le 20 mai à Google Marketing Live, Google a détaillé l’extension d’UCP (nouveaux pays, verticales hôtellerie et livraison de repas) ; le protocole de paiement agent AP2, distinct d’UCP, a été confié à la FIDO Alliance pour sa gouvernance. (4) Les Supplemental Terms for Agentic Storefronts sont effectifs depuis le 25 mai pour les marchands éligibles (email Shopify du 12 mai). (5) Shopify a officiellement documenté
templates/agents.md.liquid,llms.txt.liquidetllms-full.txt.liquidle 28 mai (changelog). (6) Au 29 mai, les six stores testés, dont Gymshark qui renvoyait 404 le 23 mai, servent tous/agents.mdet/.well-known/ucp. Sources : shopify.com/news, Google blog 19-20 mai, Adweek 20 mai, Craftshift 12 mai, Shopify changelog 28 mai, tests Verity Score 29 mai.
Statut France au 29 mai 2026. Le checkout direct in-chat via Google AI Mode, Gemini app, Microsoft Copilot et ChatGPT Agentic Storefronts a démarré aux US et n’est pas encore ouvert à l’ensemble des stores : la doc officielle Shopify indique qu’il n’est pas encore disponible pour tous les marchands, et Google annonce une extension à Canada et Australie (UK ensuite). La formulation stricte “US vers US uniquement” n’est pas confirmée par la page Shopify citée. Un marchand FR peut activer Agentic Storefronts en configurant un marché US dans
Settings > Marketsavec des tarifs d’expédition US, mais le checkout natif n’est pas encore disponible pour les clients français à ce jour. Pour la France aujourd’hui, le levier reste la discoverability (l’agent trouve le produit, redirige le client vers le storefront pour acheter), pas le checkout in-chat.
Le rollout a été repéré publiquement par Anton Ekström début mai 2026 et couvert par Shopifreaks le 7 mai 2026. Il se voit en quelques minutes de test : de nombreux stores Shopify servent désormais nativement trois fichiers distincts, /llms.txt, /llms-full.txt et /agents.md (contenus différents), et les anciennes méthodes de proxy ou de redirect côté admin deviennent difficiles à maintenir. Attention à une idée reçue répandue : /llms.txt ne redirige pas vers /agents.md. Sur les stores testés, le seul 301 observé est la normalisation non-www vers www, pas un redirect llms vers agents.
Le réflexe immédiat est de lire ça comme un problème de SEO technique : “Shopify bloque les fichiers llms.txt personnalisés”. C’est une partie du sujet, mais ce n’est pas le plus important.
Le vrai signal est plus profond. Shopify ne remplace pas seulement un fichier par un autre. Shopify déplace l’interface entre les marchands et les agents IA.
llms.txt disait essentiellement : voici comment comprendre mon site.
agents.md dit autre chose : voici comment chercher dans mon catalogue, créer un panier, démarrer un checkout, appliquer des règles de fulfillment et respecter l’approbation de paiement.
Ce n’est plus seulement de la découvrabilité. C’est de l’infrastructure commerce.
Ce que nous avons testé
Le 22 et le 23 mai 2026, nous avons testé plusieurs stores Shopify publics.
Sur Allbirds :
https://www.allbirds.com/llms.txtrépond en301https://www.allbirds.com/llms-full.txtrépond aussi en301https://www.allbirds.com/agents.mdrépond en200, avec unContent-Type: text/markdownhttps://www.allbirds.com/.well-known/ucprépond en200, avec un JSON de découverte UCP- le sitemap principal référence un fichier
sitemap_agentic_discovery.xml - ce sitemap agentique ne contient qu’une URL :
/agents.md
Même logique observée sur Kylie Cosmetics, ColourPop, Steve Madden et Fenty Beauty. Sur ColourPop et Steve Madden, le Location du 301 sur /llms.txt pointe explicitement vers /agents.md. Sur Fenty Beauty, on observe en plus une 301 de canonicalisation www.fentybeauty.com vers fentybeauty.com, ce qui montre que les détails de routage varient store par store.
Important pour la lecture : le rollout n’est pas encore universel, mais il s’étend vite. Le 23 mai 2026, Gymshark renvoyait encore des 404 sur /llms.txt, /agents.md et /.well-known/ucp ; au 29 mai, Gymshark sert les trois. La propagation est progressive, store par store, et certains stores plus petits ou en thème custom ne l’ont pas encore reçue.
Et il faut corriger une formulation trop absolue qui circule : Shopify ne “redirige” pas /llms.txt vers /agents.md. Sur les stores testés, les deux fichiers, plus /llms-full.txt, sont servis nativement avec des contenus distincts, et le seul 301 est la normalisation non-www vers www. Il n’y a pas d’annonce officielle de redirection llms vers agents.
La formulation la plus exacte est celle-ci : Shopify semble avoir introduit des routes natives pour /llms.txt, /llms-full.txt, /agents.md, /.well-known/ucp, /api/ucp/mcp et un sitemap agentique, avec un comportement par défaut qui privilégie /agents.md comme document agent-facing.
Ce que contient vraiment agents.md
Le fichier /agents.md généré sur les stores testés suit une structure assez stable.
Il commence par un titre personnalisé, par exemple :
# Agent Instructions - Allbirds
Puis il décrit comment un agent IA peut interagir avec la boutique. Le document ne se limite pas à lister des pages importantes. Il présente un parcours complet :
- découverte du store via
/.well-known/ucp - endpoint MCP via
/api/ucp/mcp - recherche catalogue
- création de panier
- création de checkout
- mise à jour du fulfillment
- finalisation du checkout avec approbation humaine
- consultation des politiques et métadonnées du store
Il indique aussi aux agents acheteurs de privilégier le Shop skill de Shopify pour gérer la recherche, les prix, les discounts, le checkout via Shop Pay et le suivi de commande.
Ce détail est stratégique. Shopify ne laisse pas seulement les agents lire les boutiques. Shopify cherche à orienter les agents vers ses rails natifs : Shop, Shop Pay, UCP, MCP, Shopify Catalog, checkout.
Le vrai fichier machine-readable n’est pas agents.md
/agents.md est lisible par un humain ou par un agent. Mais le vrai contrat technique est ailleurs.
Sur Allbirds, /.well-known/ucp retourne un JSON qui déclare :
- la version UCP supportée (
2026-04-08) - les versions antérieures supportées (
2026-01-23) - le service
dev.ucp.shopping - le transport MCP
- l’endpoint
/api/ucp/mcp - les capacités supportées : catalog (search, lookup), cart, checkout, order, fulfillment, payments (le profil UCP déclare aussi les payment handlers)
- les payment handlers disponibles, dont Google Pay et Shopify card
Autrement dit, /agents.md joue le rôle d’une notice. /.well-known/ucp joue le rôle de manifeste de capacités. /api/ucp/mcp joue le rôle d’interface actionnable.
C’est exactement le mouvement décrit par Shopify dans sa documentation agentic commerce : les MCP tools implémentent UCP à chaque étape du parcours acheteur, de la découverte produit au checkout et au suivi de commande.
La migration silencieuse de /api/mcp vers /api/ucp/mcp
Un point technique souvent oublié : le 22 avril 2026, Shopify a migré son endpoint MCP storefront de /api/mcp vers /api/ucp/mcp, et les noms d’outils ont changé (search est devenu search_catalog, lookup est devenu lookup_catalog).
Le changelog officiel Shopify Dev et le guide Weaverse (Hydrogen) confirment deux dates distinctes à retenir, pas une seule :
| Date | Ce qui change |
|---|---|
| 30 mai 2026 | UCP devient la version d’API effective des outils Storefront Catalog MCP. L’ancien endpoint et les anciens noms continuent de répondre, mais la doc et les nouveaux clients pointent vers la nouvelle version. |
| 15 juin 2026 | L’ancien endpoint /api/mcp et les anciens noms d’outils (search, lookup) sont entièrement supprimés. Toute intégration qui appelle encore l’ancienne URL stoppe de fonctionner. |
Implication concrète pour les développeurs Hydrogen, custom MCP, ou apps déjà intégrées à l’ancien endpoint : la migration vers /api/ucp/mcp doit être terminée avant le 15 juin 2026, idéalement avant le 30 mai pour disposer d’une fenêtre de test propre sur la nouvelle version. Vérifier dans le code et dans les manifestes d’app tout appel à /api/mcp ou à un nom d’outil non-suffixé.
Note importante : /api/mcp (ancien) et /api/ucp/mcp (nouveau) ne sont pas redondants. Selon la doc Shopify, l’endpoint /api/mcp reste utilisé pour les outils non-UCP (get_cart, update_cart, search_shop_policies_and_faqs) ; seuls les outils catalogue (search_catalog, lookup_catalog, get_product) basculent sur /api/ucp/mcp. Cette séparation est documentée dans shopify.dev/docs/apps/build/storefront-mcp/servers/storefront.
Ce que l’endpoint MCP expose, et comment il filtre les agents
Premier point important, vérifié en curl direct le 23 mai 2026. Le endpoint /api/ucp/mcp n’expose pas ses outils à n’importe qui. Un tools/list JSON-RPC sans agent profile retourne immédiatement :
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32001,
"message": "UCP discovery failed",
"data": {
"code": "invalid_profile_url",
"content": "Unable to fetch agent profile: Missing profile uri"
}
}
}
Pour découvrir les outils, l’agent doit passer une URI de UCP agent profile dans meta.ucp-agent.profile. Shopify fetche ce profil, valide sa signature et son cache-control, calcule l’intersection avec les capacités du store, et n’expose que les outils que les deux côtés savent négocier. C’est documenté sur shopify.dev/docs/agents/profiles.
Trois niveaux d’identification, avec des limites de débit et des outils différents selon le tier :
| Tier | Catalogue | Cart | Checkout | complete_checkout | Order |
|---|---|---|---|---|---|
| Token (JWT Dev Dashboard) | oui | oui | oui | oui si autorisé | oui avec scope orders |
| Signed (HTTP signatures RFC 9421, ECDSA P-256) | oui | oui | oui | non | non |
| Anonymous | oui | oui | oui (build/edit) | non | non |
Côté outils, Shopify documente publiquement plusieurs serveurs MCP UCP-compliants. Tous sont exposés par le même endpoint /api/ucp/mcp mais activés par les capabilities que l’agent advertise dans son profil :
| Capability UCP | Outils MCP documentés |
|---|---|
dev.shopify.catalog (Storefront Catalog MCP) | search_catalog, lookup_catalog, get_product |
dev.shopify.catalog.global (Global Catalog MCP) | recherche cross-marchands sur tous les listings Shopify |
dev.ucp.shopping.cart (Cart MCP) | construction et itération de panier, line items, contexte buyer |
dev.ucp.shopping.checkout (Checkout MCP) | conversion cart vers checkout, finalisation par agent trusted |
dev.ucp.shopping.order (Order MCP) | get_order pour lecture à la demande, complété par les webhooks order |
dev.ucp.shopping.fulfillment / discount / buyer_consent | extensions qui se greffent sur checkout et cart |
Trois précisions importantes :
- Seuls les trois outils du Storefront Catalog (
search_catalog,lookup_catalog,get_product) sont nommés explicitement dans la doc Shopify catalog. Les noms exacts des outils Cart, Checkout et Order ne sont pas énumérés dans le même format. Les autres tools/list précis dépendent de la négociation et du tier d’auth. complete_checkoutexige le tier Token avec permission, jamais en anonyme. Les agents qui veulent terminer la transaction passent par Shop Pay via le Shop skillhttps://shop.app/SKILL.md(ce que/agents.mdrecommande explicitement aux agents acheteurs).- Le Cart MCP est moins limité que le Checkout MCP. Shopify pousse les agents à itérer dans le panier (line items, totaux, contexte) et à ne convertir en checkout que quand le buyer est prêt à acheter.
Là encore, la nuance est essentielle. Un crawler SEO lit une page. Un agent commerce peut appeler un outil, à condition d’avoir une identité et une intention que le store accepte.
Et l’outil ne travaille pas avec du HTML. Il travaille avec des objets : variant ID, prix en minor units, pays, devise, langue, intention d’achat, disponibilité, discounts, fulfilment, paiement.
La nouvelle vitrine n’est plus seulement la page produit. C’est la qualité du modèle de données exposé aux agents, et la capacité du store à négocier avec chaque agent qui frappe à la porte.
Pourquoi Shopify fait ça maintenant
Le contexte compte.
Le 11 janvier 2026, lors du National Retail Federation (NRF), Shopify et Google annoncent conjointement l’Universal Commerce Protocol. L’objectif annoncé : permettre aux agents IA de se connecter et de réaliser des transactions avec n’importe quel marchand. UCP est annoncé comme open-source, co-développé avec Shopify, Etsy, Wayfair, Target et Walmart, et endossé par plus de vingt partenaires (Adyen, Amex, Best Buy, Mastercard, Stripe, Visa, Zalando, etc.).
Dans le même mouvement, Shopify documente ses MCP servers pour agents :
- Global Catalog, pour rechercher dans les listings Shopify à grande échelle
- Storefront Catalog, pour rechercher dans le catalogue d’un marchand précis
- Cart MCP, pour construire et mettre à jour des paniers
- Checkout, pour convertir le panier en checkout et, selon le niveau de confiance de l’agent, gérer plus loin le parcours
- Order MCP et webhooks, pour suivre l’état post-achat
Google pousse en parallèle UCP dans Search, Gemini et Google Pay. Les 19 et 20 mai 2026, à Google I/O puis à Google Marketing Live, Google annonce :
- l’Universal Cart, un panier cross-marchands intégré à Search, Gemini, YouTube et Gmail
- l’expansion UCP à de nouveaux pays (Canada, Australie, Royaume-Uni)
- l’extension à de nouvelles verticales (hôtellerie, livraison de repas)
- Affirm et Klarna en buy-now-pay-later embarqués dans Google Pay
- un AI performance insights tool dans Merchant Center
- Ask Advisor, un agent Gemini cross-produits
Le message est très clair : l’achat agentique devient une surface Google, pas seulement une expérimentation Shopify.
Trois précisions supplémentaires datées du 18-20 mai 2026 confirment le mouvement :
- Accès marchand : Agentic Storefronts est activé par défaut pour les marchands US éligibles depuis le 24 mars 2026, indépendamment du plan (pas réservé à Plus). Shopify a aussi annoncé un plan Agentic qui ouvre son Catalog aux marques n’utilisant pas Shopify comme storefront. L’agent peut rechercher des produits, créer des paniers et compléter un checkout via une seule UCP skill (source : shopify.com/news/ai-commerce-at-scale).
- 20 mai : à Google Marketing Live, Google a détaillé l’extension d’UCP à de nouveaux pays et à de nouvelles verticales (hôtellerie, livraison de repas). Le protocole de paiement agent AP2, distinct d’UCP, a été confié à la FIDO Alliance pour sa gouvernance (sources : Google blog 20 mai, ppc.land).
- Shopping Graph : Google revendique désormais 60 milliards de listings, contre les chiffres antérieurs plus prudents. Le réservoir produit derrière Universal Cart et AI Mode shopping est plus profond que ce qu’on supposait.
À noter aussi côté Shopify : depuis ~14-15 mai, Agentic Storefronts a sa propre section admin dédiée, promue depuis un sous-onglet de “Sales channels” vers un tier de premier niveau. Le data-quality dashboard interne (queries that rank, products with issues) est désormais visible directement par le marchand, ce qui rapproche l’audit GEO de l’audit Search Console.
Dans ce contexte, /agents.md devient la brique visible d’un basculement plus large : Shopify prépare ses marchands à être découverts, interrogés et potentiellement transacts par des agents.
llms.txt vs agents.md : la différence fondamentale
llms.txt est né comme une proposition simple : fournir aux LLMs une carte lisible du site, des contenus importants, des règles de lecture, parfois une version Markdown concentrée de la documentation ou des pages clés.
C’est utile. Mais c’est encore une logique documentaire.
agents.md chez Shopify change la grammaire :
| Dimension | llms.txt | agents.md Shopify |
|---|---|---|
| Nature | manifeste de lecture | notice d’interaction agentique |
| Objectif | aider un LLM à comprendre le site | aider un agent à agir dans le commerce |
| Donnée principale | URLs, descriptions, pages importantes | endpoints, capacités, outils, règles |
| Niveau d’action | lecture | recherche, panier, checkout, ordre |
| Centre de gravité | contenu | catalogue + protocole + transaction |
| Risque principal | contenu incomplet ou non maintenu | données produit, prix, stock ou policies incohérents |
Dit simplement : llms.txt aide l’IA à lire. agents.md aide l’agent à acheter.
Ce que ça change pour les marchands Shopify
La première conséquence est pratique. Si vous aviez un /llms.txt généré par app, proxy ou URL redirect, il faut vérifier ce qui est réellement servi aujourd’hui.
Sur le forum Shopify Developer Community et plusieurs guides parus en mai 2026 (Craftshift, DEV community / no7software, n1n.ai, Honeybound), il est documenté que :
- les anciennes redirections admin vers un
llms.txtpersonnalisé ne sont plus honorées une fois que Shopify sert la route nativement templates/llms.txt.liquidpermet désormais de surcharger le contenu généré, sur le même pattern querobots.txt.liquidtemplates/agents.md.liquidest officiellement documenté par Shopify depuis le changelog du 28 mai 2026, au même titre quetemplates/llms.txt.liquidettemplates/llms-full.txt.liquid. Il contrôle le/agents.mdservi et le fallback par défaut, sur le même pattern querobots.txt.liquid/.well-known/ucpest généré par Shopify depuis la configuration du store et n’est pas overridable, ce qui est cohérent avec son rôle de manifeste de vérité
La deuxième conséquence est stratégique. Installer un fichier llms.txt ne suffit plus à revendiquer une stratégie AI commerce. Le sujet devient :
- les produits sont-ils clairement nommés et catégorisés ?
- les variantes sont-elles propres et exploitables par
search_catalog? - les prix et disponibilités sont-ils cohérents entre Shopify, le feed Merchant Center, le schema et le storefront ?
- les images ont-elles des
alt_textexploitables pour un agent qui présente le produit ? - les avis sont-ils structurés ?
- les claims sont-ils prouvables et traçables ?
- les politiques de livraison et retour sont-elles lisibles et atteignables depuis l’URL canonique ?
- les fiches produit répondent-elles à des intentions concrètes (“respirant pour l’été”, “compatible peau sensible”, “garantie deux ans”) ?
- le catalogue peut-il être interrogé par un agent avec contexte de pays, langue, devise et intention ?
Le centre de gravité bouge : du fichier vers le catalogue.
Le risque : croire que Shopify a tout réglé
Shopify rend l’infrastructure accessible. Il ne garantit pas la visibilité.
C’est probablement le piège principal pour les marchands. Voir /agents.md, /.well-known/ucp et /api/ucp/mcp en place peut donner l’impression que le store est prêt pour l’AI commerce.
En réalité, Shopify fournit la route. La qualité de ce qui circule dans cette route dépend encore du marchand.
Un agent qui cherche “sneakers respirantes pour marcher toute la journée en été” ne va pas recommander un produit parce que /agents.md existe. Il va dépendre de signaux concrets :
- titre produit
- description exploitable
- attributs matière
- usage
- saison
- disponibilité
- prix
- retours clients
- politique de retour
- preuves de confort
- cohérence entre fiche produit, schema.org, feed Merchant Center et données Shopify
L’infrastructure agentique amplifie la donnée. Elle ne la corrige pas magiquement.
Le sujet n’est pas seulement Shopify
Ce que Shopify fait avec /agents.md s’inscrit dans une bataille plus large pour contrôler le rail de l’achat agentique.
- OpenAI et Stripe ont poussé l’Agentic Commerce Protocol (ACP) autour du checkout conversationnel.
- Google et Shopify poussent UCP autour d’un standard plus large de commerce agentique.
- Google a aussi formalisé l’Agent Payments Protocol (AP2), groupé avec UCP dans son annonce Marketing Live du 20 mai 2026 : AP2 sert à autoriser des paiements faits par des agents au nom d’un utilisateur, avec des mandats numériques signés et une chaîne de responsabilité vérifiable. Premières arrivées dans Gemini Spark prévues dans les mois qui viennent.
- Anthropic a popularisé MCP comme protocole de connexion entre modèles et outils. UCP est explicitement compatible avec MCP, A2A et AP2 selon la doc Google.
Microsoft, Google, OpenAI et Anthropic convergent tous vers la même intuition : l’IA ne va pas seulement répondre. Elle va agir.
Pour le e-commerce, cela signifie que la page web devient une surface parmi d’autres.
Le client peut encore arriver sur votre site. Mais il peut aussi :
- poser une question dans ChatGPT
- comparer dans Gemini
- ajouter un produit depuis Google AI Mode
- acheter via Universal Cart
- passer par Shop Pay
- demander à un agent personnel de suivre une commande
Dans ce monde, l’enjeu n’est plus seulement de ranker. Il est d’être disponible comme option actionnable.
Ce qu’il faut auditer cette semaine
0. Vérifier l’éligibilité Agentic Storefronts en 4 points
Avant tout audit endpoints, ouvrir Shopify Admin > Settings > Apps and sales channels > Agentic (ou /apps/agentic). L’accès est en early access et déployé store par store : Shopify notifie par email et dans l’admin quand c’est disponible. Si l’écran affiche “Agentic storefronts aren’t available”, soit votre store n’est pas encore dans la vague de déploiement, soit l’un des 4 prérequis ci-dessous n’est pas rempli (conditions synthétisées à partir des pages Shopify Catalog, Supplemental Terms et Policies, et non une liste officielle unique sur une seule page) :
- Le store vend à des clients US (marché US actif dans
Settings > Markets, tarifs d’expédition US configurés). Le store peut rester basé en France. - Les produits sont éligibles à Shopify Catalog (catégorie standardisée, image, prix avec devise, publication sur Online Store / Hydrogen / Headless).
- Les Supplemental Terms for Agentic Storefronts sont acceptés. Ces conditions sont effectives depuis le 25 mai 2026 pour tous les marchands éligibles, suite à l’email envoyé par Shopify le 12 mai 2026.
- Les 3 pages politiques sont remplies (
Settings > Policies) : Terms of service, Privacy policy, Return and refund policy.
Pour le détail exhaustif avec chemins admin, voir notre KB dédiée : Shopify Agentic Storefronts, les 4 critères officiels d’éligibilité.
1. Vérifier les endpoints réellement servis
Testez :
/llms.txt/llms-full.txt/agents.md/.well-known/ucp/api/ucp/mcp/sitemap.xml/sitemap_agentic_discovery.xml
Regardez les statuts HTTP, les redirections, les Content-Type, et le contenu final. Ne vous fiez pas à ce qui est configuré dans l’admin : vérifiez ce que l’agent voit réellement. Et si vos endpoints 404 ce mois-ci, ce n’est pas anormal : le rollout est store-by-store.
2. Vérifier si Shopify a écrasé votre llms.txt custom
Si vous hébergiez auparavant un llms.txt personnalisé via Cloudflare Worker, URL Redirect Shopify, ou app tierce, il y a un risque réel qu’il ait été silencieusement remplacé par le default Shopify lors du rollout d’avril-mai 2026. Plusieurs cas remontés sur le forum développeurs Shopify confirment ce remplacement silencieux. Comparer ce qui est servi aujourd’hui au contenu attendu. Si divergence, recréer via templates/llms.txt.liquid.
3. Lire votre agents.md comme un agent acheteur
Votre /agents.md contient-il le bon nom de marque ? Les bonnes policies ? Le bon domaine canonique ? Les bons endpoints ? Le ton est-il purement générique ou contient-il des informations utiles sur votre commerce ?
Même si Shopify génère une partie du fichier, vous devez savoir ce qu’il dit en votre nom. Utilisez la surcharge via templates/agents.md.liquid (officiellement supportée depuis le 28 mai 2026) pour préciser les règles spécifiques à votre catalogue (gating B2B, vérification d’âge, contraintes vétérinaires, marché unique, etc.).
4. Auditer la migration /api/mcp vers /api/ucp/mcp
Si vous avez une intégration Hydrogen, un agent custom, ou une app qui consomme /api/mcp historique : vérifier l’URL et les noms d’outils utilisés (search vs search_catalog, lookup vs lookup_catalog). Deux dates pivots, déjà détaillées plus haut : 30 mai 2026 (UCP version effective) et 15 juin 2026 (retrait définitif de l’ancien endpoint pour les outils catalogue). Migrer avant le 15 juin pour éviter une rupture silencieuse, idéalement avant le 30 mai pour disposer d’une fenêtre de test propre.
5. Tester la recherche catalogue
Le vrai test n’est pas “le endpoint existe-t-il ?”. Le vrai test est : “que répond le catalogue quand un agent cherche comme un humain ?”
Exemples :
- “cadeau skincare moins de 40 euros pour peau sensible”
- “chaussures pour marcher 10 km par jour en été”
- “robe noire mariage invitée, pas trop formelle”
- “complément sans sucre compatible vegan”
Si les résultats sont pauvres, le problème n’est pas MCP. Le problème est la donnée produit.
6. Comparer avec Merchant Center et schema.org
Les agents n’ont pas une seule source. Ils croisent des signaux : Shopify Catalog, Merchant Center, schema.org, pages produit, avis, contenu éditorial, politiques, web ouvert.
Si le prix diffère entre votre page, votre feed et votre donnée exposée, l’agent hésite. Si votre disponibilité est incohérente, il évite. Si vos claims ne sont pas prouvés, il les ignore.
7. Garder llms.txt, mais ne pas le surestimer
Un llms.txt propre peut rester utile pour clarifier le site, les pages clés, les guides, les politiques et les contenus de référence. Mais sur Shopify, il ne doit pas être pensé comme le centre de la stratégie IA.
La priorité 2026 est plutôt :
- catalogue structuré
- attributs produit complets
- schema.org propre
- feed Merchant Center cohérent
- pages guides et FAQ extractibles
- claims prouvés
- endpoints agentiques testés
Tableau de synthèse
| Signal observé | Ce que ça signifie | Ce qu’il faut faire |
|---|---|---|
/llms.txt, /llms-full.txt et /agents.md servis nativement (fichiers distincts, pas de redirect llms vers agents) | Shopify expose le document agent-facing en plus du llms.txt | vérifier le contenu final réellement servi |
/agents.md existe | le store expose une notice d’interaction agentique | lire ce que Shopify dit aux agents |
/.well-known/ucp existe | le store déclare ses capacités UCP | vérifier versions, endpoints, payment handlers |
/api/ucp/mcp expose des outils | l’agent peut interroger catalogue, panier, checkout | tester en lecture seule les outils catalogue, migrer depuis /api/mcp |
sitemap_agentic_discovery.xml est dans le sitemap | Shopify rend /agents.md découvrable | vérifier indexation et canonicalisation |
| Endpoints 404 sur votre store | rollout pas encore propagé | re-tester périodiquement, contacter le support si bloqué |
Ancien app proxy llms.txt ne marche plus | la route native a pris priorité, le custom a pu être écrasé | tester une surcharge Liquid si nécessaire |
Ce que Verity Score regardera désormais
Pour un audit AI commerce Shopify, vérifier seulement robots.txt, sitemap.xml et schema.org n’est plus suffisant.
Il faut ajouter une couche agentique :
- présence et statut de
/agents.md - contenu et cohérence de
/agents.md(canonical, policies, brand name) - présence de
/.well-known/ucp - version UCP supportée et versions fallback
- services et capacités déclarés
- présence du transport MCP
- comportement du endpoint
/api/ucp/mcp(réponse au gate agent profile, refus correct des profils manquants ou malformés) - migration
/api/mcpvers/api/ucp/mcptraçable côté store - qualité des réponses
search_catalogsur des intentions réelles avec un profil de test agent - cohérence prix/stock entre MCP, page produit, schema.org et Merchant Center
- qualité des attributs variant
- présence des policies dans les sources agentiques
- signaux de preuve autour des claims produit
Le GEO e-commerce devient une discipline hybride : SEO technique, data produit, protocole commerce, trust et conversion.
À retenir
Le débat “llms.txt est-il remplacé ?” est utile, mais il peut faire rater le vrai mouvement.
Shopify ne cherche pas seulement à aider les LLMs à lire les stores. Shopify prépare les stores à être utilisés par des agents acheteurs.
La différence est majeure.
Dans le premier monde, la marque optimise des pages pour être citée.
Dans le second, elle optimise un catalogue, des attributs, des règles de prix, des policies et des rails de checkout pour être sélectionnée et achetée.
Le fichier /agents.md est visible. Mais le vrai travail se passe dessous : UCP, MCP, catalog search, cart, checkout, payment handlers, Merchant Center, schema.org, données produit.
Pour les marchands, la bonne question n’est donc pas : “Est-ce que j’ai un llms.txt ?”
La bonne question est : si un agent acheteur interroge mon store demain matin, a-t-il assez de données fiables pour me recommander plutôt qu’un concurrent ?
Un article de Kamil Kaderbay. Pour auditer la préparation d’une boutique Shopify à l’AI commerce, voir Verity Score.