update_product
Tool MCP update_product : renommer un produit d'un projet e-commerce, changer la marque qui le fabrique ou sa catégorie de produit, ou écarter sa suggestion de fusion. Input, réponse, codes d'erreur, exemple JSON.
Mis à jour le 2026-10-08
update_product corrige un produit d'un projet e-commerce : son nom, la marque qui le fabrique, sa catégorie de produit, ou la suggestion de fusion que l'IA y a attachée.
Le produit garde ses noms bruts (alias) : tout son historique reste rattaché, quoi que vous changiez.
Quand l'utiliser
Utilisez-le quand une ligne de list_products est juste mais mal étiquetée : un nom de gamme à ranger (« GUM Trav-Ler Brossettes » en « Trav-Ler »), un produit attribué à la mauvaise marque, un produit rangé dans la mauvaise catégorie, ou un mergeIntoId qui pointe vers un produit qui n'est pas un doublon.
Changer la marque est une décision humaine que l'IA respecte : les noms bruts du produit sont verrouillés, et le regroupement automatique des doublons ne les déplace plus. Même chose pour la catégorie : l'IA range les produits après chaque scan, mais n'écrase jamais une catégorie posée ici.
Input
| Champ | Type | Défaut | Description |
|---|---|---|---|
projectId |
string (CUID) | requis | Projet du produit. |
productId |
string (CUID) | requis | id du produit, depuis list_products. |
name |
string (1-200) | - | Nouveau nom du produit. |
competitorId |
string (CUID) ou null |
- | Marque qui fabrique le produit : l'id d'un concurrent, ou null pour la marque du projet. |
category |
string (60 max) ou null |
- | Catégorie de produit (« Brossettes interdentaires »), unité de get_product_share_of_voice. null l'efface et laisse l'IA ranger à nouveau le produit. |
dismissMergeSuggestion |
boolean | - | true efface mergeIntoId : le produit n'est pas un doublon. |
Renseignez au moins name, competitorId, category ou dismissMergeSuggestion.
Réponse
{ "success": true, "productId": "clpr1..." }
Erreurs :
{ "success": false, "error": "product_exists" }
product_not_found: id inconnu ou autre projet.brand_not_found: lecompetitorIdn'est pas un concurrent du projet, ou il a été rejeté.invalid_name: le nom ne contient que la marque et des attributs de variante (tailles, couleurs, lots).product_exists: la marque a déjà un produit du même nom une fois les variantes mises de côté. Fusionnez plutôt les deux avecmerge_products.
Astuces et patterns
- Nommez les produits d'après la gamme, pas une variante : « Trav-Ler », pas « Trav-Ler 0,9 mm Orange ». Les variantes sont de toute façon repliées dans la gamme.
- Un
mergeIntoIdjuste ? Utilisezmerge_products. Faux ?dismissMergeSuggestion: true. - Pour passer un produit à votre propre marque, envoyez
competitorId: null. - Reprenez une catégorie telle que
list_productsla renvoie danscategory. Une nouvelle orthographe crée une catégorie à part dans la part de voix.
Tools liés
list_products: tous les produits du projetmerge_products: fusionner des doublonssplit_product: sortir des noms bruts vers un nouveau produitbulk_update_product_status: confirmer ou rejeter des produits