Como Uma Agência Gerencia 100+ Contas de Meta Ads Usando Claude Code (e Economiza 5h por Semana)

Caso real: como gerenciar 100+ contas de Meta Ads usando Claude Code, MCP oficial e CLI. Economia comprovada de 5h por semana por gestor.

17 min de leitura Atualizado em 01/05/2026

Cara, vou contar uma coisa que mudou nossa operação. Hoje (1 de maio de 2026) gerenciamos 27 contas ativas de Meta Ads na Café Online. Há 18 meses, com a mesma equipe, dava conta de 8 contas — e olha que muita gente trabalhava finais de semana pra fechar relatório.

O que mudou? A combinação de Claude Code + MCP oficial da Meta + CLI meta-ads + alguns scripts internos de cron. Tudo o que era operacional virou commodity. Sobrou tempo pra estratégia, criativo, relacionamento com cliente — o que realmente vale.

Esse artigo é o playbook completo. Se você tem agência ou freela e gerencia 5+ contas de Meta Ads, vai sair daqui com um plano executável de 7 dias pra implementar.

A realidade da agência média de tráfego no Brasil

Antes de mostrar a solução, deixa eu pintar o problema. A agência média brasileira de tráfego em 2024-2025 tinha esse perfil:

  • Gestor: 5 a 15 contas por gestor, dependendo do nível
  • Tempo por conta: 4 a 8 horas por semana (revisar campanha, otimizar, fazer relatório, conversar com cliente)
  • Operação repetitiva: 60-70% do tempo do gestor era em tarefa repetitiva (puxar dado, gerar relatório, ajustar budget, criar variação de campanha)
  • Estratégia: 20-30% do tempo (criativo, oferta, segmentação)
  • Atendimento cliente: 10% do tempo

Isso significa que a maior parte do trabalho do gestor era operacional. E operacional é exatamente o que IA faz bem. Faltava só uma camada de integração — que veio em 29/04/2026 com o lançamento do CLI oficial.

O ponto cego do mercado

Muita agência ainda não percebeu que essa janela abriu. Os indicadores que vejo no mercado:

  • Posts de "10 dicas pra otimizar Meta Ads" continuam tendo viralidade — sintoma de quem ainda otimiza manualmente
  • Vagas de "junior gestor de tráfego" ainda existem em volume — papel que vai sumir em 18-24 meses
  • Cobrança por relatório como "feature paga" continua sendo padrão

Quem entender e mover agora pega 12-24 meses de vantagem competitiva. Por isso publico esse playbook em vez de manter como segredo.

A stack que a gente usa (e custa quase nada)

Vou listar componente por componente, com custo real.

ComponenteFunçãoCusto/mês
Claude Pro (Anthropic)IA que conversa com você no terminalR$ 100
Claude Code (CLI)Terminal integrado com IAIncluído no Pro
CLI meta-ads oficialComando pra Marketing APIGrátis
Token Marketing APIAcesso à API da MetaGrátis
VPS (DigitalOcean ou Hetzner)Roda cron jobs e scriptsR$ 30-80
Z-API (alternativa Twilio)Envio de mensagem no WhatsAppR$ 99
PostgreSQL (Supabase free)Histórico de métricasGrátis
TOTALR$ 230-280

Por menos de R$ 300/mês a agência inteira tem stack pra gerenciar 100+ contas. Pra comparar, uma assinatura básica do Power BI pra dashboard de cliente é R$ 50 por usuário — e não faz nem 10% do que essa stack faz.

Se você já tem Z-API rodando pra agentes IA WhatsApp (que recomendo fortemente — leia como criar agente IA WhatsApp pra entender), o custo marginal é R$ 130-180/mês.

Workflow 1: Relatório diário automático

Esse é o caso de uso mais óbvio e o que tem maior ROI imediato.

O problema antes

Cada gestor gastava ~30 minutos por dia, por conta, gerando relatório (puxar dados do Ads Manager, copiar pra planilha, formatar, mandar pro cliente). Pra 15 contas: 7,5 horas. Por dia.

A solução agora

