Auditoria de Meta Ads grátis: ferramenta open-source no terminal

3 min de leitura

A gente cansou de auditar conta de Meta Ads no olho. Toda vez era a mesma coisa: abrir o Gerenciador, catar Pixel, CAPI, fase de aprendizado, diversidade de criativo, janela de atribuição — e torcer pra não esquecer nada. Então transformamos esse checklist em uma ferramenta que roda dentro do terminal, no Claude Code. E hoje estamos abrindo o código dela.

O que é a Incuca Ads

Incuca Ads é uma skill open-source para o Claude Code que audita e otimiza contas de Meta Ads (Facebook, Instagram e Threads) direto do seu terminal, com um comando: /ads. Ela lê o contexto do seu negócio — indústria, budget mensal, objetivo, ativos — e devolve um Ads Health Score de 0 a 100, com os achados priorizados de Crítico a Baixo e um plano de ação com Quick Wins.

Não é achismo. É o mesmo rigor de uma auditoria manual, só que sistematizado: 50 checagens de Meta Ads, análise de diversidade de criativos no contexto do Andromeda + GEM + Lattice (a nova stack de entrega da Meta, onde criativo virou segmentação), saúde de Pixel/CAPI, atribuição, budget e mais.

O que ela faz

  • /ads audit — auditoria completa de Meta Ads com agentes em paralelo
  • /ads meta — análise profunda (FB, IG, Threads, Advantage+, Andromeda)
  • /ads creative — qualidade de criativos + risco de Entity-ID clustering
  • /ads tracking — pipeline de tracking server-side (sGTM, CAPI Gateway, dedup)
  • /ads attribution — atribuição (janelas Meta, GA4, Consent Mode V2, MMP)
  • /ads budget, /ads math, /ads test — budget, cálculo de PPC e design de A/B test
  • /ads dna, /ads create, /ads generate — do DNA da marca até criativos gerados por IA

Por que abrimos o código

Porque decisão boa em mídia paga é decisão baseada em dados — e o padrão do que é uma “conta saudável” não deveria ficar trancado. Colocando isso em aberto, qualquer time consegue rodar a mesma auditoria, discordar dos nossos critérios, melhorar e devolver. É assim que a régua sobe pra todo mundo. A ferramenta é MIT no GitHub.

Como instalar

Você precisa do Claude Code v2.x e Python 3.10+. A forma mais rápida é pelo marketplace de plugins:

/plugin marketplace add incuca/incuca-ads
/plugin install incuca-ads

Ou manualmente, clonando o repositório:

git clone https://github.com/incuca/incuca-ads.git
cd incuca-ads
./install.sh

Reinicie o Claude Code, rode /ads audit e responda as quatro perguntas de contexto. Em minutos você tem o diagnóstico da conta.

O que vem por aí

Começamos por Meta porque é onde vemos mais dinheiro sendo queimado por falta de higiene básica de conta. Issues e pull requests são bem-vindos — o código está aqui. Se você roda Meta Ads e quer testar, rode e conta pra gente o que achou.

Samuel Adiers Stefanello

Samuel Adiers Stefanello

Diretor de TI na InCuca, especialista em tecnologia para negócios: AI, data science e big data e especialista no desenvolvimento de projetos digitais.

Comunidade Incuca

Quer aprofundar neste assunto?

Junte-se à comunidade da Incuca e troque experiências com quem também está transformando dados em ação.

Entrar na comunidade

Veja outros conteúdos do mesmo assunto

Veja os conteúdos que preparamos para impulsionar você.