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 : le competitorId n'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 avec merge_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 mergeIntoId juste ? Utilisez merge_products. Faux ? dismissMergeSuggestion: true.
  • Pour passer un produit à votre propre marque, envoyez competitorId: null.
  • Reprenez une catégorie telle que list_products la renvoie dans category. Une nouvelle orthographe crée une catégorie à part dans la part de voix.

Tools liés

Vous pouvez voir où vous en êtes dès aujourd'hui.

Essai gratuit. Lancez le suivi de votre visibilité IA, sans carte.