bflabs-mcp 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -49,7 +49,7 @@ name: catalog-manager
49
49
  description: Gerencia catálogos de produtos Meta (Commerce Manager) via MCP. Use quando o usuário pedir para criar produtos, variantes, conjuntos de produtos (Product Sets) ou executar criação em massa.
50
50
  license: proprietary
51
51
  metadata:
52
- version: 1.0.0
52
+ version: 1.0.1
53
53
  author: BF Labs
54
54
  tags:
55
55
  - meta-catalog
@@ -64,22 +64,31 @@ metadata:
64
64
 
65
65
  Operação de catálogos de produtos Meta via Commerce Manager.
66
66
 
67
- ## Fluxo principal
67
+ ## Fluxo principal (escala BF Labs)
68
+
69
+ 1 produto base → N variantes (mesmo \`item_group_id\`) → 1 Product Set automático
68
70
 
69
- 1 produto 4 variantes idênticas 1 Product Set automático
71
+ As variantes aparecem agrupadas no Commerce Manager como um único item com múltiplas cópias.
70
72
 
71
73
  ## Quando usar
72
74
 
73
75
  - Criar produto novo no catálogo de um cliente
74
- - Criar variantes idênticas (fluxo de escala)
76
+ - Criar variantes idênticas (fluxo de escala) com \`catalog_bulk_create_product\`
75
77
  - Criar Product Set automaticamente
76
78
  - Listar e atualizar produtos existentes
77
79
 
80
+ ## Comportamento importante
81
+
82
+ - \`additional_image_urls\`: lista de URLs de imagens extras — enviada automaticamente como JSON string para a API Meta
83
+ - \`item_group_id\`: no bulk create, todas as variantes recebem o \`retailer_id_base\` como \`item_group_id\`, agrupando-as como variantes do mesmo produto no Commerce Manager
84
+ - Campos \`None\` são removidos automaticamente antes do envio
85
+
78
86
  ## Começar
79
87
 
80
88
  \`\`\`
81
89
  context_get_client("nome-do-cliente") → business_id
82
90
  catalog_list(business_id) → catalog_id
91
+ catalog_bulk_create_product(catalog_id, name, retailer_id_base, ...)
83
92
  \`\`\`
84
93
  `,
85
94
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bflabs-mcp",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "BF MCP — instala o MCP server e skill do ads-manager e catalog-manager em Claude Desktop/Code",
5
5
  "bin": {
6
6
  "bflabs-mcp": "./bin/bflabs-mcp.js"