merge_products
Tool MCP merge_products : fusionner des produits en double d'une même marque dans un produit cible sur un projet e-commerce. Tout l'historique des mentions suit. Input, réponse, codes d'erreur, exemple JSON.
Mis à jour le 2026-10-08
merge_products fusionne des produits d'une même marque dans un produit cible. La cible garde son nom ; les produits fusionnés disparaissent et leurs noms bruts (alias) passent à la cible.
Les mentions sont rattachées aux noms bruts, pas aux produits : tout l'historique suit. Chaque réponse passée qui citait un produit fusionné compte désormais pour la cible.
Quand l'utiliser
Les moteurs nomment une même gamme de mille façons (« Gum Soft Picks Advanced », « GUM Soft-Picks Advanced »). Mentionable replie seul tailles, couleurs et lots, et regroupe lui-même les doublons évidents. Quand il hésite, il se contente de suggérer : le produit porte un mergeIntoId dans list_products. Utilisez ce tool pour accepter cette suggestion, ou pour fusionner des doublons repérés vous-même.
Input
| Champ | Type | Défaut | Description |
|---|---|---|---|
projectId |
string (CUID) | requis | Projet des produits. |
targetProductId |
string (CUID) | requis | Produit qui reste, avec son nom. |
productIds |
tableau de string (CUID), 1-20 | requis | Produits fusionnés dans la cible. Même marque que la cible. |
Réponse
{ "success": true, "productId": "clpr1...", "merged": 2 }
productId: la cible.merged: produits fusionnés dans la cible. La cible est ignorée si vous la listez dansproductIds.
La cible passe en CONFIRMED si l'un des produits fusionnés l'était, et reprend la page produit du site d'un produit fusionné quand elle n'en avait pas.
Erreurs :
{ "success": false, "error": "different_brands" }
product_not_found: un des ids est inconnu ou appartient à un autre projet.different_brands: les produits ne sont pas tous de la même marque. Corrigez d'abord la marque avecupdate_product.
Astuces et patterns
- Accepter les suggestions de l'IA : pour chaque ligne avec un
mergeIntoId, appelezmerge_productsavectargetProductId: mergeIntoIdetproductIds: [id]. - Choisissez comme cible le produit au nom de gamme le plus clair, ou renommez-le ensuite avec
update_product. - Trop fusionné ?
split_productressort des noms bruts vers un nouveau produit.
Tools liés
list_products: tous les produits, avec les suggestions de fusionsplit_product: l'opération inverseupdate_product: renommer, changer de marque, écarter une suggestionget_product: les noms bruts d'un produit