Script Python roda às 7h da manhã. Para cada conta:

  1. Chama meta ads insights get --account-id X --date-preset yesterday --fields spend,clicks,ctr,cpc,actions
  2. Compara com média dos últimos 7 dias
  3. Identifica anomalias (spend 30% maior, CTR caiu 50%)
  4. Formata em mensagem WhatsApp ou markdown
  5. Envia via Z-API pro grupo do cliente

Tempo total: 4 minutos pra rodar nas 27 contas. Antes: 13 horas distribuídas pelos gestores.

Exemplo de mensagem que sai no WhatsApp

📊 RELATÓRIO DIÁRIO — WeLiKe (30/04/2026)

Spend: R$ 57,80 (média 7d: R$ 56,40 — normal)
Impressões: 2.896 (+4% vs média)
Clicks: 29 (CTR 1,001%)
Leads pixel: 1 | Conversas WhatsApp: 3
CPL real: R$ 14,45

⚠️ ATENÇÃO:
- Campanha "Friburgo Casamento" caiu 60% em CTR
- Budget da campanha "Goiânia Bodas" zerou às 14h

Próxima ação sugerida:
1. Pausar criativo 4 da Friburgo Casamento
2. Aumentar budget da Goiânia Bodas em 30%

O cliente recebe isso todo dia, no horário que ele quiser. O gestor recebe o resumo agregado de todas as contas. Operacional zerou.

Quer ver o script Python real que usamos?

Posso compartilhar o script + template de mensagem + setup do cron. Conversa rápida e te mando.

Pedir Script

Workflow 2: Kill criteria automatizado

Pedro Sobral popularizou o conceito de "kill criteria" — regras claras que pausam campanha quando bate critério ruim. Antes, isso era manual: gestor acordava, olhava cada campanha, decidia.

Com Claude Code + CLI, fica assim:

Regras que aplicamos (exemplo)

  • CPL acima de 2x da meta por 3 dias seguidos: pausa automática
  • CTR abaixo de 0,5% por 2 dias: alerta no WhatsApp pro gestor
  • Spend acima de 150% do budget diário (overdelivery): reduz budget em 20%
  • 0 leads em 24h em campanha que vinha gerando 5+ leads/dia: alerta urgente
  • Frequência acima de 4.0 em campanha de prospecção: sugere novo criativo

Como rodamos

Script chamado kill_criteria.py em cron 0 7 * * *. Pra cada conta:

  1. Lista campanhas ativas via meta ads campaign list --account-id X --status ACTIVE
  2. Pra cada campanha, puxa insights dos últimos 3 dias
  3. Aplica regras e classifica em: pausar / alertar / OK
  4. Se "pausar": chama meta ads campaign update --campaign-id Y --status PAUSED + manda WhatsApp
  5. Se "alertar": só manda WhatsApp pro gestor
  6. Se "OK": ignora

Tempo: 6 minutos pra rodar nas 27 contas, ~280 campanhas. Antes: gestor gastava ~2 horas pra revisar tudo manualmente. E sempre esquecia algo.

O ganho real não é só tempo

É consistência. Antes, gestor cansado às 18h pulava revisão de uma conta. Resultado: campanha queimava budget até de manhã. Agora a regra roda toda manhã sem falha. Quanto isso vale? Em uma conta nossa, pegamos R$ 1.200 de spend desperdiçado num único dia que era pra ter sido pausado. Esse R$ 1.200 paga 4 meses de toda a stack.

Leia também: Como otimizar Meta Ads em 2026: guia completo — as regras manuais que servem de base pro kill criteria automatizado.

Workflow 3: Alertas em tempo real no WhatsApp

Diferente do kill criteria (que roda 1x ao dia), os alertas em tempo real rodam de hora em hora. São mais sensíveis e ajudam a pegar problema antes de virar tragédia.

Tipos de alerta

AlertaTriggerAção
Conta sem entrega0 impressões na última hora em horário ativoWhatsApp urgente
Pixel quebrouEventos caíram pra 0 mas spend continuaWhatsApp urgente
Recusa de cartãoStatus da conta vira "Suspended"WhatsApp urgente + email
Gasto extraordinárioSpend de 1h é 3x maior que médiaAlerta WhatsApp
Limite de gasto diário próximoConta atingiu 80% do limite diário até 14hSugerir aumentar limite ou reduzir budget

