Le Shopify AI Toolkit est le plugin officiel et open source que Shopify a lancé le 9 avril 2026 pour brancher les assistants de code IA (Claude Code, Cursor, Codex, VS Code…) sur sa documentation, ses schémas d’API et, via le Shopify CLI, sur les boutiques elles-mêmes. Avec la version 1.8.4 publiée le 18 septembre 2026, il réunit 22 skills spécialisés, contre 16 au lancement.
Chez Dedi, agence Shopify certifiée Shopify Plus installée à Lyon depuis plus de 20 ans, nous l’avons déployé dans nos trois pôles : gestion de projet, intégration et développement. Ce guide reprend ce que nous avons appris en l’utilisant sur de vrais projets : ce qu’il fait, comment l’installer, ce qu’il change sur une refonte ou une migration, ses limites, et la façon dont nous le mettons entre les mains de nos clients sans leur faire prendre de risques.
L’essentiel en 5 points
- Le Shopify AI Toolkit s’adresse d’abord aux développeurs et aux agences Shopify, pas aux marchands au quotidien (pour eux, il y a Sidekick).
- Chaque skill cherche dans la doc officielle shopify.dev avant d’écrire, puis valide le code Liquid ou GraphQL contre les schémas Shopify avant de l’exécuter.
- Il peut agir sur une vraie boutique : produits, collections, redirections, metafields. Ces opérations sont immédiates et sans retour arrière.
- Il accélère fortement les migrations, l’intégration de thèmes et le développement de Functions ou d’apps.
- Il ne remplace ni le cadrage, ni la recette, ni la stratégie : c’est là qu’une agence Shopify fait la différence.
Sommaire
- C’est quoi le Shopify AI Toolkit ?
- Comment il fonctionne
- Installer le Toolkit : les 3 méthodes
- Les 22 skills et ceux qui comptent vraiment
- Ce que le Toolkit change sur un projet Shopify
- Toolkit, Sidekick ou Shopify Magic ?
- Limites et règles de sécurité
- Pourquoi le Toolkit ne remplace pas une agence Shopify
- Commerce agentique et GEO
- 10 prompts prêts à l’emploi
- FAQ
C’est quoi le Shopify AI Toolkit ?
Le Shopify AI Toolkit est un ensemble d’outils publié par Shopify sur GitHub (dépôt Shopify/shopify-ai-toolkit) qui donne à un assistant IA une connaissance à jour de la plateforme. Il repose sur trois briques.
| Brique | Ce qu’elle apporte |
|---|---|
| Des skills spécialisés | 22 modules, chacun expert d’un domaine : thèmes Liquid, API Admin GraphQL, metafield, statistiques ShopifyQL, checkout, apps, point de vente… |
| La documentation Shopify en direct | Avant d’écrire une ligne, le skill consulte shopify.dev. Les noms de champs et la syntaxe viennent de la source, pas de la mémoire du modèle. Et heureusement vu les mises à jour quotidiennes ! |
| Un validateur intégré | Le code Liquid, les requêtes GraphQL et les composants d’extensions sont vérifiés contre les schémas Shopify avant d’être exécutés ou envoyés sur une boutique. |
Il règle un problème précis. Une IA généraliste écrit du code Shopify plausible mais souvent faux : champs d’API dépréciés, filtres Liquid obsolètes, syntaxe inventée. Le Toolkit l’oblige à travailler à partir de la version d’API ciblée et à passer chaque livrable dans un validateur.
Comment fonctionne le Shopify AI Toolkit ?
Au quotidien, le déroulé ressemble à ceci :
- Vous décrivez le besoin en français, par exemple : « passe en brouillon tous les produits sans image ».
- L’assistant choisit le bon skill (ici
shopify-admin). - Il cherche le schéma et la documentation correspondants.
- Il écrit la requête GraphQL et la valide.
- Il vous montre l’opération et attend votre accord avant de modifier la boutique.
L’exécution passe par le connecteur Shopify ou par la commande shopify store execute du Shopify CLI, avec un accès Admin authentifié à la boutique. C’est ce dernier point qui permet de s’en servir en production, sur les boutiques de nos clients.
Installer le Shopify AI Toolkit : les 3 méthodes
Prérequis : Node.js 18 ou plus, un assistant compatible, et le Shopify CLI si vous voulez agir sur une boutique. La documentation officielle (shopify.dev/docs/apps/build/ai-toolkit) liste Claude Code, Codex, Antigravity CLI, Cursor, Hermes, OpenClaw, Pi et Visual Studio Code.
| Méthode | Commande | Notre avis |
|---|---|---|
| 1. Le plugin (recommandé) | Claude Code : claude plugin install shopify-ai-toolkit@claude-plugins-officialCursor : /add-plugin shopifyCodex : codex plugin add shopify@openai-curatedVS Code : « Chat: Install Plugin From Source » + URL du dépôt |
Se met à jour tout seul. C’est la méthode que nous retenons pour toute l’équipe. |
| 2. Les skills seuls | npx skills add Shopify/shopify-ai-toolkit |
Copie les skills sans le plugin. Aucune mise à jour automatique : à refaire à chaque version. |
| 3. Le serveur Dev MCP | npx -y @shopify/dev-mcp@latest |
Donne accès à la doc, aux schémas et à la validation sous forme d’outils MCP. N’agit pas sur une boutique. |
Comptez moins de dix minutes pour une installation propre. Le vrai travail commence après : définir qui a le droit d’exécuter quoi, sur quelle boutique, et avec quelles précautions.
Les 22 skills du Toolkit : lesquels comptent vraiment ?
Tous les skills ne servent pas à une marque e-commerce. Voici notre cartographie, notée selon l’intérêt pour un projet e-commerce (5 = indispensable).
| Famille | Skills | Intérêt |
|---|---|---|
| Boutique et données | API Admin GraphQL (shopify-admin), métachamps et métaobjets (shopify-custom-data), statistiques ShopifyQL (shopify-shopifyql) |
5/5 |
| Thème et vitrine | Thèmes Liquid (shopify-liquid) 5/5, API Storefront GraphQL et Hydrogen (headless) 3/5 |
3 à 5/5 |
| Checkout et comptes clients | Shopify Functions et extensions de checkout 4/5, extensions espace client 3/5, API Customer Account 2/5 | 2 à 4/5 |
| Apps et extensions | Extensions de l’admin 3/5, interface d’app (App Home) et point de vente (POS) 2/5 | 2 à 3/5 |
| Partenaires et monétisation | API Partner 3/5, tarification d’app et pré-audit App Store 2/5, apps de paiement 1/5 | 1 à 3/5 |
| Outils et démarrage | Shopify CLI (shopify-use-shopify-cli) 5/5, démarrer un projet dev, créer une boutique de démo, documentation Shopify 3/5, UCP (achats agentiques) 2/5 |
2 à 5/5 |
Pour une marque, cinq skills font l’essentiel du travail : shopify-admin, shopify-custom-data, shopify-shopifyql, shopify-liquid et shopify-use-shopify-cli.
Ce que le Toolkit change sur un projet Shopify
Nous avons organisé son usage par pôle, parce qu’un chef de projet, un intégrateur et un développeur ne lui demandent pas la même chose.
Refonte et migration vers Shopify
C’est là que le gain est le plus visible. Sur une migration PrestaShop vers Shopify, une migration Magento vers Shopify ou depuis WooCommerce, le chef de projet peut désormais migrer, contrôler et paramétrer la boutique sans attendre un développeur pour chaque script.
| Tâche | Sans le Toolkit | Avec le Toolkit |
|---|---|---|
| Mapping des champs | Tableur fait à la main, champs Shopify cherchés dans la doc | Mapping proposé vers les champs et métachamps Shopify à partir de l’export de l’ancien site |
| Import produits | CSV ou Matrixify, corrections en plusieurs passes | Import par l’API (productSet, opérations en masse) avec variantes, images et métachamps |
| Redirections 301 | Fichier monté à la main puis importé dans l’admin | Générées depuis la liste des anciennes URL et créées en masse |
| Contrôle après import | Vérification produit par produit | Requêtes : produits sans image, sans prix, sans poids, sans SEO, variantes en double |
| Clients et commandes | Import CSV, doublons à nettoyer | Import par l’API, dédoublonnage par e-mail, commandes historiques si besoin |
Matrixify et les apps de migration restent utiles pour les très gros volumes. Le Toolkit couvre le sur mesure et, surtout, les contrôles. Il sert aussi en amont : vérifier dans la doc si une fonctionnalité est native (lots, paliers de remise, B2B, marchés) avant de vendre une app au client, ou lister les sections et blocs d’un thème pour les comparer au cahier des charges. Après la mise en ligne, shopify-shopifyql sort les chiffres avant / après refonte en une question.
Intégration de thèmes et de maquettes
Pour nos intégrateurs, le Toolkit connaît le Liquid et la doc à jour. Il crée des sections et blocs sur mesure, branche les metafields, debug et valide chaque fichier avant l’envoi.
Notre règle de base reste la même : partir des blocs natifs du thème. Il y a moins de code à maintenir et le client garde la main dans l’éditeur de thème.
Développement sur mesure : Functions, checkout et apps
Côté développement, le Toolkit accélère l’écriture de Shopify Functions (remises par lots ou paliers, masquage de modes de livraison ou de paiement, blocage d’un panier B2B invalide), d’extensions de checkout et d’espace client, et d’intégrations ERP ou PIM par l’API Admin. Le skill travaille sur la version d’API ciblée et signale les champs obsolètes. Pour une app publique, shopify-app-store-review produit un rapport de pré-audit avant la soumission à l’App Store, ce qui évite des allers-retours de plusieurs semaines.
Cas concret : une boutique de démo montée avec le Toolkit
Sur une boutique de démonstration réalisée pour une marque textile de notre portefeuille, sur le thème Reformation, nous avons utilisé le Toolkit de bout en bout :
- fiches produit sans contenu en dur grâce à
shopify-custom-data: 5 types de metaobjets, 18 metafields produit et 4 metafields boutique ; - toutes les mutations de création de données validées avant exécution avec
shopify-admin; - sections, snippets et templates validés un par un avec
shopify-liquid, qui a détecté une vraie erreur (une clé de traduction en double) ; - chaque déploiement de thème montré et confirmé avant envoi via le Shopify CLI ;
- un premier tableau de bord (ventes, top produits, sessions, conversion sur 30 jours) avec
shopify-shopifyql.
La leçon principale : le validateur ne voit pas tout. Une limite de colonnes n’a été remontée qu’au moment de l’envoi. La recette visuelle, sur desktop et sur mobile, reste un travail humain.
Shopify AI Toolkit, Sidekick ou Shopify Magic : qui fait quoi ?
Shopify propose trois outils IA qui ne visent pas le même public. Les confondre mène souvent à de mauvaises attentes.
| Shopify AI Toolkit | Sidekick | Shopify Magic | |
|---|---|---|---|
| Pour qui | Développeurs et agences Shopify | Marchands | Marchands |
| Où | Dans l’assistant IA (Claude Code, Cursor…) | Dans l’admin Shopify | Dans les champs de l’admin |
| Ce qu’il fait | Code de thème, API, apps, Functions, opérations en masse, validation | Répond aux questions sur la boutique et guide les réglages | Génère des textes (fiches produit, e-mails) et retouche des images |
| Point fort | Tout ce qui demande du code ou du volume | Autonomie du marchand au quotidien | Rédaction rapide |
Notre répartition est claire : l’agence construit et automatise avec le Toolkit, le client gère son quotidien avec Sidekick et Magic. Nous revenons sur Sidekick dans notre article sur les nouveautés Shopify Spring 2026.
Les limites à connaître avant de laisser une IA toucher à votre boutique
Le Toolkit est puissant parce qu’il agit sur de vraies données. C’est aussi ce qui le rend risqué entre de mauvaises mains.
- Pas de retour arrière. Une modification exécutée sur la boutique est immédiate. Il n’y a ni prévisualisation ni annulation.
- Ce qui reste manuel. L’installation et la configuration des apps, les filtres Search & Discovery, les moyens de paiement, les domaines, la facturation et l’éditeur de checkout se règlent dans l’admin. Les mots de passe clients ne se migrent pas : il faut envoyer des invitations.
- Les limites d’API. L’API Admin GraphQL est plafonnée à 100 appels par seconde sur les plans Standard, 200 sur Advanced et 1 000 sur Shopify Plus. À anticiper pour toute synchronisation en masse.
- La télémétrie. Elle est activée par défaut et transmet à Shopify les noms d’outils, les requêtes et une partie des prompts. Elle se désactive avec la variable
OPT_OUT_INSTRUMENTATION=trueou un fichier~/.config/shopify-ai-toolkit/opt-out. - Ce que l’IA ne juge pas. Le rendu visuel, les tests de charge, la revue de sécurité, la conformité RGPD et la décision finale de Shopify à la soumission d’une app.
Les règles que nous appliquons sur chaque boutique
- Jamais de mot de passe, de clé d’API ou de jeton dans un message à l’IA.
- Un export complet de la boutique avant toute opération en masse.
- Un test sur quelques produits avant de lancer le reste.
- Chaque modification proposée par l’IA est relue et validée par un humain.
- Les thèmes sont modifiés sur une copie non publiée, versionnée avec git, puis recettés sur desktop et mobile avant publication.
Pourquoi le Shopify AI Toolkit ne remplace pas une agence Shopify
On nous pose souvent la question : si l’IA écrit le code Shopify et le valide, a-t-on encore besoin d’une agence Shopify ? Notre réponse est oui. Le Toolkit exécute vite ce qu’on lui demande, mais il ne sait pas ce qu’il faut demander.
Sur un projet, la valeur se joue avant et après le code : choisir entre natif, app ou développement, modéliser les données de l’ancien site en metafields et metaobjets, protéger le référencement pendant la migration, recetter, former les équipes. Sur nos migrations, nous constatons généralement zéro régression SEO et une hausse de 50 % du taux de conversion. Ces résultats viennent de la méthode et de l’expérience de l’équipe. Le Toolkit nous permet d’y consacrer plus de temps en retirant les tâches répétitives.
Ce qu’une agence Shopify experte de l’IA apporte en plus
- Le cadrage : Savoir ce que Shopify fait en natif évite d’empiler les apps et les abonnements.
- Les garde-fous : Des accès limités, des exports, des tests par lots, une validation humaine systématique.
- La maîtrise de toute la chaîne : UX, UI, intégration, développement, SEO et webmarketing avec des équipes certifiées Shopify et Shopify Plus.
- La relation dans la durée : Nous travaillons avec nos clients sur plusieurs années, ce qui permet de faire évoluer les automatisations avec leur activité.
Rendre l’IA accessible et performante dans les mains de nos clients
Notre objectif n’est pas de garder l’IA pour nous. À la livraison, nous montrons à nos clients comment utiliser Sidekick et Magic sur leur boutique, nous leur remettons des prompts adaptés à leurs tâches récurrentes et, quand leurs équipes veulent aller plus loin, nous les formons. Notre formation Shopify couvre la prise en main de la plateforme, et nos ateliers IA à Lyon apprennent à construire ses propres automatisations. Un client autonome sur son quotidien et une agence Shopify qui prend en charge le code, le volume et la sécurité : c’est l’organisation qui fonctionne le mieux chez nous.
Commerce agentique et GEO : préparer votre boutique aux agents IA
Le Toolkit arrive au moment où une part croissante des achats commence dans une IA conversationnelle. Le skill ucp permet d’ailleurs de tester le parcours d’achat d’une boutique « par agent IA » : recherche catalogue, panier, checkout et suivi de commande. Nous l’utilisons pour vérifier comment un agent perçoit le catalogue d’un client.
Une boutique bien codée n’est pas pour autant bien recommandée par ChatGPT, Gemini ou les AI Overviews de Google. Comme le résume Verity Score : « un store bien codé n’est pas forcément un store bien recommandé ». La visibilité dans les moteurs IA dépend de données produit complètes et structurées (métachamps renseignés, données schema.org, descriptions précises), et c’est justement ce que le Toolkit aide à produire à grande échelle. Notre pôle SEO et GEO s’appuie dessus pour auditer et enrichir les catalogues.
10 prompts prêts à l’emploi avec le Shopify AI Toolkit
Voici des demandes que nos équipes utilisent réellement, à adapter à votre boutique.
| Usage | Prompt |
|---|---|
| Cadrage | « Le client veut des lots « 3 achetés = 1 offert » : c’est natif sur Shopify ou il faut une app ? » |
| Données | « Voici l’export PrestaShop : propose le mapping vers les champs et metafields Shopify. » |
| Migration | « Crée les redirections 301 à partir de ce fichier d’anciennes URL. » |
| Recette | « Donne-moi la liste des produits actifs sans image, sans poids ou sans description SEO. » |
| Paramétrage | « Crée le marché Espagne en euros avec la traduction espagnole des menus. » |
| Reporting | « Ventes du mois par collection, comparées au mois dernier, en tableau. » |
| Metafields | « Affiche la composition et le pays d’origine du produit sous le bouton d’ajout au panier. » |
| Performance | « Vérifie que toutes les images du thème utilisent des tailles adaptées et le chargement différé. » |
| Function | « Crée une Function de remise : 3 articles achetés, le moins cher offert, validée avant déploiement. » |
| Migration d’API | « Vérifie que ces requêtes fonctionnent encore sur la dernière version de l’API Admin. » |
FAQ – Shopify AI Toolkit et agence Shopify
Qu’est-ce que le Shopify AI Toolkit ?
C’est le plugin officiel et open source de Shopify, lancé en avril 2026, qui connecte les assistants de code IA (Claude Code, Cursor, Codex, VS Code…) à la documentation Shopify, aux schémas d’API et au Shopify CLI. Il compte 22 skills dans sa version 1.8.4 et valide le code Liquid et GraphQL avant de l’exécuter.
Le Shopify AI Toolkit est-il gratuit ?
Oui, le Toolkit est gratuit et son code est public sur GitHub. Il faut en revanche un assistant IA compatible, dont l’abonnement est payant selon l’outil choisi, et un accès Admin à la boutique pour exécuter des opérations.
Faut-il savoir coder pour utiliser le Shopify AI Toolkit ?
Pas pour formuler une demande : on décrit le besoin en français. Il faut en revanche savoir relire ce que l’IA propose, comprendre l’impact d’une opération sur la boutique et appliquer des règles de sécurité. C’est pour cette raison que Shopify le destine aux développeurs et aux agences.
Quelle différence entre le Shopify AI Toolkit et Sidekick ?
Sidekick est l’assistant intégré à l’admin Shopify, pensé pour que le marchand gère son quotidien. Le Toolkit vit dans un outil de développement et sert à produire du code, des intégrations et des opérations en masse. Les deux se complètent.
Le Toolkit peut-il modifier ma boutique en production ?
Oui. Via le Shopify CLI ou le connecteur Shopify, il peut créer ou modifier produits, collections, clients, redirections et metafields. Ces modifications sont immédiates et sans retour arrière, d’où l’importance d’un export préalable, de tests par lots et d’une validation humaine.
Le Shopify AI Toolkit est-il utile pour une migration vers Shopify ?
C’est l’un de ses meilleurs usages : mapping des données de l’ancien site, import par l’API, création des redirections 301, contrôles qualité après import et reporting avant / après mise en ligne. La stratégie SEO de la migration et la recette restent du ressort de l’agence.
Pourquoi passer par une agence Shopify si l’IA sait coder ?
Parce que l’IA exécute ce qu’on lui demande sans savoir ce qu’il faut demander. Une agence Shopify apporte le cadrage (natif, app ou développement), la modélisation des données, la sécurité des opérations, la recette et la formation des équipes. Chez Dedi, le Toolkit nous fait gagner du temps sur la production, que nous réinvestissons dans le conseil.
Comment choisir une agence Shopify qui maîtrise l’IA ?
Demandez-lui comment elle utilise le Toolkit sur ses projets, quelles règles de sécurité elle applique avant une opération en masse, et comment elle rend ses clients autonomes après la livraison. Vérifiez aussi ses certifications Shopify et Shopify Plus et ses références de migration.
Vous voulez savoir ce que l’IA peut automatiser sur votre boutique Shopify ?
Nos équipes à Lyon analysent votre boutique, vos process et vos données pour identifier ce que le Shopify AI Toolkit, Sidekick et Magic peuvent prendre en charge, et ce qui mérite un accompagnement. Refonte, migration ou optimisation : parlons-en avec votre future agence Shopify.