bflabs-mcp 1.0.3 → 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.
- package/lib/skill-writer.js +15 -4
- package/package.json +1 -1
package/lib/skill-writer.js
CHANGED
|
@@ -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.
|
|
52
|
+
version: 1.0.2
|
|
53
53
|
author: BF Labs
|
|
54
54
|
tags:
|
|
55
55
|
- meta-catalog
|
|
@@ -64,22 +64,33 @@ 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 \`retailer_product_group_id\`) → 1 Product Set automático
|
|
68
70
|
|
|
69
|
-
|
|
71
|
+
As N variantes aparecem agrupadas no Commerce Manager como **um único produto** com múltiplas variantes (não como N produtos separados).
|
|
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 (regras do SDK \`facebook_business\`)
|
|
81
|
+
|
|
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.
|
|
87
|
+
|
|
78
88
|
## Começar
|
|
79
89
|
|
|
80
90
|
\`\`\`
|
|
81
91
|
context_get_client("nome-do-cliente") → business_id
|
|
82
92
|
catalog_list(business_id) → catalog_id
|
|
93
|
+
catalog_bulk_create_product(catalog_id, name, retailer_id_base, ...)
|
|
83
94
|
\`\`\`
|
|
84
95
|
`,
|
|
85
96
|
};
|