MCP Epinium
Accès : Configuration → MCP
Le MCP Epinium permet à un assistant IA de consulter vos données Epinium directement, sans export ni développement. Vous pouvez lui demander en langage naturel quelles campagnes ont le pire ACOS ou sur quelles recherches part votre budget, et il répond avec vos chiffres réels.
Il repose sur le Model Context Protocol, un standard ouvert pour connecter des assistants à des sources de données. En interne il utilise l'API Epinium, il voit donc exactement les mêmes données et respecte les mêmes permissions.
C'est vous qui décidez s'il peut écrire
Par défaut, l'assistant ne fait que consulter. Les outils qui modifient quelque chose sont derrière des permissions d'écriture que vous cochez à la création de la clé -workflows:write pour vos automatisations, campaigns:write pour vos campagnes sur Amazon, tasks:write pour vos tâches, catalog:write pour vos clusters de mots-clés, vos prompts, votre identité de marque, les modifications de vos listings Amazon et vos nouvelles offres de produits, catalog:publish pour qu'il publie sur Amazon ce qui est en attente et que vous lui confirmez, et costs:write pour le coût de vos produits, leurs achats et vos dépenses propres- : si vous ne les donnez pas, ces outils n'existent pas pour lui. Dans vos boutiques Shopify et WooCommerce, c'est le même outil que celui avec lequel il consulte qui écrit aussi, et il ne le fait que si la clé porte platform:write : sans elle, toute tentative de modification est rejetée avant d'arriver à la boutique. Et l'écriture est réservée aux plans Business et Master : en Free et Guru, l'assistant consulte, mais ne peut rien modifier.
L'adresse du serveur
https://mcp.epinium.com/mcpVous la trouverez aussi dans Configuration → MCP, avec un bouton pour la copier.
Comment le connecter
Il y a deux façons de donner accès à l'assistant, et celle qui s'applique dépend du client que vous utilisez :
- Autorisation par navigateur : vous collez l'adresse du serveur, l'assistant vous amène sur Epinium, vous approuvez et c'est tout. Il n'y a aucune clé à copier, et vous pouvez retirer l'accès quand vous le souhaitez depuis Configuration → MCP.
- API key : vous créez une clé dans Configuration → API Keys et vous la collez dans la configuration du client. C'est la voie pour Claude Code et pour vos propres intégrations.
Claude (web et application de bureau)
- Ouvrez les réglages de connecteurs de Claude et ajoutez un connecteur personnalisé
- Collez
https://mcp.epinium.com/mcpcomme adresse du serveur - Claude vous amènera sur Epinium pour autoriser l'accès : vérifiez les permissions demandées et approuvez-les
- Vérifiez que cela fonctionne en lui demandant d'utiliser l'outil
epinium_whoami
Les connecteurs personnalisés nécessitent un abonnement payant à Claude.
Claude Code
Claude Code se configure en ligne de commande et utilise une API key au lieu de l'autorisation par navigateur :
claude mcp add --transport http epinium https://mcp.epinium.com/mcp \
--header "Authorization: Bearer TU_API_KEY"Remplacez TU_API_KEY par une clé créée dans Configuration → API Keys, avec les permissions que vous voulez accorder à l'assistant.
ChatGPT
Les connecteurs MCP de ChatGPT se trouvent dans le mode développeur (Réglages → Sécurité et connexion), et ils ne sont disponibles que sur les abonnements payants et depuis la version web.
- Activez le mode développeur dans Réglages → Sécurité et connexion
- Dans les réglages des connecteurs, ajoutez un nouveau connecteur
- Collez
https://mcp.epinium.com/mcpcomme adresse du serveur et laissez la méthode d'enregistrement telle quelle : le connecteur s'inscrit tout seul - ChatGPT vous amènera sur Epinium pour autoriser l'accès : vérifiez les permissions demandées et approuvez-les
- Vérifiez que cela fonctionne en lui demandant d'utiliser l'outil
epinium_whoami
Ce que vous avez connecté
Configuration → MCP liste les assistants que vous avez autorisés, avec quelles permissions, qui les a approuvés et quand. Vous pouvez y retirer l'accès à n'importe lequel : il ne peut plus consulter vos données immédiatement, et vous pourrez l'autoriser à nouveau plus tard si vous le voulez.
Les API keys se gèrent séparément, dans Configuration → API Keys.
Quels outils il inclut
L'assistant voit un outil par ressource atteinte par votre token. Les noms sont explicites, il suffit donc de demander ce que vous voulez en langage naturel.
| Groupe | Outils | Permission |
|---|---|---|
| Catalogue | Produits, leurs vues Seller, Vendor et Advertising, la catégorie de leur classement et, pour Vendor, leurs avis, marques, pays, clusters, prompts personnalisés et identité de marque | catalog:read |
| Performance catalogue | Métriques produit Seller et Vendor : ventes, trafic, frais Amazon et marge, retours, stock, jours de couverture et le sell-in Vendor | catalog:read |
| P&L avec coût produit | La cascade de votre compte jusqu'au bénéfice net, la marge par produit, par canal de vente, la publicité croisée et la fraîcheur des données, avec le coût produit et les dépenses propres si votre plan l'inclut | catalog:read |
| Dépenses propres | Vos dépenses propres (personnel, agence, 3PL, logiciels…) et leurs catégories | catalog:read |
| Structure publicitaire | Campagnes, ad groups, targets, product ads et termes de recherche | campaigns:read |
| Performance publicitaire | Métriques des cinq niveaux ci-dessus | campaigns:read |
| Portefeuilles | Vos portefeuilles et le plafond de budget que chacun impose à ses campagnes | campaigns:read |
| Écriture publicitaire | Créer et modifier campagnes, portefeuilles, ad groups, targets et product ads sur Amazon | campaigns:write |
| Configuration de l'optimisation | Ce que l'optimiseur poursuit sur une campagne : objectif, limites d'enchère, budget et quels workflows la traitent | campaigns:write |
| Automatisation | Vos workflows, leur configuration, les campagnes qu'ils atteignent et la performance de ces campagnes | workflows:read |
| Écriture de l'automatisation | Créer, copier, éditer, activer, mettre en pause, supprimer et restaurer des workflows, les lancer ou les simuler, et la prévision de ce qu'ils coûteraient | workflows:write |
| Changements de l'automatisation | Ce qu'un workflow a changé sur une campagne, avec l'effet net par entité | campaigns:read |
| Historique des modifications | Tout ce qu'Epinium a modifié sur Amazon, quelle qu'en soit l'origine, y compris ce qu'Amazon a refusé | campaigns:read |
| Connexions | Vos connexions : Amazon, Shopify et WooCommerce | connections:read |
| Boutiques connectées | epinium_platform_docs et epinium_platform_request : consulter ce qu'il y a dans vos boutiques Shopify et WooCommerce et, avec platform:write, créer, modifier et supprimer des produits et du contenu avec le même outil. L'écriture est directe, sans tâche, et certaines suppressions sont irréversibles | platform:read, et en plus platform:write pour écrire |
| Modifications des boutiques | epinium_list_platform_changes : tout ce qui a été écrit dans vos boutiques au cours des 12 derniers mois, y compris ce que la boutique a rejeté. Coûte 1 crédit par ligne renvoyée | platform:read |
| Tâches | Tâches Epinium et leurs items | tasks:read |
| Écriture des tâches | Créer des tâches avec des suggestions, les approuver ou les rejeter, les clôturer et appliquer ce qui a été approuvé, et demander à l'IA d'Epinium de réécrire jusqu'à 20 fiches (epinium_optimize_listings) | tasks:write |
| Écriture des clusters | Créer des clusters de mots-clés, leur ajouter ou retirer des mots-clés, des produits et des prompts, et les supprimer | catalog:write |
| Écriture des prompts | Créer et modifier les prompts personnalisés que l'IA suit pour rédiger vos fiches | catalog:write |
| Écriture de l'identité de marque | epinium_create_brand_identity et epinium_update_brand_identity : créer et modifier votre identité de marque, avec une fiche par concurrent | catalog:write |
| Modifications de listings | Préparer des modifications sur n'importe quel attribut de vos fiches, à partir de ce que vous lui dites dans le chat ou d'une feuille de calcul : retrouver leurs produits, associer chaque donnée à un attribut Amazon et valider les lignes sans rien enregistrer | catalog:read |
| Écriture des listings | Enregistrer en attente de publication les lignes d'une feuille, ou celles que vous lui dictez dans le chat | catalog:write |
| Nouvelles offres sur Amazon | epinium_search_amazon_catalog, epinium_search_amazon_product_types, epinium_list_amazon_shipping_templates, epinium_validate_listing_draft et epinium_list_listing_drafts pour rechercher le produit, choisir son type, valider la nouvelle offre et la suivre ; epinium_create_listing_draft et epinium_discard_listing_draft pour l'enregistrer en attente ou l'écarter. Offres, nouveaux produits et familles, en Seller comme en Vendor | catalog:read, et en plus catalog:write pour enregistrer et écarter |
| Publier sur Amazon | epinium_review_and_publish et epinium_list_pending_listing_changes pour voir ce qui est en attente de publication, modifications et nouvelles offres ; epinium_publish_listing_changes pour publier ce que vous lui confirmez, par le même chemin que le bouton Publier de l'application | catalog:read, et en plus catalog:write et catalog:publish pour publier |
| Écriture du coût produit | epinium_set_product_cost, epinium_preview_product_costs et epinium_import_product_costs : créer ou mettre à jour le coût unitaire et le coût d'expédition d'un produit, ou vérifier et importer ceux de nombreux produits à la fois depuis un fichier | costs:write |
| Achats | epinium_list_purchases, epinium_get_purchase, epinium_list_product_purchases et epinium_get_product_stock_group pour les lire ; epinium_record_purchase, epinium_update_purchase et epinium_delete_purchase pour les enregistrer, les corriger et les supprimer | catalog:read pour lire, costs:write pour écrire |
| Écriture des dépenses propres | Créer des dépenses une par une ou en lot, changer leur libellé, leur catégorie ou leur montant, les terminer et les supprimer, et gérer vos catégories | costs:write |
| Skills | Le CMO Brain : les 101 skills marketing d’Epinium | skills:read |
| Découverte | epinium_find_data : où se trouve chaque donnée. L'assistant lui demande un nom, un sigle ou un synonyme (BSR, ACoS, TACoS, Buy Box, marge) et il répond quel outil et quel champ la contiennent. Il ne lit pas vos données et ne consomme pas de crédits | n'importe lequel des précédents |
| Compte | epinium_whoami et la liste des comptes accessibles | toujours |
Seuls apparaissent les outils que votre token peut utiliser. Si vous créez une clé avec uniquement campaigns:read, l'assistant ne verra ni les outils de catalogue ni ceux de tâches : ils n'échouent pas, ils n'existent simplement pas pour cette clé.
CMO Brain : le cerveau marketing d'Epinium
En plus de vos données, le MCP sert le CMO Brain : 101 skills avec les méthodes qu'appliquerait un CMO, écrites pour qu'un assistant puisse les lire et les suivre. Elles couvrent de la publicité et du SEO au pricing, à la rétention, au contenu ou aux marketplaces, et l'assistant les consulte avant de vous conseiller.
La différence se voit : sans elles, un assistant répond avec ce qu'il a pu lire sur Internet ; avec elles, il suit les mêmes critères que nous et les applique à vos chiffres. Demandez-lui d'examiner une campagne au mauvais ACOS et il n'improvise pas un conseil générique : il charge la skill qui convient et la suit.
Elles nécessitent la permission skills:read, cochée par défaut à la création d'une clé.
Totaux du compte, par période et par famille de produits
Aux questions d'ensemble, comme « combien ai-je vendu en septembre ? », « comment a évolué ma dépense publicitaire mois par mois cette année ? » ou « comment se vendent les produits de mon cluster de cafetières ? », l'assistant répond en une seule requête. Les outils de métriques additionnent d'eux-mêmes par compte, par pays ou par connexion, découpent la plage en semaines, mois, trimestres ou années, et peuvent se limiter à un ou plusieurs de vos clusters de produits.
Il n'a ainsi pas à parcourir le catalogue produit par produit pour additionner, ce qui est lent et coûteux : le total d'un mois d'un gros compte coûte environ 150 crédits au lieu de plus de 17 000.
Quatre choses à garder en tête en lisant ses réponses :
- Chaque devise reste à part. Si vous vendez sur des marketplaces aux devises différentes, l'assistant reçoit un total par devise : les montants ne sont jamais convertis.
- Le stock ne s'additionne que par pays. L'inventaire paneuropéen FBA apparaît en entier sur chaque marketplace, donc un stock total du compte obtenu en additionnant les pays ne serait pas un chiffre réel. L'assistant ne le reçoit pas ; si vous le lui demandez, il vous le donne pays par pays.
- Par cluster, chaque produit compte dans tous les siens. Demandez-lui combien a vendu chaque cluster : il obtient la réponse en une seule requête ; un produit présent dans deux clusters s'additionne dans les deux, donc la somme des clusters n'est pas le total du compte.
- S'il commence à additionner produit par produit, on lui rappelle de ne pas le faire. Quand l'assistant demande une liste de métriques non regroupées et qu'il reste des pages, la réponse elle-même lui indique de regrouper au lieu de continuer à paginer.
Le P&L avec coût produit
Avec la permission catalog:read, l'assistant peut lire votre compte de résultat complet : le même que vous voyez dans Rentabilité → P&L, réparti sur dix outils -epinium_get_pnl_cascade, epinium_list_pnl_products, epinium_get_pnl_product, epinium_list_pnl_clusters, epinium_list_pnl_channels, epinium_list_pnl_ads_matrix, epinium_get_pnl_freshness, epinium_list_pnl_margin_leaks, epinium_get_pnl_category_medians et epinium_list_pnl_inventory-, avec le même calcul et les mêmes chiffres.
Ce qu'il voit dépend de votre plan. En Free et Guru, l'assistant atteint margin_before_ads -ce qui reste après Amazon, avant la publicité et avant le coût produit- et il ne l'appellera pas « profit », car ce n'en est pas un. En Business et Master, il va jusqu'au bout : marge de contribution, avec chaque ligne de coût produit et sa couverture, et vos dépenses propres jusqu'au bénéfice net. Les dépenses fixes concernent tout le compte : si vous en avez et filtrez par connexion, pays ou cluster, ou si votre token n'atteint pas toutes les connexions de vente, la cascade s'arrête à la marge de contribution et l'assistant sait pourquoi. Le champ includes_product_cost de chaque réponse lui dit lequel des deux il regarde, donc il n'a pas à le deviner selon que les chiffres correspondent ou non à ce que vous attendiez. Les deux outils de fuites de marge sont réservés à Business et Master : en Free et Guru ils renvoient une erreur 403, et l'assistant vous dira qu'elle est incluse dans Business et Master. Il en va de même pour epinium_list_pnl_inventory, le capital immobilisé dans les entrepôts d'Amazon, comme dans Inventaire. Leurs réponses ne portent pas includes_product_cost, car elles incluent toujours le coût. Si vous voulez agir sur une fuite, l'assistant vous propose de créer une tâche avec ces produits (avec la permission tasks:write), et ne la crée que si vous dites oui.
Cinq choses à savoir :
- C'est la seule partie du MCP qui convertit la devise. Les autres ressources répondent dans la devise où chaque montant s'est produit ; ici, l'assistant demande une
currencyet tout y est converti, au taux de change du jour où chaque montant s'est produit. breakeven_acos, dans les métriques Seller, est le plafond d'ACOS que vous pouvez vous permettre de dépenser en publicité avant de perdre de l'argent sur ce produit, calculé avec votre marge et votre coût réels -jamais avec un pourcentage de commission supposé. Il ressortnull-jamais un chiffre inventé- si le produit n'a pas de coût complet, n'a rien vendu sur la période, a son coût enregistré dans une devise différente de celle de sa propre marketplace (cette donnée ne convertit pas les devises), ou si votre plan n'inclut pas le coût produit (Free et Guru).- Le coût produit n'est pas supprimé en cas de rétrogradation de plan. Si vous passez en Guru, le coût déjà chargé reste là : il cesse simplement d'être servi, et revient dès que vous remontez de plan.
- Il peut être restreint à vos clusters de produits, et comparer les clusters entre eux. La cascade, le tableau par produit, le tableau par cluster et la fraîcheur acceptent un ou plusieurs clusters. Dans le tableau par cluster, un produit présent dans deux clusters compte dans les deux. La publicité ne compte alors que la dépense de ces produits : Sponsored Brands et les dépenses de campagne qui ne correspondent à aucun produit précis sont exclus, car ils n'appartiennent à aucun cluster.
- Il voit aussi le coût de chaque produit dans le catalogue. En listant vos produits, l'assistant voit le coût du produit et le coût d'expédition valables aujourd'hui, et peut ne garder que ceux sans coût, ou ceux sans coût qui se sont vendus ces 30 derniers jours, pour vous dire lesquels compléter en premier. C'est la même chose que dans Coûts et dépenses.
Lui demander ce qu'a fait votre automatisation
Avec la permission workflows:read, l'assistant peut auditer vos workflows, et c'est l'une des choses qu'il fait le mieux : ce sont des questions de croisement de données, celles qui prennent un après-midi à la main.
Vous pouvez lui demander trois choses différentes :
- Comment un workflow est configuré — sa planification, son diagramme et chaque variable avec la valeur qu'elle porte réellement, en signalant celles que vous avez modifiées face à celles qui gardent la valeur du modèle. C'est la façon rapide de vérifier un réglage sans ouvrir l'éditeur.
- Quelles campagnes il atteint réellement — ce qui n'est pas la même chose que les campagnes qui lui sont liées. Un workflow peut être planifié chaque nuit et n'en traiter aucune ; c'est la question qui le révèle, et quand l'ensemble revient vide l'assistant vous en donne la raison.
- Ce qu'il a changé sur une campagne — l'enchère de départ de chaque target face à celle qu'il a maintenant, le nombre de fois où elle a bougé en chemin, et le motif du dernier changement.
Ce qui vaut vraiment le coup, c'est de le combiner avec les métriques de la même période : « qu'est-ce que le workflow a changé sur cette campagne ce mois-ci et comment a évolué l'ACOS ? » est une seule question, et l'assistant possède les deux moitiés. C'est là qu'il peut vous dire si les changements servent à quelque chose ou ne font que déplacer des enchères.
Deux choses à garder en tête en lisant sa réponse :
- Les changements arrivent en net, pas en liste. Un target monté puis redescendu la même nuit apparaît comme aucun changement net, deux mouvements. C'est volontaire : une liste de décisions brute masque précisément cela.
- Il ne voit jamais les simulations. Uniquement les changements qui ont réellement atteint Amazon, et seulement des 90 derniers jours, durée de leur conservation.
Lancer un workflow, ou le simuler d'abord
Avec la permission workflows:write, l'assistant ne se contente pas de lire vos automatisations : il peut aussi les exécuter. C'est utile quand vous ne voulez pas attendre l'heure programmée —vous venez de modifier un réglage et vous voulez en voir l'effet— et quand vous voulez vérifier un nouveau workflow avant de le laisser tourner seul.
Deux choses à demander avant de lancer pour de vrai :
- Combien cela coûterait — l'assistant peut vous donner la prévision sans rien exécuter. Cela vaut la peine pour tout workflow qui parcourt votre catalogue ou vos campagnes : le coût augmente avec le nombre d'éléments traités, donc un diagramme de douze étapes peut revenir cher sur un grand compte. C'est un plafond, pas une facture ; et si une étape ne peut pas être prévue, elle ressort avec zéro élément et l'assistant vous le signale.
- Qu'il simule d'abord — une simulation parcourt tout le diagramme et n'écrit rien : ni sur Amazon, ni dans vos données. Elle vous dit ce qu'il aurait fait, sans le faire.
Un workflow en pause peut aussi être simulé, et c'est précisément la raison d'être de la simulation. Vérifier une automatisation avant de l'activer ne devrait pas vous obliger à l'activer d'abord, ce qui est l'étape risquée. Pour l'exécuter réellement, il doit en revanche être actif, exactement comme dans l'application.
Deux choses à garder en tête :
- Il n'attend pas la fin de l'exécution. Lancer renvoie l'identifiant de l'exécution, pas son résultat : un passage sur des dizaines de campagnes prend bien plus de temps qu'une réponse de l'assistant. Le résultat se consulte ensuite, et l'assistant sait le faire.
- Lancer pour de vrai modifie les enchères et les budgets sur Amazon. Simuler et exécuter sont deux demandes différentes et l'assistant doit dire laquelle il fait. S'il ne le dit pas, demandez-le avant de confirmer.
Créer et éditer des automatisations depuis l'assistant
La même permission workflows:write permet à l'assistant de construire et de modifier vos automatisations, pas seulement de les exécuter. Il peut en créer une de zéro, copier une que vous avez déjà, partir d'un modèle du catalogue d'Epinium, changer son diagramme ou ses réglages, lui donner un horaire, l'activer, la mettre en pause, la supprimer et revenir à une version antérieure.
Tout ce qui est créé naît en pause, par chacune des trois voies —créer, copier ou instancier un modèle—. L'activer est toujours une étape à part que vous devez demander : à partir de là, son horaire se déclenche pour de vrai chaque nuit.
Quatre choses à savoir :
- Pour éditer un workflow programmé, il faut d'abord le mettre en pause. L'assistant vous le dira : mettre en pause, faire le changement, regarder le résultat et réactiver. La mise en pause, elle, est toujours acceptée —elle ne peut que faire arriver moins de choses sur Amazon, jamais plus—.
- Copier vaut mieux que refaire. Si vous voulez la même logique avec d'autres valeurs, demandez-lui de copier l'automatisation et de ne changer que ce qui change. C'est moins cher et plus fiable que de reconstruire le diagramme pas à pas. La copie naît en pause et sans campagnes attachées : les attacher se fait dans Epinium.
- La suppression est la seule chose qu'il vous fera confirmer. Elle est annoncée à l'assistant comme une opération destructive, donc votre client d'IA vous demandera avant. Les autres ne le font pas, volontairement : si tout demandait confirmation, vous finiriez par accepter sans lire. Ce qui protège vraiment, c'est que rien ne naisse activé et que simuler et exécuter soient deux requêtes distinctes.
- Un diagramme invalide n'est pas enregistré. Il est vérifié avant l'écriture, donc une édition ne peut pas laisser votre automatisation à moitié faite : soit le changement passe en entier, soit il vous dit ce qui ne va pas et ne touche à rien.
Chaque écriture est enregistrée : ce qui a changé, quand et avec quelle identification. La suppression aussi, qui laisse une trace même si l'automatisation n'existe plus, et les exécutions, qui gardent qui les a demandées. Dans l'historique de versions de chaque workflow, on distingue ce qu'a fait un assistant de ce qu'a fait une personne dans l'application, et vous pouvez revenir à n'importe quelle version enregistrée.
Si vous préférez le voir ou y toucher à la main, tout cela vit dans Processus → Workflows.
Si l'automatisation écrit dans votre boutique Shopify ou WooCommerce, la clé a aussi besoin de platform:write pour l'enregistrer, la copier, l'activer ou l'exécuter pour de vrai. La simuler, la mettre en pause ou la renommer ne le demande pas. Plus d'informations dans Lire et écrire dans votre boutique.
Tableaux interactifs
Quand vous lui demandez une liste — produits, campagnes, termes de recherche… — l'assistant peut l'afficher sous forme de tableau dans la conversation, au lieu de texte.
Avec ce tableau, vous pouvez :
- Charger plus de lignes sans consommer de tours de l'assistant. Le tableau demande les pages suivantes tout seul : parcourir un catalogue long ne consomme pas de conversation.
- Ouvrir une ligne pour voir son détail complet, y compris les champs qui ne tiennent pas dans le tableau.
- Sélectionner plusieurs lignes et les transmettre à l'assistant avec le bouton Use N in chat. Ensuite il ne raisonne que sur celles-là : vous choisissez six produits sur deux cents et vous l'interrogez dessus, sans copier un seul ASIN.
Quand l'assistant peut écrire
Avec la permission campaigns:write, l'assistant ne fait plus que regarder : il crée des campagnes et déplace enchères, budgets et états réellement, sur Amazon. Accordez-la en connaissance de cause, et seulement à la clé qui en a besoin.
Ce que l'assistant sait lui-même, parce que les outils le lui disent :
- Ce qu'il crée naît en pause sauf demande contraire, et il doit vous prévenir avant d'activer quoi que ce soit : une campagne active commence à dépenser dès qu'Amazon l'accepte.
- Il peut archiver, et il vous demandera d'abord. Archiver est la seule opération irréversible : elle a son propre outil et est annoncée à l'assistant comme destructrice, donc votre client IA vous demandera confirmation avant de l'exécuter. Pour seulement arrêter la dépense, demandez-lui de mettre en pause.
- Pour déplacer beaucoup d'enchères, il utilise l'outil de lot, pas l'outil unitaire en boucle. Un seul lot accepte jusqu'à 1000 entités, chacune avec sa valeur.
- Un lot peut revenir partiel, et c'est le cas normal. L'assistant reçoit une ligne par entité et un compteur de ce qui est arrivé chez Amazon ; s'il ne lit pas ce compteur, il supposera que tout est passé. S'il vous dit qu'un changement a été appliqué, vous pouvez lui demander le détail.
- Il gère aussi les portefeuilles. Il peut les créer, changer leur nom, leur état et leur plafond de budget, et y faire entrer ou en sortir des campagnes Sponsored Products. Le plafond limite ce que dépensent ensemble toutes les campagnes du portefeuille : y toucher déplace la dépense de toutes à la fois.
- Il écrit aussi dans Sponsored Brands et Sponsored Display. Il peut modifier et archiver leurs campagnes, ad groups, targets et product ads, et créer leurs targets et négatifs, avec les types qu'accepte l'ad product de l'ad group. Ce qu'il ne peut pas encore faire, c'est créer des campagnes SB ou SD. Et pour les targets
AUDIENCE,CONTENT_CATEGORYetLOCATION, il a besoin de l'id Amazon, que vous devrez lui fournir depuis la console Amazon Ads.
Tout ce qu'il écrit est enregistré avec son origine : dans l'historique des changements, cela apparaît comme mcp, avec la credential qui l'a fait. C'est ainsi qu'on distingue ce qu'a fait un assistant de ce qu'a fait une personne dans l'application.
Configurer l'optimisation d'une campagne
Avec la même permission campaigns:write, l'assistant peut aussi lire et changer la configuration qu'utilise l'optimiseur d'Epinium sur une campagne : son objectif, les limites d'enchère, le budget mensuel, les overrides de harvesting et quels workflows la traitent.
Ce n'est pas la même chose qu'écrire sur Amazon, et mieux vaut l'avoir clair : cette configuration reste à l'intérieur d'Epinium - l'optimiseur la consomme lors de son passage de chaque nuit - donc l'outil ne demande pas de clé d'idempotence et ne laisse pas de ligne dans l'historique des changements d'Amazon, puisqu'il ne l'atteint jamais.
Vous pouvez lui demander des choses comme « mets l'objectif de cette campagne à ACOS 15 % », « monte le plafond d'enchère à 0,80 € » ou « retire cette campagne du workflow X », et l'assistant traduit cela dans la configuration correspondante. Avant de toucher à quoi que ce soit, il peut aussi vous donner les valeurs actuelles.
Ce qui mérite vraiment d'être confirmé avant d'accepter :
- Assigner un workflow à la campagne est ce qui la place sous l'optimiseur - pas
aiEnabled, qui n'est que le consentement du titulaire du compte et part vers Amazon comme un tag, ni aucun autre réglage de ce bloc. Si l'assistant s'apprête à lier la campagne à un workflow, confirmez-le d'abord : dès cette nuit, ce workflow déplace de vraies enchères sur Amazon sur elle. Un workflow à sélection automatique peut aussi la récupérer de lui-même sauf si la campagne a décliné cette sélection, et la liste d'exclusion est la seule chose qui la retire avec certitude. - Un changement par lot n'est pas tout-ou-rien. Si vous lui demandez d'appliquer le même réglage à plusieurs campagnes, il reçoit une ligne de résultat par campagne - chacune validée contre son propre état enregistré - donc l'une peut échouer pour une raison précise pendant que les autres passent. Demandez-lui le détail si quelque chose ne colle pas.
Proposer des changements sous forme de tâches
Avec la permission tasks:write, l'assistant peut vous laisser ses propositions sous forme de tâche au lieu de les appliquer lui-même : il analyse, crée la tâche avec une suggestion par changement, et vous l'examinez dans Processus → Tâches ou vous la lui faites résoudre depuis la conversation. C'est la façon de laisser un assistant travailler sur votre compte sans que rien n'arrive sur Amazon sans que vous l'ayez vu.
Quatre choses à savoir :
- Approuver et appliquer sont deux étapes. Approuver une suggestion ne fait qu'enregistrer votre décision ; ensuite vous lui demandez d'appliquer la tâche. Ceux de campagne arrivent sur Amazon immédiatement et l'assistant sait lesquels Amazon a acceptés ; ceux de produit sont mis en file d'attente et restent en attente de publication : ils n'arrivent sur Amazon que lorsque vous les publiez.
- Il vous demandera avant d'appliquer, comme avant de clôturer une tâche : les deux sont annoncées à l'assistant comme des opérations qui demandent confirmation, car appliquer modifie vraiment vos campagnes et vos fiches, et clôturer ne se défait pas.
- Toutes les suggestions ne s'appliquent pas. Aujourd'hui, on applique celles de produit et celles de campagne -budget quotidien, état et nom-. Les autres restent des notes à lire : les approuver ne change rien, et l'assistant le sait.
- Clôturez la tâche à la fin. Ce qui est encore en attente à la clôture reste figé et ne peut plus être approuvé.
Les tâches créées par l'assistant apparaissent dans votre liste avec l'origine API et assistants, et chaque décision garde la credential avec laquelle elle a été prise.
Réécrire vos fiches avec l'IA d'Epinium
Avec la permission tasks:write, l'assistant peut demander à l'IA d'Epinium de réécrire vos fiches Seller ou Vendor : le titre avec ses points forts, les puces, la description et les termes de recherche, de 1 à 20 produits à la fois. C'est la même IA que dans l'application, elle suit donc les clusters de mots-clés de chaque produit, les prompts qui leur sont liés et votre identité de marque. Il le fait avec l'outil epinium_optimize_listings.
Trois choses à savoir :
- Il vous laisse des suggestions, pas des modifications. Le résultat va dans une tâche, celle de l'onboarding, dans Processus → Tâches. Les suggestions apparaissent au fur et à mesure qu'elles sont générées, et l'assistant vous les montre quand elles sont prêtes.
- Approuver, appliquer et publier. Vous approuvez ou rejetez chaque suggestion, dans la conversation ou dans l'application, et appliquer la tâche laisse les modifications en attente de publication : elles n'arrivent sur Amazon que lorsque vous les publiez, depuis l'application ou depuis le chat.
- C'est gratuit jusqu'à 20 produits. La réécriture ne consomme pas vos crédits : c'est Epinium qui la paie, avec un plafond de 20 produits par compte au total. Chaque produit lancé compte, y compris s'il est répété ou si sa génération échoue ; l'assistant convient donc avec vous des produits et des champs avant de la lancer et n'en répète aucun sauf si vous le lui demandez. Une fois le plafond atteint, il vous dira qu'il n'en reste plus, sans rien générer. Approuver ou rejeter les suggestions est facturé comme dans n'importe quelle tâche.
Créer, modifier et supprimer des clusters de mots-clés
Avec la permission catalog:write, l'assistant peut enregistrer ce qu'il trouve sous forme de cluster de mots-clés, les mêmes que vous gérez dans Segmentation → Clusters : demandez-lui de regrouper quelques produits avec les mots-clés sur lesquels ils devraient se positionner ou être annoncés, et il crée le cluster ou en étend un que vous avez déjà. Rien n'arrive sur Amazon : un cluster vit dans Epinium, où vos prompts SEO, la découverte de mots-clés de l'optimiseur et le filtre par cluster des graphiques produit le reprennent.
Quatre choses à savoir :
- Il modifie par deltas. Il ajoute ou retire des mots-clés et des produits, ou renomme le cluster, sans renvoyer la liste entière ; un mot-clé qu'il ajoute à nouveau est mis à jour, pas dupliqué.
- Il respecte votre cadenas. Un cluster que vous avez protégé depuis l'application lui est refusé, et l'assistant sait qu'il doit vous demander de le déprotéger plutôt que de réessayer.
- Il peut supprimer, et il vous le demandera d'abord. La suppression d'un cluster ne s'annule pas : l'outil est donc annoncé comme destructif et votre client d'IA vous demande de confirmer. Elle est refusée tant que le cluster est protégé ou qu'une smart campaign l'utilise comme base.
- Il ne vous demandera pas de confirmation pour créer ou modifier, précisément parce qu'aucune enchère, aucun budget ni aucune fiche ne bouge. Le cluster est créé au nom de la personne qui a autorisé l'assistant, et il ne peut lier que des produits de catalogue (Seller ou Vendor) du compte.
Écrire les prompts avec lesquels vos fiches sont rédigées
Avec la même permission catalog:write, l'assistant peut rédiger vos prompts personnalisés, ceux de votre bibliothèque de prompts, et indiquer à chaque cluster lesquels utiliser : demandez-lui, par exemple, un prompt au ton premium pour les puces et de le lier au cluster de vos produits haut de gamme. La prochaine fois que le contenu des produits de ce cluster sera généré, l'IA d'Epinium suivra ces instructions.
Trois choses à savoir :
- Un prompt ne change rien à lui seul. L'enregistrer ne touche pas Amazon et ne réécrit aucune fiche : il s'applique lors de la génération du contenu, et seulement pour les produits des clusters auxquels il est lié.
- Un prompt par champ. Chaque prompt indique à quels champs il s'applique -titre et points forts, description, puces ou termes de recherche- ou vaut pour tous. Si plusieurs prompts des clusters d'un produit valent pour le même champ, un seul est utilisé.
- Il crée et modifie, mais ne supprime pas. Pour retirer un prompt d'un cluster, il suffit de le délier ; le prompt reste dans votre bibliothèque. Les prompts sont créés au nom de la personne qui a autorisé l'assistant, et ils comptent dans le quota de prompts de votre plan.
Votre identité de marque et vos concurrents
Avec la permission catalog:write, l'assistant peut créer et modifier votre identité de marque, celle de Paramètres → Marque : le nom, le secteur, vos sites web, vos observations sur le ton et le public, et les marques de votre catalogue qu'elle couvre. C'est le contexte que l'IA d'Epinium utilise pour rédiger vos fiches.
Il enregistre aussi une fiche par concurrent, jusqu'à 50 : son nom, son site web ou sa boutique, les ASIN avec lesquels il vous concurrence (jusqu'à 20), son prix par rapport au vôtre (inférieur, similaire ou supérieur) et sa dangerosité (faible, moyenne ou élevée), toujours avec le motif qui la justifie dans vos données : recherches partagées, Buy Box perdues, prix ou avis. S'il n'y a pas encore de preuves, il laisse la dangerosité vide.
Trois choses à savoir :
- Les fiches de concurrents ne s'affichent pas encore dans l'application. C'est l'assistant qui les enregistre et les lit ; Paramètres → Marque ne les affiche pas encore. Les sites web de concurrents que vous aviez déjà sont conservés à part.
- En modification, il réécrit toute la liste. Pour ajouter un concurrent, il envoie ceux qui existaient plus le nouveau, il lit donc d'abord ceux qui existent. Les valeurs précédentes ne sont conservées nulle part, c'est pourquoi votre client d'IA vous demande confirmation avant de modifier.
- Rien n'arrive sur Amazon. Enregistrer l'identité de marque ne touche ni ne réécrit vos fiches, et l'assistant ne peut pas la supprimer.
Modifier vos listings Amazon, dans le chat ou avec une feuille
Avec la permission catalog:write, l'assistant enregistre des modifications sur n'importe quel attribut qu'Amazon permet de modifier pour le type de produit de chaque fiche, en Seller comme en Vendor. Vous pouvez les lui demander de deux façons, et les deux aboutissent au même résultat :
- Dans le chat, de façon interactive : vous lui indiquez la modification et il recherche les produits, vous interroge sur ce qui n'est pas clair et la prépare. « Mets la matière en coton sur ces 12 SKUs » ou « raccourcis le titre de ce produit à 75 caractères ».
- Avec une feuille, en masse : vous lui passez un fichier Excel ou CSV avec une ligne par produit. La matière de 200 SKUs, les données de piles qui manquent à la moitié du catalogue ou les puces de toute une gamme.
Rien n'arrive sur Amazon sans vous. Ce qu'il enregistre reste en attente de publication, comme une modification faite à la main : vous le voyez dans l'onglet Propriétés de chaque produit et dans Publier les modifications du catalogue. Cela part vers Amazon lorsque vous le publiez depuis cet écran ou, si sa clé a catalog:publish, lorsque l'assistant vous montre la liste et que vous lui confirmez de la publier. Avant d'être enregistré, il passe la même validation que n'importe quelle autre modification.
Comment lui transmettre les modifications
- Une feuille de calcul (.xlsx, .xls ou .csv). Dans les chats de Claude, web et application de bureau, et dans ChatGPT, l'assistant vous affiche une zone où la déposer, et le fichier part directement vers Epinium sans passer par la conversation. Dans Claude Code et dans Cowork, cette zone n'apparaît pas : l'assistant lit le fichier et enregistre lui-même ses lignes, et au-delà d'environ 1 000 lignes il vous proposera de le faire depuis un chat de Claude, ce qui est plus rapide.
- Un message. « Mets la matière en coton sur ces 12 SKUs » fonctionne aussi, même pour tous les produits d'un pays : l'assistant les recherche si besoin et transforme votre demande en lignes, sans vous demander de fichier.
Les trois étapes
- Préparer. Il recherche les produits par leur SKU, leur ASIN ou leur EAN sur la marketplace que vous lui indiquez, et regarde quels attributs ils acceptent. Il associe ensuite chaque colonne à un attribut Amazon, laisse de côté celles qui ne concernent que vous, comme le coût ou des notes, et ne vous interroge que sur les colonnes douteuses. Si la feuille n'a pas de colonne de pays, il vous demande la marketplace : il ne la devine jamais. Si un ASIN ou un EAN correspond à plusieurs SKUs, la modification s'applique à tous, et il vous le signale. Avec l'EAN, les fiches dont Epinium ne connaît pas l'EAN ressortent comme introuvables : utilisez le SKU ou l'ASIN.
- Valider. Il vérifie chaque ligne avec les règles d'Amazon de son type de produit, sans rien enregistrer. Il vous dit ce qui bloque et ce qui n'est qu'un avertissement, avec les valeurs qu'Amazon accepte, et si une valeur est fausse sur de nombreuses lignes, il vous propose de la corriger en une seule fois.
- Enregistrer. Il valide à nouveau le tout et enregistre les lignes valides comme modifications en attente. Celles qui ne passent pas ne sont pas enregistrées, et l'assistant vous dit lesquelles et pourquoi.
Les colonnes qu'il comprend
- Une colonne par attribut, avec l'en-tête de votre choix (« Matière », « Poids de l'article ») : l'assistant l'associe à l'attribut Amazon.
- Des parties d'un attribut. Certains attributs regroupent plusieurs données, comme
battery, avec la composition de la pile et son poids. Chaque donnée peut avoir sa propre colonne : une colonne « Composition de la pile » ne renseigne quebattery.cell_composition. - Les unités. Elles se déduisent de l'en-tête, comme dans « Poids (kg) », ou vous les indiquez à l'assistant.
- Les attributs à plusieurs entrées, comme les puces : une colonne par position, « Puce 1 », « Puce 2 », etc.
- Les valeurs sont prises telles que vous les écrivez. Il comprend la virgule décimale et les dimensions comme
19 x 11 x 8, mais ne traduit pas : le texte est enregistré dans la langue de la feuille. - Le prix passe aussi par ici, par audience : consommateurs et entreprises. Les règles et la façon d'effacer une valeur sont dans Le prix.
Le prix
- Ce que vous pouvez modifier. Côté Seller, pour les consommateurs (
ALL) et pour les entreprises (B2B) : le prix, le minimum, le maximum et le prix promotionnel avec ses dates de début et de fin. Chaque colonne de prix est associée à une audience et à un champ. Si l'en-tête n'indique pas l'audience, l'assistant vous la demande. - Les règles sont les mêmes pour les consommateurs et les entreprises. Il y a toujours un prix consommateur ; le prix reste entre le minimum et le maximum ; le minimum ne dépasse pas le maximum ; pas de minimum ni de maximum sans prix ; la promotion reste entre le minimum et le maximum et ne dépasse pas le prix (l'égalité est permise) ; le début de la promotion précède sa fin et la fin n'est pas antérieure à aujourd'hui ; aucun montant n'est égal à 0 ni négatif. Une promotion dont la fin est déjà passée compte comme une absence de promotion.
- Seul ce que la ligne introduit bloque. Un produit qui enfreignait déjà une règle n'est pas bloqué pour cela : c'est la ligne qui ajoute le problème qui est bloquée. L'exception : si la ligne modifie le prix d'un produit dont le prix enregistré enfreint déjà une règle (par exemple, un prix consommateur hors de son minimum ou de son maximum), elle est bloquée et il faut d'abord corriger ce prix dans l'application.
- Terminer une promotion plus tôt. Mettez sa date de fin à aujourd'hui. La promotion se termine à 0 h de la date de fin : « Fin promotion » est donc le premier jour sans promotion.
- Une cellule vide ne change jamais rien. Pour effacer une valeur, l'assistant vous pose la question une fois par colonne (« il y a 40 cellules vides dans « Minimum » sur des produits qui ont un minimum : je les laisse ou j'efface le minimum ? ») et n'efface que si vous confirmez.
- Ce qui ne peut pas être effacé. Le prix consommateur ne s'efface pas. Effacer le prix entreprises supprime toute l'offre entreprises, avec son minimum, son maximum et sa promotion.
- Une promotion incomplète est bloquée. Un prix promotionnel avec des dates mais sans montant, ou des dates qui ne sont pas de vraies dates, ne sont pas enregistrés. Si les dates sont ambiguës, l'assistant vous demande l'ordre (jour/mois ou mois/jour).
- La devise n'est pas convertie. Les montants sont enregistrés dans la devise du marketplace ; si la feuille en apporte une autre, l'assistant vous le demande et ne convertit jamais. Un montant écrit en texte avec plus de 2 décimales (« 1.299 € ») est rejeté, pour ne pas lire un séparateur de milliers comme des décimales ; une cellule numérique de la feuille est arrondie à 2 décimales, comme vous la voyez dans la feuille.
- Le premier prix se fixe dans l'app. Un produit qui n'a pas encore de prix consommateur dans Epinium ne peut pas en recevoir un depuis un fichier, car la devise vient de cette offre : fixez-le depuis Prix.
- Reste en attente jusqu'à la publication. Comme le reste, le changement de prix reste en attente jusqu'à Publier les modifications, et supprimer un prix promotionnel arrive aussi sur Amazon à la publication.
Données qui vont ensemble
Certaines valeurs obligent à en renseigner d'autres : si un produit est désormais livré avec des piles, Amazon demande aussi leur type, leur composition et leur nombre. Epinium détecte ces cas à la validation, et l'assistant vous montre chaque combinaison -le type de produit, la valeur qui la déclenche, ce qu'apporte la feuille et sur combien de lignes- et vous demande quoi en faire :
- Si vous la confirmez dans le chat, elle est enregistrée avec le reste de la ligne.
- Si vous ne la confirmez pas, ou s'il manque des données à la ligne, ces modifications partent dans une tâche, dans Processus → Tâches, avec le nom du fichier, pour qu'une personne les révise et les approuve. Le reste de la ligne est enregistré quand même.
L'assistant ne considère jamais une combinaison comme confirmée sans que vous le lui disiez.
Plusieurs pays et Vendor
- Une feuille avec plusieurs pays. Avec une colonne de pays, chaque ligne va vers le sien. Il reconnaît le code (
ES,UK), le domaine (amazon.es), l'ID de marketplace et le nom du pays dans sa langue, en anglais ou en espagnol. Une ligne avec un pays qu'il ne reconnaît pas est rejetée : il ne le devine jamais. Dans un pays où vous n'avez pas de connexion, les lignes ressortent comme introuvables, sans bloquer le reste. - Chaque pays se confirme séparément. Les règles d'Amazon changent d'une marketplace à l'autre : confirmer les piles au lithium en Espagne ne les confirme pas en France.
- Chaque pays, dans sa langue. Les valeurs ne sont pas traduites : mettez « papel » sur la ligne de l'Espagne et « papier » sur celle de la France.
- Vendor. Avec une colonne de vendor code, chaque ligne va vers ce vendor code. Si une ligne sans vendor code correspond à des fiches de plusieurs vendor codes dans un pays, l'assistant vous demande s'il doit enregistrer la modification sur toutes ; si vous ne confirmez pas, ces lignes restent de côté. Côté Vendor, aucun prix ne se modifie depuis un fichier, ni le prix de revient ni le prix catalogue : ces colonnes sont laissées de côté et le reste de la ligne est enregistré.
Limites et crédits
- Jusqu'à 5 000 lignes et 8 Mo par fichier, tous pays confondus, et jusqu'à 250 colonnes.
- Le fichier est conservé 7 jours. Pour enregistrer ses lignes, il doit lui rester au moins un jour ; sinon, importez-le à nouveau.
- Un fichier ne s'enregistre qu'une fois. On ne peut pas l'enregistrer à nouveau avec d'autres réglages : si quelque chose n'allait pas, corrigez la feuille et importez-la de nouveau. Si un produit apparaît sur plusieurs lignes, c'est la dernière qui compte.
- Il coûte 5 crédits par ligne. Au départ, les lignes du fichier sont réservées et, si votre solde ne suffit pas, rien n'est enregistré. À la fin, seules les lignes enregistrées ou envoyées dans la tâche sont facturées, et le reste est restitué. Envoyer la feuille, la préparer et la valider ne coûte rien. Les tarifs se trouvent dans Configuration → Crédits.
- Réservé aux plans Business et Master, comme toute écriture.
Créer de nouvelles offres sur Amazon
Avec la permission catalog:write, l'assistant met aussi en vente des produits qui ne sont pas encore dans votre compte Amazon : une offre à vous sur un produit qui existe déjà (en Seller), un nouveau produit ou une famille de variations avec son parent et ses enfants, en Seller comme en Vendor. Il recherche le produit, le vérifie avec les règles d'Amazon et l'enregistre comme nouvelle offre en attente, qui part vers Amazon lorsque vous la publiez.
Ce qu'il va vous demander, comment se publie une famille, ce qui change en Vendor et combien ça coûte se trouvent dans Nouvelles offres de produits.
Vérifier et publier depuis le chat
Dans les chats de Claude, web et bureau, et dans ChatGPT, l'assistant ouvre la fenêtre Review and publish dans la conversation. C'est la même chose que Publier les modifications dans l'application :
- Trois onglets : Changes, New listings et Publications, avec des filtres par connexion et par pays et une recherche par SKU ou ASIN.
- Vous publiez ce que vous cochez, et dans Publications vous suivez si Amazon l'accepte, y compris les nouvelles offres en cours d'importation dans Epinium.
- Pour publier depuis la fenêtre, il faut la permission
catalog:publish(sur l'écran des permissions, Publier sur Amazon), en plus decatalog:write. Sans elle, la fenêtre vous montre ce qui est en attente mais ne permet pas de publier. Une autorisation que vous aviez déjà ne la reçoit pas toute seule : autorisez à nouveau l'assistant. - Dans Claude Code et Cowork, la fenêtre n'apparaît pas. L'assistant vous montre ce qui va partir, par connexion et par pays, et ne publie que si vous dites oui.
- Publier ne s'annule pas. Une erreur se corrige en publiant la valeur précédente.
Écrire le coût d'un produit
Avec la permission propre costs:write -pas catalog:write, qui est pour les clusters, les prompts et les listings- l'assistant crée ou met à jour le coût d'un produit avec epinium_set_product_cost : la même action que vous faites sur la fiche du produit ou en important le modèle CSV de coûts, avec la même sémantique. Pour de nombreux produits à la fois, il utilise l'import.
Quatre choses à savoir :
- La sémantique est celle du CSV. Si vous lui demandez seulement de changer le coût unitaire, le coût d'expédition déjà présent reste inchangé ; un
0le met vraiment à zéro, ce qui n'est pas pareil que de ne pas y toucher. - Une date passée recalcule l'historique. Par défaut, il écrit à la date du jour ; si vous lui demandez d'appliquer le coût depuis une date antérieure, le P&L des périodes déjà closes après cette date se recalcule tout seul, et met un peu de temps à apparaître.
- Uniquement sur les plans qui incluent le coût produit. En Free et Guru, cet outil répond avec un 403, comme toute autre écriture sur ces plans.
- Il ne modifie pas le coût unitaire d'un produit avec des achats. Son coût est calculé par les achats enregistrés, donc l'assistant vous dira qu'il ne peut pas. Le coût d'expédition, lui, il le modifie, à condition de l'envoyer seul, sans le coût unitaire : avec les deux à la fois, rien n'est enregistré. Pour changer son coût produit, l'assistant enregistre ou corrige un achat (Achats).
Il ne vous demandera pas de confirmer avant d'écrire -ce n'est pas une opération destructive, elle ne supprime rien et la valeur précédente reste dans l'historique-, mais il vous citera bien le coût et la date qu'il a appliqués.
Achats
Quand un produit a des achats, son coût produit est le coût moyen de son stock : chaque achat le recalcule avec les unités que vous aviez et celles que vous achetez. L'assistant vous dit quels achats a un produit, avec le coût moyen laissé par chacun, et avec quels produits il partage son stock ; et il enregistre, corrige et supprime des achats. C'est la même chose que Enregistrer des achats sur la fiche du produit, avec le même calcul. Pour les lire, il lui faut catalog:read ; pour les enregistrer, les corriger et les supprimer, costs:write. Les deux, uniquement sur les plans qui incluent le coût produit.
Ce qu'il faut savoir :
- Le stock partagé a un seul coût. En paneuropéen, le même SKU dans les pays de l'UE est le même stock, donc un achat change le coût de tous ces pays (le Royaume-Uni et Vendor sont à part). Le groupe naît avec le premier achat ; si ces pays ont aujourd'hui des coûts différents, cet achat a besoin en plus de ce que valait le stock déjà présent, et sans cette donnée il n'est pas enregistré.
- Le stock avant l'achat. Si vous ne lui dites pas combien de stock vous aviez, on prend le dernier stock Amazon FBA des 7 jours précédents, plus les achats enregistrés depuis. En FBM, il faut le lui donner.
- Le numéro de commande ne se répète pas. Si l'achat porte un numéro de commande, enregistrer le même une deuxième fois est rejeté au lieu de le dupliquer.
- Corriger ou supprimer recalcule. Cela change le coût moyen de cet achat et des suivants, ainsi que le P&L des périodes déjà closes, comme un coût avec une date passée. Une suppression ne s'annule pas ; si c'était le dernier achat du groupe, les coûts d'avant s'appliquent de nouveau.
- Il vous demande de confirmer avant de corriger ou de supprimer. Ces opérations sont marquées comme irréversibles, donc l'assistant vous demande confirmation ; pour enregistrer un achat, non.
- Avec plusieurs comptes, lire en demande un et écrire les demande tous. Si le stock est partagé par des comptes que la clé n'atteint pas, l'assistant peut lire leurs achats mais pas les modifier.
- Chaque écriture coûte autant qu'écrire un coût.
Importer les coûts de nombreux produits
Pour charger le coût de nombreux produits, l'assistant utilise epinium_import_product_costs, avec la même permission costs:write. C'est le même import que Importer des coûts depuis un fichier dans l'app, avec le même modèle et les mêmes règles, et il ne recalcule le P&L qu'une seule fois, à la fin. Produit par produit, ça ne fonctionne pas : chaque coût avec une date passée recalcule le P&L de tout le compte et, pendant ce temps, les suivants sont rejetés.
Ce qu'il faut savoir :
- Vous lui passez le fichier dans une zone où le déposer. Dans les chats de Claude, web et bureau, et dans ChatGPT, il vous la montre, et le fichier va directement à Epinium :
.xlsx,.xlsou.csv, jusqu'à 8 Mo et 200 000 lignes, donc un catalogue entier tient dans un fichier, sans le découper. Si un Excel avec beaucoup de colonnes ne passe pas, supprimez les colonnes inutiles ou enregistrez-le en CSV. Dans Claude Code et Cowork, il lit le fichier et lui passe les lignes lui-même, jusqu'à 5 000 par import. - Il comprend les colonnes comme l'app : celles du modèle et des noms courants comme « sku », « cost » ou « date ». S'il n'en reconnaît pas une, il indique de quelle colonne vient chaque donnée, sans vous demander un autre fichier. Chaque ligne suit les règles du fichier de l'app.
- Avant d'importer, il vous montre la vérification. Sans rien enregistrer ni facturer, il vous dit combien de lignes s'appliqueraient, combien ne changeraient rien parce que le produit avait déjà ce coût à leur date, combien ne s'appliqueraient pas et pourquoi, combien seraient sans date et combien de crédits cela coûterait. Il n'importe que lorsque vous dites oui, et si la vérification change quand vous changez la date, il vous la montre de nouveau avant.
- Les dates comptent. Une ligne sans date s'applique à partir d'aujourd'hui et ne couvre pas les ventes antérieures. Si votre fichier n'a pas de dates, l'assistant vous demande à partir de quand les coûts s'appliquent et l'utilise pour ces lignes. Et si une ligne a une date antérieure à un coût que le produit a déjà, il vous prévient qu'elle ne comptera que jusqu'à ce coût, qui est conservé.
- Les produits parents de variation sont rejetés. Ils ne se vendent pas, leur coût ne couvrirait donc aucune vente : le coût va sur leurs variations.
- Il vous donne le résultat quand il a terminé : combien de lignes ont été appliquées, combien ne changeaient rien et combien ont été rejetées, avec le motif de chacune. D'ici là, il ne vous dira pas que les coûts sont chargés.
- Il reste dans l'historique de l'app, dans l'Historique de l'import de coûts de ce compte.
- Un compte par import. Si le P&L de ce compte est en cours de recalcul à cause d'un changement de coût antérieur, il n'importe rien : attendez la fin et redemandez-le.
- Chaque ligne appliquée coûte autant qu'écrire le coût d'un produit. Au début, les lignes qui peuvent s'appliquer sont réservées et, si votre solde ne suffit pas, rien n'est importé. À la fin, seules les lignes appliquées sont facturées et le reste est rendu. Voir où il en est ne coûte rien. Uniquement sur les plans qui incluent le coût produit.
- Les achats aussi. Il importe des achats depuis un fichier d'achats, uniquement sur les comptes Seller. Sa vérification ne contrôle que le format de chaque ligne et rejette déjà les lignes mal formées : le SKU, son groupe de stock et le stock sont contrôlés à l'import, donc quelques lignes de plus peuvent être rejetées à ce moment-là. Chaque achat appliqué coûte autant que de l'enregistrer seul.
Écrire des dépenses propres
Avec la même permission costs:write, l'assistant gère vos dépenses propres : les mêmes que celles que vous créez dans Coûts et dépenses → Dépenses propres. Vous pouvez les lui dicter dans le chat ou lui transmettre une feuille de calcul avec vos dépenses, et il les crée avec epinium_create_expenses. Avec une feuille, dans les chats de Claude, web et bureau, et dans ChatGPT, il vous montre une zone pour la déposer : le fichier va directement à Epinium et est lu avec les règles de l'import de l'application, sans que l'assistant copie ses lignes. Si ses colonnes ne s'appellent pas comme celles du modèle, l'assistant indique à Epinium d'où vient chaque donnée. Dans Claude Code et Cowork, qui n'affichent pas la zone, il lit la feuille lui-même.
Cinq choses à savoir :
- Il vous montre d'abord ce qu'il va créer. Avec plusieurs dépenses, l'assistant les vérifie avant sans rien créer ni consommer de crédits, vous montre le résultat et ne les crée que lorsque vous dites oui. Si l'une contient une erreur, aucune n'est créée : il vous dira laquelle échoue pour que vous la corrigiez, ou ne créera que les valides si vous le lui demandez.
- Il vous prévient des doublons possibles. Si une dépense ressemble à une que vous avez déjà, ou si vous l'avez mise deux fois dans la feuille, il vous demande avant de la créer. Et si un montant de la feuille peut être des milliers ou des décimales, comme
1.500, il vous demande au lieu de le supposer, de même que l'import de l'application le rejette. - Il vous demande avant de changer un montant, de terminer ou de supprimer une dépense. Un nouveau montant s'applique à partir du mois que vous choisissez, et l'assistant vous demandera lequel. La terminer supprime les changements de montant qu'elle avait prévus après. Supprimer une dépense la retire de tout l'historique ; si vous voulez seulement qu'elle ne compte plus, demandez-lui de la terminer.
- Le P&L les déduit immédiatement. Ce que vous créez, modifiez ou supprimez apparaît dès la requête suivante du P&L, y compris sur les mois déjà passés.
- Uniquement sur les plans qui incluent le coût produit. En Free et Guru, ces outils répondent avec un 403.
Interroger vos boutiques Shopify et WooCommerce
Avec la permission platform:read, l'assistant lit en direct ce que contiennent les boutiques Shopify et WooCommerce que vous avez connectées : produits, variantes, stock, prix et le reste de ce qu'expose chaque boutique. Il le fait avec deux outils valables pour les deux plateformes :
epinium_platform_docslui indique quelle version de l'API de la boutique Epinium utilise, où se trouve sa référence et les pièges qui font paraître juste une réponse qui ne l'est pas. Il lui montre aussi les champs qu'a votre boutique en ce moment, y compris ceux qu'ajoutent vos plugins ou vos apps, pour qu'il ne les écrive pas de mémoire.epinium_platform_requestexécute la requête dans la langue de chaque plateforme : GraphQL sur Shopify et REST sur WooCommerce.
Avec la permission platform:write, le même epinium_platform_request crée, modifie et supprime aussi des produits et du contenu dans la boutique, directement et sans tâche. Ce qu'il peut changer sur chaque plateforme, et ce qui est enregistré, se trouve dans les guides Shopify et WooCommerce. Pour copier votre catalogue Amazon dans votre boutique, étape par étape, consultez les cas d'usage.
Trois choses à savoir :
- C'est une permission distincte de
connections:read.connections:readdit ce que vous avez connecté ; celle-ci permet de lire ce que contient la boutique. C'est pourquoi elle a sa propre section dans l'écran des permissions, Données de vos boutiques et plateformes connectées. - Les données personnelles ne sortent pas. Noms, e-mails, téléphones et adresses sont refusés avant que la requête n'atteigne la boutique. C'est une protection voulue, pas un bug, et l'assistant sait quel champ l'a déclenchée.
- La facturation dépend de la taille de la réponse. Ne demander que les champs dont vous avez besoin revient moins cher et va plus vite.
Quelles données il atteint
Les mêmes que l'API, ressource par ressource. La liste complète des endpoints, avec ce que chacun renvoie, se trouve dans la section API.
Cinq choses à savoir quand vous lui demandez des données :
- Les métriques ont besoin d'une plage de dates. Indiquez la période qui vous intéresse ; sinon l'assistant vous la demandera.
- Vous pouvez demander l'évolution jour par jour, pas seulement le total de la période. Utile pour repérer des tendances plutôt qu'un seul chiffre agrégé.
- Le plafond de la plage dépend de la granularité. Avec le total de la période ou par semaine, mois, trimestre ou année, 366 jours ; jour par jour, 93. Sur les targets et les termes de recherche, les ressources les plus lourdes, cela descend à 93 et 31. Demander plus renvoie une erreur qui indique la limite exacte.
- Une donnée vide n'est pas un zéro. Si l'assistant dit qu'une métrique est indisponible, c'est qu'Amazon ne la remonte pas pour ce format d'annonce, pas qu'elle vaut zéro.
- Avant de vous dire qu'une donnée n'existe pas, il la cherche. Avec
epinium_find_data, il trouve l'outil et le champ de n'importe quelle métrique par son nom ou son sigle. S'il vous dit encore qu'il ne l'a pas, c'est que le MCP ne l'expose pas.
Questions auxquelles il répond bien
- Quelles campagnes ont le pire ACOS ce mois-ci ?
- Sur quelles recherches je dépense sans aucune vente ?
- Quels mots-clés fonctionnent le mieux et mériteraient de passer en correspondance exacte ?
- Quels produits annoncés ne reçoivent pas une seule impression ?
- Lesquels de mes produits ont du trafic mais ne convertissent pas ?
- Qu'est-ce que le workflow a changé sur cette campagne le mois dernier, et est-ce que ça a servi à quelque chose ?
- Quelles campagnes mon workflow atteint-il, et y en a-t-il une que je crois optimisée alors qu'il ne la touche jamais ?
- Quels produits de ma boutique Shopify ou WooCommerce vont bientôt être en rupture de stock ?
- Combien a vendu chacun de mes clusters le mois dernier, et combien ai-je dépensé en publicité pour chacun ?
- Quel canal de vente me laisse la meilleure marge réelle, une fois déduit tout ce que me coûte la fabrication et la vente du produit ?