As 16 ferramentas do Consultor

Todas expostas pelo Worker veggi-mcp ao app do Claude.

Análise — leem o KV latest

As sete atendem as duas contas: padrão B2B, ou conta="B2C".

#	Ferramenta	O que faz	No B2C muda para
1	consultar_kpis_veggi	Visão geral e evolução mês a mês, com filtros de período, conta e tipo	Troca o bloco inteiro: gasto na Meta, pixel, pedidos reais da VTEX, funil de visitas, Google Ads e saldo
2	detalhar_campanha	Histórico de uma campanha	Se a conta não for dita e o nome não existir na B2B, procura sozinho na B2C antes de dizer "não existe"
3	comparar_periodos	Compara dois períodos no CRM real	Régua da loja: pedidos reais, CPA/ROAS real, pixel, Google e % de etiquetagem
4	ranking_campanhas	Ordena por gasto ou CTR	—
5	cpa_real_por_campanha	CPA real do CRM por campanha	Pedidos reais da VTEX, receita, CPA e ROAS real por campanha
6	desempenho_anuncios	Gasto, CTR, CPC e negociações por anúncio (o formato vem no nome, então compara vídeo × carrossel)	Soma carrinho, compras do pixel, pedido real e visitas etiquetadas
7	desempenho_conjuntos	O mesmo por conjunto, mais o público	—

Memória do negócio — KV consultor_memory

Estrutura: { perfil, aprendizados: [{id, data, categoria, texto}], _seq }

#	Ferramenta	O que faz
8	ler_memoria_negocio	Lê o perfil e os aprendizados acumulados
9	anotar_aprendizado	Grava um aprendizado novo
10	atualizar_perfil_negocio	Atualiza o perfil do negócio
11	esquecer_aprendizado	Remove um aprendizado pelo id

Info

Esta é a única chave do KV que o MCP escreve. O robô não toca nela.

Criação e integração — escrevem na Meta ou leem externo

#	Ferramenta	O que faz
12	listar_publicos_meta	Públicos personalizados da Meta (Veggi B2B)
13	listar_segmentacoes_rd	Segmentações do RD Marketing. Use o parâmetro busca — a base é grande e bagunçada
14	criar_campanha_pausada	Cria campanha + conjuntos, sempre PAUSADO. Objetivos: leads, engajamento, tráfego, alcance. Orçamento na campanha (CBO). Cada conjunto pode excluir públicos via excluir_publico_ids — ex.: clientes atuais
15	criar_anuncio	Cria o anúncio dentro do conjunto, PAUSADO, com copy, título, CTA, UTMs e uma imagem provisória
16	criar_lookalike	Cria público semelhante a partir de um público base. Leva horas para a Meta montar

Permissões no conector

As ferramentas de leitura (1 a 13) podem ficar em "sempre permitir". criar_campanha_pausada, criar_anuncio e criar_lookalike devem ficar em "perguntar" — escrevem na conta de anúncios.

A integração RD ↔ Meta já sincroniza públicos

O listar_segmentacoes_rd serve para consultar, não para importar — a sincronização de públicos já é nativa e é um caminho separado.

Fluxo típico do modo arquiteto

1. consultar_kpis_veggi        → onde estamos
2. desempenho_anuncios         → o que está funcionando
3. ler_memoria_negocio         → o que já aprendemos antes
4. listar_publicos_meta        → com quem falar
   ↓ o consultor propõe o plano, a dona aprova
5. criar_campanha_pausada      → estrutura (PAUSADA)
6. criar_anuncio               → peça com UTM e imagem provisória (PAUSADO)
   ↓ a dona troca a arte no Gerenciador e ativa
7. anotar_aprendizado          → registra o que se decidiu e por quê