Exporter une liste de prix WooCommerce en CSV avec un assistant IA
Un client grossiste veut vos prix actuels, l'entrepôt veut une fiche de stock, une place de marché réclame un fichier d'ici vendredi. À chaque fois, il faut exporter une liste de prix WooCommerce portant sur certains produits, avec certaines colonnes, dans un ordre qui parle à la personne qui la reçoit. Avec le serveur MCP de BEAR connecté à un assistant IA tel que Claude, cela tient en une phrase : vous indiquez quels produits et quelles colonnes, et quelques secondes plus tard vous obtenez un fichier CSV par un lien de téléchargement. Ce guide explique comment formuler la demande, ce que contient le fichier et dans quel format, où il est conservé et combien de temps, et comment l'utiliser dans un tableur ou pour un import.
Un exemple : une liste de prix pour un client grossiste
Vous écrivez :
Exporte la catégorie Sacs sous forme de liste de prix : SKU, titre, prix normal, prix promo et quantité en stock, dans cet ordre. Utilise des points-virgules.
- L'assistant trouve les produits. Il cherche la catégorie Sacs et demande à BEAR d'exécuter un filtre dessus. BEAR fige les produits correspondants en une sélection et renvoie leur nombre exact. Disons 38 produits.
- Il demande à utiliser
woobe_export_csvavec cette sélection, vos cinq colonnes dans votre ordre et un point-virgule comme séparateur. Les variations sont incluses par défaut : chaque produit variable est suivi d'une ligne par variation, car c'est là que se trouvent les prix et le stock d'un produit variable. - BEAR écrit le fichier sur votre serveur, avec le même code que son propre onglet Exportations, de sorte que chaque valeur est formatée exactement comme dans un fichier exporté depuis l'écran de l'extension.
- Vous recevez un court compte rendu et un lien : le nombre de lignes (variations comprises), le nombre de produits sélectionnés, le nombre de colonnes, la taille du fichier et un lien de téléchargement valable 15 minutes. L'assistant a pour consigne de vous donner le lien tel quel et de ne pas lire le fichier lui-même.
- Vous ouvrez le lien et le navigateur télécharge un fichier nommé par exemple
woobe_mcp_export_2026-10-12_09-30-15_aB3dE9.csv.
Les premières lignes d'un tel fichier ressemblent à ceci (produits donnés à titre d'illustration) :
SKU;Title;"Regular price";"Sale price";"Stock quantity"
BAG-100;"Canvas Duffel Bag";0;0;0
BAG-100-BL;"Canvas Duffel Bag - Black, L";134.85;0;24
BAG-100-GL;"Canvas Duffel Bag - Green, L";134.85;114.6;20
TOTE-39;"Summer Tote Bag";109.13;0;56
Les zéros de cet extrait ne sont pas des erreurs dans vos données. C'est ainsi que BEAR 2.2.4 écrit les nombres vides, comme l'explique la section sur les valeurs plus bas.
Avant de commencer
Il vous faut BEAR avec son serveur MCP activé dans les réglages de l'extension, une boutique accessible en HTTPS, et un assistant IA capable de se connecter à un serveur MCP, tel que Claude dans le navigateur, l'application de bureau ou Claude Code, ou Cursor. BEAR s'authentifie avec une clé placée dans un en-tête de requête ; ChatGPT ne fonctionne donc que là où son connecteur permet d'ajouter cet en-tête. Les étapes de connexion se trouvent dans la documentation du serveur MCP.
Quels produits entrent dans l'export
Tout ce que le filtre de BEAR sait décrire : une catégorie, une étiquette, une marque, la valeur d'un attribut (« tout ce qui est rouge »), une fourchette de prix, l'état du stock, le type de produit, une plage de dates, un texte dans le titre ou dans le SKU, ou des combinaisons de ces critères. Vous pouvez aussi nommer directement des produits ou des SKU, ou demander tout le catalogue, ce que l'assistant a pour consigne de signaler avant de continuer.
- Exporter les produits par catégorie, sous-catégories comprises. Une catégorie dans le filtre n'inclut pas d'elle-même ses sous-catégories. Dites « Sacs et tout ce qu'elle contient » et l'assistant ajoute les catégories enfants au filtre.
- Variations. Activées par défaut. Chaque produit variable exporte d'abord sa propre ligne, puis une ligne par variation. Dites « sans les variations » pour obtenir une liste des seuls produits ; la ligne d'un produit variable n'a alors aucun prix exploitable.
- Ordre. Les lignes suivent l'ordre de la sélection, par ID de produit sauf si vous demandez un tri, par exemple par titre. Les variations viennent toujours juste après leur parent.
- Taille. Un export via la connexion contient jusqu'à 20 000 lignes, variations comprises. Une sélection plus grande est refusée avec le nombre de lignes ; réduisez-la, ou utilisez l'onglet Exportations de l'écran de l'extension, qui travaille par lots et n'a pas cette limite.
Quelles colonnes, dans quel ordre
Nommez les colonnes avec vos propres mots et dans l'ordre voulu. L'assistant traduit « prix » ou « stock » en clés de champs de BEAR à partir de la liste des champs et les transmet dans votre ordre. Une liste de prix qui commence par le SKU et une fiche de stock qui commence par le titre proviennent des mêmes produits.
La limite à connaître : un export ne peut utiliser que les colonnes activées pour la connexion. Il peut les réduire et les réordonner, pas en ajouter d'autres. Ces colonnes dépendent de la manière dont l'assistant est connecté :
- Avec la clé valable pour toute la boutique, aucun utilisateur WordPress ne se trouve derrière la connexion ; BEAR utilise donc son jeu de colonnes par défaut : ID, Thumbnail, Title, Description, Short Desc., Type, Status, Regular price, Sale price, SKU, Manage stock, Stock quantity et Stock status. Les colonnes que vous avez activées pour vous-même dans l'éditeur ne s'y appliquent pas.
- Avec une clé personnelle, la connexion s'exécute en tant que cet utilisateur et utilise donc les colonnes qu'il a activées dans l'onglet Réglages (Settings) de BEAR, avec les titres qui y sont donnés.
Si vous demandez une colonne en dehors de cet ensemble, une colonne de catégories avec la clé valable pour toute la boutique par exemple, BEAR n'écrit rien et répond que la colonne n'est pas activée, en listant les colonnes disponibles. Il y a trois façons de contourner cela : se connecter avec une clé personnelle ; utiliser l'onglet Exportations de l'écran de l'extension, qui exporte vos propres colonnes ; ou laisser la clé valable pour toute la boutique utiliser le jeu de colonnes d'un administrateur grâce à ce code :
// Child theme functions.php or a code snippets plugin.
// BEAR MCP: the shop-wide key has no WordPress user (ID 0).
// Give it the BEAR settings, including the columns, of user 1.
add_filter( 'woobe_settings_key_options', function ( $key ) {
return 0 === (int) $key ? 1 : $key;
} );
Remplacez 1 par l'ID de l'administrateur dont les colonnes doivent servir aux exports. Les autres réglages BEAR de cet utilisateur, tels que les titres de colonnes, s'appliquent eux aussi à la connexion. Si vous partagez déjà un même jeu de réglages entre tous les utilisateurs avec ce même filtre, la clé valable pour toute la boutique le partage également.
Nommez toujours les colonnes. Sans liste, l'export prend toutes les colonnes disponibles, et avec la clé valable pour toute la boutique cela inclut les descriptions complètes en HTML et les URL d'images, qui rendent une liste de prix illisible.
À quoi ressemblent les valeurs dans le fichier
Le fichier est construit par le code d'export de BEAR, qui écrit les valeurs comme l'importateur de produits de WooCommerce les lit, et non comme une personne mettrait en forme une liste de prix. Connaissez ces points avant d'envoyer le fichier à qui que ce soit :
| Colonne | Dans le fichier |
|---|---|
| Prix | Un nombre simple avec un point comme séparateur décimal, sans symbole monétaire, sans séparateur de milliers, zéros finaux supprimés : 114.60 s'écrit 114.6. |
| Nombres vides | Écrits 0. Un produit qui n'est pas en promotion a 0 comme prix promo, la ligne propre d'un produit variable a 0 comme prix, un produit qui ne gère pas de stock a 0 comme quantité en stock. |
| Stock status | 1 pour en stock, 0 pour en rupture de stock et en réapprovisionnement. |
| Manage stock | 1 ou 0. |
| Status | 1 publié, -1 brouillon, 0 privé ; les produits en attente gardent le mot pending. |
| Type | simple, variable, variation, external ou grouped, avec « , downloadable » ou « , virtual » ajouté lorsque cela s'applique. |
| Thumbnail | L'URL de l'image en taille réelle. |
| Catégories | Les noms, séparés par des virgules, une sous-catégorie s'écrivant « Sacs > Voyage ». Les lignes de variations sont vides, car les catégories appartiennent au parent. |
| Attributs | Quatre colonnes chacun, comme l'attend l'importateur WooCommerce : valeurs, nom, visible, global. En 2.2.4, les valeurs sont vides sur les lignes de variations. |
Deux conséquences pour une liste de prix. Premièrement, distinguez les variations par le SKU ou le titre, pas par les colonnes d'attributs. Le titre d'une variation ne porte ses valeurs d'attributs que si WooCommerce les y a mises ; titres de variations avec attributs explique quand c'est le cas. Deuxièmement, une promotion programmée pour commencer la semaine prochaine affiche déjà son prix promo, car la colonne contient le prix promo enregistré. Si cela compte pour vous, demandez d'abord à l'assistant quels produits de la liste ont une promotion programmée.
Les prix sont les nombres que WooCommerce enregistre, dans la devise principale de votre boutique, avec ou sans taxe selon le réglage WooCommerce Prix saisis avec la taxe (Prices entered with tax). Rien n'est converti. Une boutique qui enregistre des prix fixes par devise dans des champs de produit ne peut les exporter que si ces champs figurent parmi les colonnes disponibles.
Séparateur, encodage et Excel
- Séparateur. Une virgule par défaut. Demandez un point-virgule si votre tableur en attend un, ce qui est le cas dans la plus grande partie de l'Europe continentale ; n'importe quel caractère unique convient, tabulation comprise. Un texte contenant des espaces ou des séparateurs est placé entre guillemets doubles.
- Encodage. UTF-8 avec une marque d'ordre des octets au début, pour qu'Excel affiche correctement les lettres accentuées et les autres alphabets lorsque vous double-cliquez sur le fichier.
- Virgule décimale. Le point des prix peut gêner un tableur réglé sur la virgule décimale : 134.85 peut rester du texte, et 12.5 peut même se transformer en date. Ouvrez le fichier par l'import Données → À partir du texte/CSV (Data → From Text/CSV) d'Excel et réglez les paramètres régionaux du fichier sur une langue qui utilise le point décimal, comme l'anglais (États-Unis) ; LibreOffice Calc propose le même choix sous Langue (Language) dans sa boîte de dialogue d'import.
- Formats. CSV uniquement via la connexion. L'onglet Exportations de l'écran de l'extension écrit aussi du XML.
Où se trouve le fichier et combien de temps le lien fonctionne
Le fichier est écrit dans le dossier d'export de BEAR sur votre propre serveur, un dossier à l'intérieur de l'extension que BEAR ferme à l'accès web direct, et le nom du fichier se termine par des caractères aléatoires, ce qui le rend difficile à deviner. Vous le téléchargez par un lien vers votre boutique qui porte son propre jeton aléatoire :
- Le lien fonctionne pendant 15 minutes et ne demande aucune connexion ; il s'ouvre donc sur n'importe quel appareil, y compris votre téléphone. Il peut être rouvert pendant ces 15 minutes.
- Passé ce délai, il répond Ce lien de téléchargement a expiré. Demandez à nouveau l'export. (This download link has expired. Ask for the export again.) Si le fichier a déjà été nettoyé, il répond Ce fichier d'export n'est plus sur le serveur. (That export file is no longer on the server.) Dans les deux cas, redemandez : un nouvel export prend quelques secondes.
- Le nettoyage automatique de BEAR supprime les fichiers d'export de plus de huit heures.
- Toute personne qui possède le lien peut télécharger le fichier tant qu'il fonctionne. Ne le publiez pas dans un canal public. Pour un client, téléchargez le fichier et envoyez le fichier, pas le lien.
La clé MCP de la boutique n'apparaît jamais dans le lien. Perdre un lien expose un fichier pendant un quart d'heure, pas l'accès à votre boutique.
Un export ne modifie aucun produit et n'est jamais décompté du quota d'écriture de la version gratuite ; il fonctionne donc de la même façon dans les deux versions. Lorsque des personnes se connectent avec des clés personnelles, un administrateur peut fermer l'export à l'une d'elles avec le filtre woobe_mcp_permissions en réglant le secteur export sur none.
Utiliser le CSV : clients, fournisseurs et réimport
Pour un client ou un fournisseur, mettez le fichier au propre dans le tableur : supprimez les lignes des parents variables (Type « variable », prix 0), effacez les zéros de la colonne du prix promo, formatez les prix avec deux décimales et ajoutez la devise dans l'en-tête. Cinq minutes de travail, et le 0 de la colonne du prix promo ne se lit plus comme « gratuit ».
Pour l'entrepôt, demandez le SKU, le titre, la quantité en stock et l'état du stock. Gardez à l'esprit qu'un 0 dans la quantité en stock peut aussi signifier que le produit ne gère pas de stock ; ajoutez Manage stock aux colonnes pour distinguer les deux cas.
Pour un import dans WooCommerce, ne chargez pas le fichier tel quel. Des prix vides exportés comme 0 mettraient des produits en promotion à 0, et une quantité en stock de 0 active la gestion du stock. Mettre à jour des produits existants avec un import CSV liste chaque colonne à vérifier et donne un filtre qui écrit des cellules vides au lieu de zéros. Ce filtre modifie le code d'export lui-même ; il s'applique donc aussi aux exports faits via l'assistant. Pour l'onglet Exportations et ses options, voir la documentation sur l'export des produits.
Comme sauvegarde avant un gros travail sur les textes, un export de l'ID, du titre, de la description et de la description courte conserve les textes actuels, ce qui est utile avant de rédiger des descriptions de produits WooCommerce avec l'IA.
Requêtes prêtes à l'emploi
- « Exporte une liste de prix de la catégorie Sacs : SKU, titre, prix normal, prix promo. »
- « Même liste, Sacs et toutes ses sous-catégories, avec des points-virgules. »
- « Exporte tous les produits en stock : SKU, titre, quantité en stock, triés par titre. »
- « Exporte tout ce qui est en promotion en ce moment : SKU, titre, prix normal, prix promo. »
- « Exporte les produits variables de Chemises avec leurs variations : SKU, titre, prix, stock. »
- « Exporte les produits de Chaussures sans les variations : ID, titre, statut. »
- « Exporte les produits dont les SKU sont TS-101, TS-102 et TS-205 : SKU, titre, prix normal. »
- « Exporte les brouillons créés ce mois-ci : ID, titre, prix normal, statut. »
- « Exporte l'ID, le titre, la description et la description courte de la catégorie Bougies comme sauvegarde. »
- « Exporte les produits en rupture de stock pour mon fournisseur : SKU, titre, état du stock. »
Liste de contrôle
- Serveur MCP activé et assistant connecté (configuration).
- Le nombre de produits correspond à ce que vous attendez ; sous-catégories ajoutées si vous les voulez.
- Colonnes nommées, dans votre ordre ; pour une colonne en dehors de l'ensemble disponible, utilisez une clé personnelle, l'onglet Exportations ou le code ci-dessus.
- Variations activées pour les prix et le stock, désactivées pour une liste de noms de produits.
- Point-virgule si votre tableur en attend un ; import par Données → À partir du texte/CSV (Data → From Text/CSV) si les prix ne sont pas lus comme des nombres.
- Téléchargement dans les 15 minutes ; envoyez le fichier, pas le lien.
- Avant l'envoi : supprimez les lignes parents au prix 0 et effacez les zéros de la colonne du prix promo.
- Avant un réimport : lisez le guide d'import CSV ; n'importez jamais les zéros tels quels.
Questions
Pourquoi mes produits variables affichent-ils un prix de 0 ?
Un produit variable n'a pas de prix propre ; ce sont ses variations qui en ont un. BEAR écrit le prix vide du parent sous la forme 0. Gardez les variations activées et lisez les prix sur les lignes des variations.
L'assistant peut-il envoyer la liste de prix par e-mail à mon client ?
Non. L'export vous donne un lien de téléchargement ; l'envoi du fichier vous revient.
Puis-je exporter une liste de prix WooCommerce au format Excel ?
La connexion écrit du CSV, qu'Excel ouvre directement ; la marque d'ordre des octets préserve les caractères accentués. Si vous avez besoin d'un .xlsx, enregistrez le fichier ouvert dans ce format.
Y a-t-il une limite au nombre de produits exportables ?
20 000 lignes par export via la connexion, les variations comptant comme des lignes. L'onglet Exportations de l'écran de l'extension n'a pas cette limite.
Si quelque chose se comporte dans votre boutique autrement que ce qui est décrit ici, posez la question sur le forum d'assistance de BEAR.