Incuca Ads

Skill open-source de auditoria e otimização de Meta Ads para o Claude Code.

Auditoria profunda de contas de Meta Ads (Facebook, Instagram e Threads) direto do seu terminal, com o comando /ads. Analisa Pixel/CAPI, diversidade de criativos e risco de Entity-ID clustering (Andromeda + GEM + Lattice), estrutura de conta, Advantage+, fase de aprendizado e segmentação — e vai além do audit com tracking server-side, atribuição, alocação de budget, PPC math, design de A/B test e geração de criativos por IA.

Conforme o padrão aberto Agent Skills. Mantida pela Incuca.

---

O que faz

Comando	O que faz
/ads audit	Auditoria completa de Meta Ads com agentes em paralelo (Meta + criativo + tracking)
/ads meta	Análise profunda de Meta Ads (FB, IG, Threads, Advantage+, Andromeda + GEM + Lattice)
/ads creative	Auditoria de qualidade de criativos + scoring de retrieval por Entity-ID
/ads tracking	Auditoria da pipeline de tracking server-side (sGTM, CAPI Gateway, dedup, hit ratio)
/ads attribution	Auditoria de atribuição (janelas Meta, GA4, Consent Mode V2, MMP)
/ads landing	Avaliação de qualidade de landing page
/ads budget	Alocação de budget e estratégia de lance
/ads plan <tipo>	Plano estratégico com templates por indústria
/ads competitor	Inteligência competitiva (Meta Ad Library)
/ads math	Calculadora financeira de PPC (CPA, ROAS, break-even, LTV:CAC)
/ads test	Design de A/B test
/ads report	Relatório em PDF para entrega ao cliente
/ads dna <url>	Extrai o DNA da marca de um site
/ads create	Conceitos de campanha + briefs de copy
/ads generate	Gera imagens de anúncio por IA
/ads photoshoot	Fotografia de produto em 5 estilos

---

Instalação

Requisitos: Claude Code v2.x e Python 3.10+.

Opção 1 — via marketplace de plugins (recomendado)

No Claude Code:

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

Opção 2 — instalação manual (script)

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

O script copia a skill ads/, as sub-skills de skills/ e os agentes de agents/ para o seu diretório do Claude Code (~/.claude/).

Opção 3 — cópia manual

git clone https://github.com/incuca/incuca-ads.git
cp -r incuca-ads/ads              ~/.claude/skills/ads
cp -r incuca-ads/skills/*         ~/.claude/skills/
cp -r incuca-ads/agents/*         ~/.claude/agents/
pip install -r incuca-ads/requirements.txt

Reinicie o Claude Code e rode /ads para confirmar.

---

Uso rápido

/ads audit

A skill coleta o contexto (indústria, budget mensal, objetivo, ativos) e roda a auditoria de Meta Ads com agentes em paralelo, entregando um Ads Health Score (0-100), achados priorizados (Crítico → Baixo) e um plano de ação com Quick Wins.

Para geração de criativos por IA (/ads generate, /ads photoshoot) defina GOOGLE_API_KEY (Gemini, padrão) ou ADS_IMAGE_PROVIDER + a chave correspondente.

---

Estrutura

incuca-ads/
├── ads/                  # Skill orquestradora (comando /ads) + references/
├── skills/               # 14 sub-skills (ads-meta, ads-creative, ads-tracking, ...)
├── agents/               # 7 agentes (audit + criativo)
├── scripts/              # Scripts Python (relatório PDF, imagem, landing, screenshot)
├── branding/             # Templates de banner
└── .claude-plugin/       # Manifesto do plugin

---

Contribuindo

Issues e PRs são bem-vindos. Abra uma issue descrevendo o cenário (idealmente com export ou métricas anonimizadas) antes de um PR grande.

Licença

MIT © Incuca Tech