bflabs-mcp 1.0.4 → 1.0.5

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.1
52
+ version: 1.0.2
53
53
  author: BF Labs
54
54
  tags:
55
55
  - meta-catalog
@@ -66,9 +66,9 @@ Operação de catálogos de produtos Meta via Commerce Manager.
66
66
 
67
67
  ## Fluxo principal (escala BF Labs)
68
68
 
69
- 1 produto base → N variantes (mesmo \`item_group_id\`) → 1 Product Set automático
69
+ 1 produto base → N variantes (mesmo \`retailer_product_group_id\`) → 1 Product Set automático
70
70
 
71
- As variantes aparecem agrupadas no Commerce Manager como um único item com múltiplas cópias.
71
+ As N variantes aparecem agrupadas no Commerce Manager como **um único produto** com múltiplas variantes (não como N produtos separados).
72
72
 
73
73
  ## Quando usar
74
74
 
@@ -77,11 +77,13 @@ As variantes aparecem agrupadas no Commerce Manager como um único item com múl
77
77
  - Criar Product Set automaticamente
78
78
  - Listar e atualizar produtos existentes
79
79
 
80
- ## Comportamento importante
80
+ ## Comportamento importante (regras do SDK \`facebook_business\`)
81
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
82
+ - \`retailer_product_group_id\` (nome canônico no SDK — \`item_group_id\` é alias de doc que **não funciona**): no bulk create, todas as variantes recebem o \`retailer_id_base\` como \`retailer_product_group_id\`, agrupando-as como variantes do mesmo produto.
83
+ - \`additional_variant_attributes\`: cada variante recebe \`{"variante": "1..N"}\` automaticamente atributo interno **invisível ao comprador** que faz o Meta diferenciar as cópias em vez de tratá-las como duplicatas.
84
+ - \`additional_image_urls\`: passado como **lista Python** \`[url]\` (o SDK exige \`list<string>\`, não JSON string).
85
+ - \`filter\` (Product Set): construído via \`json.dumps({"retailer_id": {"is_any": [...]}})\` — a API Meta exige JSON-encoded.
86
+ - Campos \`None\` são removidos automaticamente antes do envio.
85
87
 
86
88
  ## Começar
87
89
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bflabs-mcp",
3
- "version": "1.0.4",
3
+ "version": "1.0.5",
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"