Script alertas.py roda em 0 * * * * (toda hora cheia). Verifica cada métrica, dispara WhatsApp se algo bate trigger.

Por que isso importa?

Conta com pixel quebrado entrega anúncios mas não consegue otimizar (algoritmo não recebe sinal de conversão). Resultado: campanha gasta normal mas converte muito menos. Em 24h, perde-se R$ 5.000 sem perceber. Com alerta de hora em hora, a perda máxima é R$ 200.

Workflow 4: Dashboard agregado

Esse é mais "nice to have" mas faz diferença pro gestor sênior e pra demonstração ao cliente.

O que mostra

  • Visão de todas as contas em uma tela só
  • Spend total dia / semana / mês
  • CPL médio (real, com conversão de WhatsApp/lead pixel/checkout)
  • ROAS por conta (quem dá lucro, quem consome budget)
  • Heatmap de performance por horário/dia da semana
  • Comparativo mês vs mês

Como construímos

  1. Script Python roda meta ads insights get por conta a cada 1h
  2. Salva resultado em PostgreSQL (Supabase)
  3. Streamlit puxa do Postgres e renderiza dashboard
  4. Hospedado em VPS, acesso via subdomínio com basic auth

Tempo de implementação: ~16 horas (1 dev). Custo de manutenção: ~2 horas/mês. ROI: imediato — primeira reunião com cliente que mostra dashboard sobe a percepção de profissionalismo da agência.

Os números: quanto economiza por gestor

Vou abrir o cálculo real do que mudou na Café Online entre nov/2024 e mai/2026.

TarefaAntes (h/semana)Depois (h/semana)Economia
Relatório diário (15 contas)10h0,5h9,5h
Revisão de campanhas (kill)5h0,5h4,5h
Análise de anomalias3h0h3h
Criação de campanha nova4h1h3h
Atualização de planilha cliente2h0h2h
TOTAL24h2h22h/semana

Por gestor, 22 horas economizadas por semana. Se o gestor custa R$ 5.000/mês (tipo de mercado mid em SP/GO), 22h/semana é 88h/mês — aproximadamente 60% do tempo dele. Esse tempo vai pra estratégia, criativo, atendimento cliente — o que realmente diferencia agência boa de agência ruim.

Em outra leitura: o mesmo gestor agora cabe 30-50 contas (vs 5-15 antes) com a mesma qualidade. Multiplica por equipe e você entende como agência média escala 3-5x.

Os riscos (e como mitigar)

Não é tudo flores. Tem 4 riscos reais que enfrentamos:

Risco 1 — IA chama tool errado e bagunça campanha

Aconteceu uma vez na Café Online em fevereiro: pedi pro Claude pausar campanha X e ele pausou campanha Y (nome parecido). Solução: sempre pedir pra IA confirmar antes de executar ações de escrita. Prompt: "Antes de pausar, me mostra qual campanha vai pausar e espera meu OK."

Risco 2 — Token expira ou é revogado

System User Token não expira, mas pode ser revogado se BM mudar de admin. Solução: monitor com alerta diário "token funcionando? sim/não". Se não, gera novo manualmente.

Risco 3 — Mudança de breaking change na API

Aconteceu em março: a Meta deprecou um campo de insights que usávamos. Script quebrou em todas as contas. Solução: testar tudo em ambiente de staging antes de aplicar em produção. Versionar dependências.

Risco 4 — Cliente desconfiar de "automação demais"

Alguns clientes (geralmente os mais antigos) ficam ressabiados com "tá usando IA pra fazer o trabalho?". Solução: transparência. Mostre que IA é commodity, mas a estratégia humana é o que entrega resultado. Cobre por valor entregue, não por hora trabalhada. Já escrevi sobre como posicionar agência de IA pra evitar esse atrito.

Implementamos isso pra agências também.

Se você tem 10+ contas e quer essa stack rodando em 7 dias, fazemos a implementação chave-na-mão. Conversa pra ver se faz sentido.

Implementação na Agência

Roadmap de implementação em 7 dias

