# Shopify agents.md : UCP, MCP, llms.txt
> Shopify sert nativement agents.md, llms.txt et llms-full.txt sur de nombreux stores. Le vrai signal : UCP, MCP, catalogue, panier et checkout deviennent l'infrastructure de visibilité IA.
- Canonical HTML: https://verityscore.io/fr/blog/shopify-agents-md-llms-txt-ucp-ai-commerce/
- Markdown alternate: https://verityscore.io/fr/blog/shopify-agents-md-llms-txt-ucp-ai-commerce.md
- Language: fr
- Content type: blog
- Published: 2026-05-23
- Updated: 2026-05-30
- Tags: shopify, agents-md, llms-txt, ucp, mcp, agentic-commerce, geo
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.liquid` et `llms-full.txt.liquid` le 28 mai** (changelog). (6) Au 29 mai, **les six stores testés, dont Gymshark qui renvoyait 404 le 23 mai, servent tous `/agents.md` et `/.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 > Markets` avec 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.
Figure 1 : le fichier agents.md comme nouvelle porte d'entrée agentique des stores Shopify. Sources : tests Verity Score, Shopify.dev, Shopify Engineering, Google, mai 2026.
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.txt` répond en `301`
- `https://www.allbirds.com/llms-full.txt` répond aussi en `301`
- `https://www.allbirds.com/agents.md` répond en `200`, avec un `Content-Type: text/markdown`
- `https://www.allbirds.com/.well-known/ucp` répond en `200`, 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 :
```json
{
"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_checkout` exige le tier Token avec permission, jamais en anonyme. Les agents qui veulent terminer la transaction passent par Shop Pay via le Shop skill `https://shop.app/SKILL.md` (ce que `/agents.md` recommande 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.
Figure 2 : de /agents.md aux outils MCP, le chemin réel de l'agent acheteur. Le gate agent profile sur /api/ucp/mcp filtre les outils selon les capabilities négociées. Sources : tests Verity Score 22-23 mai 2026, Shopify.dev.
## 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.txt` personnalisé ne sont plus honorées une fois que Shopify sert la route nativement
- `templates/llms.txt.liquid` permet désormais de surcharger le contenu généré, sur le même pattern que `robots.txt.liquid`
- `templates/agents.md.liquid` est officiellement documenté par Shopify depuis le changelog du 28 mai 2026, au même titre que `templates/llms.txt.liquid` et `templates/llms-full.txt.liquid`. Il contrôle le `/agents.md` servi et le fallback par défaut, sur le même pattern que `robots.txt.liquid`
- `/.well-known/ucp` est 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_text` exploitables 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) :
1. 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.
2. Les produits sont éligibles à Shopify Catalog (catégorie standardisée, image, prix avec devise, publication sur Online Store / Hydrogen / Headless).
3. 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.
4. 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é](https://verityscore.io/fr/kb/shopify-agentic-storefronts-eligibility/).
### 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/mcp` vers `/api/ucp/mcp` traçable côté store
- qualité des réponses `search_catalog` sur 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](https://verityscore.io).*
## FAQ
### Shopify a-t-il officiellement annoncé le remplacement de llms.txt par agents.md ?
Pas d'annonce officielle formulée ainsi. Le comportement est observable sur de nombreux stores Shopify majeurs et les forums développeurs Shopify discutent de routes natives /llms.txt, /llms-full.txt et /agents.md depuis début mai 2026. Le rollout est documenté publiquement par la communauté (Anton Ekström, Shopifreaks, Craftshift, DEV community, n1n.ai, Honeybound) mais pas par un communiqué Shopify.
### Le rollout est-il sur tous les stores Shopify ?
La propagation avance vite. Au 29 mai 2026, Allbirds, Kylie Cosmetics, ColourPop, Steve Madden, Fenty Beauty ET Gymshark servent tous /agents.md et /.well-known/ucp (Gymshark renvoyait encore 404 le 23 mai). La diffusion se fait store par store et n'est pas encore universelle, mais elle s'étend rapidement et ne se limite pas à Shopify Plus.
### Peut-on encore personnaliser llms.txt sur Shopify ?
Oui, via templates/llms.txt.liquid. Shopify l'a officiellement documenté le 28 mai 2026 (changelog : customize llms.txt, llms-full.txt and agents.md) : ce template surcharge le default généré, sur le même pattern que robots.txt.liquid. Les anciennes redirections via l'admin ne sont plus fiables une fois la route native active.
### Peut-on personnaliser agents.md ?
Oui. Depuis le changelog Shopify du 28 mai 2026, templates/agents.md.liquid est officiellement documenté, au même titre que templates/llms.txt.liquid et templates/llms-full.txt.liquid. Il contrôle le fichier /agents.md servi ainsi que le fallback par défaut, sur le même pattern que robots.txt.liquid.
### Est-ce que agents.md améliore automatiquement la visibilité dans ChatGPT ou Gemini ?
Non. Il rend le store plus lisible et actionnable pour des agents compatibles, mais la visibilité dépend toujours de la qualité des données produit, des signaux de confiance, de la disponibilité, des prix, des avis, des pages et des intégrations des plateformes IA.
### Quelle différence avec schema.org ?
schema.org décrit les entités sur vos pages : Product, Offer, AggregateRating, FAQ, Organization. UCP/MCP expose des capacités actionnables : rechercher, récupérer un produit, créer un panier, créer un checkout. Les deux couches sont complémentaires.
### Faut-il supprimer son llms.txt ?
Non. Mais arrêter de le traiter comme un talisman GEO. Le garder utile, propre, sobre. Puis concentrer l'effort sur le catalogue, les attributs, les preuves, les feeds et les endpoints agentiques.
### J'avais un llms.txt custom et il a changé tout seul, c'est normal ?
Oui, c'est un cas documenté par la communauté Shopify. Les configs via URL Redirect Shopify, Cloudflare Worker ou app tierce ont pu être silencieusement remplacées par le default Shopify lors du rollout. Solution : recréer la version voulue via templates/llms.txt.liquid.
### Pourquoi mon curl sur /api/ucp/mcp retourne une erreur 'UCP discovery failed' ?
C'est attendu. Shopify exige que chaque requête MCP contienne meta.ucp-agent.profile pointant vers une UCP agent profile JSON hébergée à une URL publique. Sans profil, ou avec un profil malformé (cache-control invalide, version inconnue, capacités vides), le endpoint retourne une erreur JSON-RPC code -32001. Pour tester, l'agent doit héberger son propre profil ou utiliser un des fixtures Shopify documentés sur shopify.dev/docs/agents/profiles. Trois tiers d'auth (Token, Signed, Anonymous) donnent ensuite des accès et des limites de débit différents.
### Quelle est la vraie date limite pour migrer de /api/mcp vers /api/ucp/mcp ?
Il y a deux dates distinctes, souvent confondues. Le 30 mai 2026, UCP devient la version d'API effective : la doc et les nouveaux clients pointent vers /api/ucp/mcp, mais l'ancien endpoint répond encore. Le 15 juin 2026, l'ancien endpoint /api/mcp et les anciens noms d'outils (search, lookup) sont entièrement supprimés pour les outils catalogue. La deadline opérationnelle est donc le 15 juin, mais migrer avant le 30 mai laisse une fenêtre de test propre sur la nouvelle version. Source : Shopify dev changelog et guide migration Weaverse (24 avril 2026).
### Universal Cart de Google concerne-t-il les marchands Shopify ?
Oui, directement. Google a lancé Universal Cart le 19 mai 2026 à I/O. Les launch partners incluent Nike, Sephora, Target, Ulta Beauty, Walmart, Wayfair, ainsi que Fenty Beauty et Steve Madden, qui sont des stores Shopify. La mécanique : le shopper ajoute des produits depuis Search, Gemini, YouTube ou Gmail, et le cart cross-merchant gère le checkout via Google Pay (avec Affirm et Klarna en BNPL embedded). Pour un marchand Shopify aux US qui a activé Agentic Storefronts, c'est un nouveau canal de vente sans intégration supplémentaire. Pour un marchand FR, le checkout in-chat n'est pas encore disponible ; le rollout international est en cours (Canada et Australie annoncés, UK ensuite) sans date ferme. En attendant, le levier reste la discoverability.
### Est-ce qu'UCP est limité aux marchands Shopify Plus ?
Non. Agentic Storefronts est activé par défaut pour les marchands US éligibles depuis le 24 mars 2026, indépendamment du plan (ce n'est pas réservé à Plus). Shopify a par ailleurs annoncé un plan Agentic qui ouvre son Catalog même aux marques n'utilisant pas Shopify comme storefront. Les capacités de base (rechercher des produits, créer un panier, compléter un checkout) ne sont pas gated au plan Plus. Source : shopify.com/news/ai-commerce-at-scale. Certaines fonctionnalités avancées (saved catalogs, custom access scopes) peuvent rester réservées à Plus.
## Sources
- [Shopify.dev : Agentic commerce with UCP](https://shopify.dev/docs/agents) (official)
- [Shopify.dev : Storefront Catalog MCP](https://shopify.dev/docs/agents/catalog/storefront-catalog) (official)
- [Shopify.dev : Agent profiles and UCP negotiation](https://shopify.dev/docs/agents/profiles) (official)
- [Shopify.dev : Auth and rate limiting (Token, Signed, Anonymous)](https://shopify.dev/docs/agents/profiles/auth-and-rate-limiting) (official)
- [Shopify Engineering : Building the Universal Commerce Protocol](https://shopify.engineering/UCP) (official)
- [Shopify News : The agentic commerce platform (11 janvier 2026)](https://www.shopify.com/news/ai-commerce-at-scale) (official)
- [UCP specification](https://ucp.dev) (official)
- [Shopify Developer Community : Llms.txt and agents.md thread](https://community.shopify.dev/t/llms-txt-and-agents-md/34049) (industry)
- [Google Blog : Sundar Pichai NRF 2026, UCP introduction (11 janvier 2026)](https://blog.google/company-news/inside-google/message-ceo/nrf-2026-remarks/) (official)
- [Google Developers Blog : Under the Hood UCP (11 janvier 2026)](https://developers.googleblog.com/under-the-hood-universal-commerce-protocol-ucp/) (official)
- [Google Blog : Universal Cart, Google I/O (19 mai 2026)](https://blog.google/products-and-platforms/products/shopping/google-shopping-cart/) (official)
- [Google Blog : UCP features and AI tools, Marketing Live (20 mai 2026)](https://blog.google/products-and-platforms/products/shopping/shopping-updates-google-marketing-live/) (official)
- [Google Developers : Universal Commerce Protocol Guide](https://developers.google.com/merchant/ucp) (official)
- [Craftshift : Shopify quietly shipped native llms.txt, agents.md, UCP discovery (11 mai 2026)](https://craftshift.com/shopify-native-llms-txt-agentic-discovery-rollout/) (industry)
- [DEV Community / no7software-uk : Shopify auto-shipped agentic endpoints, override guide (14 mai 2026)](https://dev.to/no7software-uk/shopify-quietly-auto-shipped-llmstxt-agentsmd-and-well-knownucp-engineering-override-33cg) (industry)
- [n1n.ai : Engineering guide override agentic endpoints (14 mai 2026)](https://explore.n1n.ai/blog/shopify-engineering-guide-agentic-endpoints-override-2026-05-14) (industry)
- [Honeybound : Optimize Shopify llms.txt and agents.md (16 mai 2026)](https://honeybound.co/blog/shopify-llms-txt-agents-md-optimization) (industry)
- [Search Engine Journal : Shopify shares details on UCP, interview Finkelstein (22 janvier 2026)](https://www.searchenginejournal.com/shopify-shares-more-details-on-universal-commerce-protocol-ucp/565624/) (industry)
- [SiliconANGLE : Google debuts UCP at NRF (11 janvier 2026)](https://siliconangle.com/2026/01/11/google-debuts-universal-commerce-protocol-streamline-agentic-shopping-automation/) (industry)
- [ppc.land : Google expands UCP to hotels, food delivery (20 mai 2026)](https://ppc.land/google-expands-ucp-to-hotels-food-delivery-and-three-new-countries/) (industry)
- [Shopify dev changelog : Storefront Catalog MCP now implements UCP (22 avril 2026)](https://shopify.dev/changelog/storefront-catalog-mcp-now-implements-ucp) (official)
- [Shopify dev changelog : Customize llms.txt, llms-full.txt and agents.md (28 mai 2026)](https://shopify.dev/changelog/customize-llmstxt-llms-fulltxt-and-agentsmd) (official)
- [Shopify Help Center : Agentic storefronts requirements](https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/requirements) (official)
- [Weaverse : Storefront Catalog MCP UCP migration Hydrogen (24 avril 2026)](https://weaverse.io/blogs/shopify-storefront-catalog-mcp-ucp-migration-hydrogen-2026) (industry)
- [Weaverse : Shopify Agentic Admin section dedicated tier (16 mai 2026)](https://weaverse.io/blogs/shopify-agentic-admin-section-hydrogen-ai-channel-visibility-2026) (industry)
- [Craftshift : Shopify Catalog and AI channels, Supplemental Terms effectives 25 mai 2026 (12 mai 2026)](https://craftshift.com/shopify-catalog-ai-channels-merchant-guide/) (industry)
- [kaspianfuad : Shopify Agentic Storefronts April 2026 update, May 30 cutover (1 mai 2026)](https://kaspianfuad.com/blog/shopify-agentic-storefronts-april-2026-update/) (industry)
- [The Agent Times : Shopify opens UCP to all merchants (18 mai 2026)](https://theagenttimes.com/articles/shopify-opens-universal-commerce-protocol-to-all-merchants-g-eccd5afa) (industry)
- [Adweek : Google challenges Amazon with Universal Cart native checkout (20 mai 2026)](https://www.adweek.com/media/google-challenges-amazon-with-new-native-checkout-rolls-out-ai-ad-explainers/) (industry)
- [Verity Score KB : Shopify Agentic Storefronts, les 4 criteres officiels d'eligibilite](https://verityscore.io/fr/kb/shopify-agentic-storefronts-eligibility/) (official)