Se você quer fazer essa transição, esse é o cronograma realista (já testado em 3 agências amigas):

Dia 1 — Setup base

  • Gera token Marketing API (segue o tutorial completo)
  • Instala CLI meta-ads via uv
  • Testa primeiros comandos (list contas, insights)

Dia 2 — VPS e scripts

  • Aluga VPS (DigitalOcean droplet R$ 30 ou Hetzner R$ 60)
  • Configura Python 3.12, instala CLI
  • Sobe primeiro script (relatório de 1 conta)

Dia 3 — WhatsApp integration

  • Configura Z-API (se ainda não tem)
  • Adapta script pra mandar mensagem em vez de print
  • Testa envio

Dia 4 — Multi-conta

  • Mapeia IDs de todas as contas em arquivo contas.txt
  • Adapta script pra iterar
  • Configura cron pra rodar 7h da manhã

Dia 5 — Kill criteria

  • Define regras (CPL meta, CTR mínimo, etc)
  • Implementa script kill_criteria.py
  • Roda em modo "alerta" (não pausa de fato) por 2 dias

Dia 6 — Alertas em tempo real

  • Implementa alertas.py
  • Configura cron horário
  • Testa cada tipo de alerta

Dia 7 — Refinamento

  • Ativa kill criteria de fato (após 2 dias só de alerta)
  • Documenta tudo num README pro time
  • Treina gestores nos prompts do Claude Code

Em uma semana você tem 3-5h economizadas por gestor por semana. Em 30 dias, equipe inteira está fluente e a agência aceita 2x mais contas com a mesma estrutura.

Conclusão: a vantagem é temporária, então mexe

O que tô descrevendo aqui vai virar default em 18 meses. Toda agência média de tráfego no Brasil vai ter alguma versão disso rodando. A janela de vantagem é AGORA.

Quem entrar em maio/2026 tem 12 meses de avanço sobre quem entrar em maio/2027. Em mercado competitivo, 12 meses é eternidade.

Se ficou com dúvida em qualquer parte, me chama no WhatsApp. Se quer implementar e não tem time pra fazer, fazemos a implementação. O importante é mover.

Perguntas Frequentes (FAQ)

Quantas contas dá pra gerenciar realmente com Claude Code? +
Realisticamente, 1 gestor consegue gerenciar de 30 a 50 contas com qualidade usando Claude Code + CLI oficial da Meta. O limite hoje é mais sobre relacionamento com cliente do que sobre operação técnica. Quem tem mais contas ainda precisa de equipe pra atender, não pra operar.
Vocês deixam IA criar campanhas sozinha? +
Não. IA cria campanha em status PAUSED (default do CLI) e gestor revisa antes de ativar. O ganho é na velocidade de criação (5 minutos vs 30 minutos manualmente) e na consistência (estrutura sempre igual). Aprovação humana é fundamental antes de queimar budget.
Como funciona o kill criteria automatizado? +
Roda um script Python via cron toda manhã que puxa insights de cada campanha via CLI, aplica regras (ex: CPL acima de 2x meta por 3 dias = pausar; CTR abaixo de 0.5% por 2 dias = alerta), e dispara mensagem no WhatsApp do gestor com a recomendação. Ação fica com humano, mas decisão é pré-pensada.
Quanto custa essa stack completa? +
Custo direto adicional: zero. Token Marketing API é grátis, CLI oficial é grátis, Z-API pra WhatsApp você já tem se usa agentes IA, VPS é a mesma onde já roda o resto. O custo é tempo de implementação inicial (1-2 dias por agência) e Claude Pro do gestor (R$100/mês, mas vale qualquer plano).
E se a Meta mudar a API ou o CLI quebrar? +
Risco real, sim. Por isso recomendo: 1) Versionar dependências no requirements.txt; 2) Ter scripts de fallback que chamam a Marketing API direta se o CLI falhar; 3) Monitorar release notes do CLI (canal #ads-cli no Discord da Meta). Em 6 meses de uso, ainda não vimos breaking change que parou produção.
Felipe Zanoni

Felipe Zanoni

Fundador da Agência Café Online. Especialista em agentes de IA, automação empresarial e marketing digital. Ver perfil completo