Claude Ads: o skill do Claude Code que audita suas contas de anúncios
Claude Ads é um skill open source para o Claude Code: mais de 250 verificações no Google, Meta, LinkedIn, TikTok ou Amazon Ads, uma nota sobre 100 e um plano de ação priorizado, em cerca de dez minutos. Instalação, comandos, limites e como orquestrá-lo no AgentsRoom.
Talvez você tenha visto o vídeo no Instagram: «faça o trabalho da sua agência de anúncios de 3.000 euros por mês em dez minutos». Por trás do gancho um pouco vendedor há um projeto open source bem real: Claude Ads, um skill para o Claude Code que transforma seu terminal em um auditor de contas de anúncios. Mais de 6.000 estrelas no GitHub, licença MIT e uma promessa com números: auditar manualmente uma única conta do Google Ads leva de 4 a 6 horas de um consultor de PPC sênior, o Claude Ads faz a mesma auditoria em 10 a 15 minutos.
Instalamos o skill, lemos o repositório de ponta a ponta, e aqui está o que ele faz de verdade, como instalá-lo, onde ele para e por que faz todo sentido quando você o orquestra em um cockpit multiagente.
O que é o Claude Ads exatamente
O Claude Ads é um skill do Claude Code criado por Daniel Agrici, um arquiteto de workflows de IA. Um skill é um pacote de instruções, referências e agentes que seu agente de código carrega sob demanda: aqui, todo o know-how de um auditor de PPC sênior, dividido em módulos.
Na prática, o skill embarca:
- Mais de 250 verificações de auditoria distribuídas por 8 plataformas de anúncios: Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple e Amazon Ads.
- Um algoritmo de pontuação ponderada: cada problema detectado tem uma severidade, tudo agregado em uma nota de 0 a 100 com um conceito de A a F, como um boletim escolar para sua conta de anúncios.
- 10 agentes especializados: 6 agentes de auditoria que rodam em paralelo e 4 agentes criativos para a geração de campanhas.
- 22 sub-skills organizados em módulos: um por plataforma, mais módulos transversais (atribuição, tracking server-side, orçamento, cálculos financeiros).
- 12 templates setoriais para o planejamento estratégico: SaaS, e-commerce, B2B e outros tipos de negócio.
- Uma arquitetura local-first: os dados da sua conta não saem da sua máquina, voltaremos a isso mais abaixo.
O projeto é mantido ativamente (v1.7.1 no momento em que escrevemos estas linhas, com um roadmap público de 12 meses) e mira explicitamente três perfis: as agências de PPC que gerenciam mais de 5 contas, os profissionais de marketing in-house que fazem malabarismo com várias plataformas e os consultores freelance que vendem auditorias.
Como funciona por baixo do capô
O coração do sistema é a delegação em paralelo. Quando você roda /ads audit, o orquestrador não percorre uma checklist sozinho: ele despacha seis subagentes simultâneos, cada um especialista em um domínio. Um agente disseca o Google Ads, outro o Meta, um terceiro a qualidade dos criativos, um quarto o tracking, um quinto os orçamentos e lances, um sexto a conformidade. Seus resultados são então agregados, ponderados e priorizados.
Seis especialistas em paralelo em vez de um generalista em sequência: é isso que reduz a auditoria de várias horas para cerca de dez minutos.
Se você já usa o Claude Code para programar, vai reconhecer o padrão: é exatamente o mecanismo dos subagentes e das equipes de agentes, aplicado ao marketing em vez do código. Cada subagente tem seu próprio contexto, sua própria especialidade, e o orquestrador guarda apenas a síntese.
O percurso completo cabe em cinco etapas: você fornece os dados da sua conta (exportação CSV ou conexão via API por MCP), os agentes de auditoria rodam em paralelo, cada verificação é pontuada e ponderada por severidade, a nota global é calculada e você recebe um plano de ação priorizado com os problemas classificados por impacto.
As plataformas cobertas, em números
A cobertura não é uniforme, e isso é até um bom sinal: ela reflete a complexidade real de cada plataforma.
| Plataforma | Verificações | O que é coberto |
|---|---|---|
| Google Ads | 80 checks | Search, Performance Max, AI Max, Display, YouTube, Demand Gen |
| Meta Ads | 50 checks | Facebook, Instagram, Threads, Advantage+, o ecossistema Andromeda |
| Apple Ads | 35+ checks | Custom Product Pages, AdAttributionKit, Today Tab |
| Amazon Ads | 30+ checks | Sponsored Products, Brands, Display, índices ACOS e TACOS |
| TikTok Ads | 28 checks | criativos, TikTok Shop, Smart+ |
| LinkedIn Ads | 27 checks | B2B, Lead Gen, Thought Leader Ads, ABM |
| Microsoft Ads | 24 checks | Bing, Copilot, validação das importações do Google |
A isso se somam módulos transversais: uma auditoria de atribuição cross-platform (GA4, Consent Mode V2, MMP) e uma auditoria do tracking server-side (sGTM, CAPI Gateway, deduplicação, hashing dos dados). Esses são muitas vezes os pontos cegos das auditorias humanas, porque exigem uma dupla competência de mídia e técnica.
Os comandos: um por função da agência
Uma vez instalado, tudo passa por comandos slash. Eles se organizam em quatro famílias, que cobrem mais ou menos o organograma de uma agência de mídia.
A auditoria, o coração do skill:
| Comando | O que ele faz |
|---|---|
/ads audit | auditoria multiplataforma completa, com os 6 agentes em paralelo |
/ads google, /ads meta, /ads youtube, /ads linkedin, /ads tiktok, /ads microsoft, /ads apple, /ads amazon | análise aprofundada de uma única plataforma |
/ads attribution | auditoria da atribuição cross-platform |
/ads tracking | auditoria do pipeline de tracking server-side |
/ads creative | qualidade dos criativos e detecção de fadiga publicitária |
/ads landing | avaliação das landing pages ligadas às campanhas |
/ads budget | alocação orçamentária e estratégias de lances |
A estratégia, o papel do consultor:
| Comando | O que ele faz |
|---|---|
/ads plan <type> | plano publicitário estratégico a partir dos 12 templates setoriais |
/ads competitor | inteligência competitiva publicitária em todas as plataformas |
/ads math | calculadora financeira de PPC: CPA, ROAS, ponto de equilíbrio, LTV:CAC |
/ads test | concepção de testes A/B: hipótese, significância, tamanho da amostra |
A criação, o estúdio:
| Comando | O que ele faz |
|---|---|
/ads dna <url> | extrai o DNA de marca de um site para um perfil reutilizável |
/ads create | gera conceitos de campanha e briefs de copy |
/ads generate | gera visuais publicitários por IA a partir do brief |
/ads photoshoot | fotos de produto em 5 estilos: studio, floating, ingrediente, in use, lifestyle |
O entregável, por fim: /ads report compila tudo em um relatório PDF pronto para enviar a um cliente. É este comando que faz a ligação com o vídeo viral: auditoria, plano estratégico, relatório final, o tríptico faturável de uma agência.
Instalação em dois minutos
O mais simples, no Claude Code:
/plugin marketplace add AI-Marketing-Hub/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads
Ou em um único comando de shell no macOS e Linux:
curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-ads/main/install.sh | bash
E no Windows, em PowerShell:
irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-ads/main/install.ps1 | iex
Um detalhe que conta se você não quer se prender a um único fornecedor: o instalador também sabe mirar outros agentes CLI. bash install.sh --target=codex o instala para o Codex CLI, e existem alvos para Cursor, Windsurf, Gemini CLI e Goose. O skill não está soldado ao Claude, é um know-how portável de um agente para outro.
O workflow do vídeo, passo a passo
O vídeo do Instagram que tornou o skill conhecido mostra três passos. Aqui estão eles, com o que acontece de fato em cada um.
Passo 1: instalar o skill. Você copia o comando de instalação no seu terminal, e o Claude Code busca o orquestrador, os sub-skills, os agentes e os 26 arquivos de referência que servem de base de conhecimento.
Passo 2: /ads plan com o seu tipo de negócio. O skill faz perguntas sobre sua atividade (oferta, público, orçamento, mercados), recorre aos seus 12 templates setoriais e produz um plano publicitário estratégico: quais plataformas priorizar, qual estrutura de campanhas, quais orçamentos, quais mensagens. Se você tem um site, /ads dna <url> extrai primeiro seu posicionamento, sua voz e seus diferenciais para ancorar o plano na sua marca real em vez de em algo genérico.
Passo 3: o relatório PDF. Você pede para transformar o plano em um entregável, e /ads report gera um relatório estruturado: síntese, notas, plano de ação priorizado, tudo diagramado para ser enviado como está a um cliente ou à sua direção.
Onde o vídeo simplifica: a qualidade da saída depende diretamente da qualidade da entrada. Um /ads plan alimentado com respostas vagas produz um plano vago. E uma auditoria sem dados reais de conta (exportação ou conexão via API) continua sendo uma análise de estrutura, não um diagnóstico de desempenho.
Seus dados ficam com você
Ponto importante para as agências e as empresas: a arquitetura é local-first. O skill roda no seu terminal, analisa os dados que você lhe dá e não empurra nada para um serviço de terceiros. Sem plataforma SaaS intermediária que armazene o desempenho dos seus clientes.
Para passar das exportações manuais aos dados ao vivo, o skill documenta integrações MCP opcionais: um servidor MCP Google Ads com 29 ferramentas GAQL para consultar a API em tempo real, Adspirer para Meta, GrowthSpree ou Adzviser para LinkedIn. É você quem escolhe abrir essas conexões, com seus próprios acessos de API. Para uma conta de cliente sob NDA, você pode ficar no modo exportação CSV: nada sai da sua máquina.
O que ele substitui, e o que não substitui
Sejamos honestos, porque o «substitui sua agência de 3.000 euros por mês» merece nuances.
O que o Claude Ads faz muito bem: a parte sistemática do ofício. Passar 250 verificações em uma conta sem esquecer nenhuma, cruzar as configurações de tracking com as recomendações da plataforma, detectar a fadiga criativa, recalcular pontos de equilíbrio, produzir um relatório limpo. É a parte da auditoria que é objetiva, repetível, e que mesmo um bom consultor faz mais devagar do que uma máquina.
O que ele não faz: apertar os botões no seu lugar. O skill diagnostica e recomenda, ele não modifica suas campanhas. Ele também não conhece o contexto que sua agência conhece: a sazonalidade do seu negócio, o histórico dos testes que fracassaram, a relação com seu contato comercial no Google. E como todo output de IA, suas recomendações são verificadas antes de comprometer orçamento de mídia real.
O enquadramento certo: o Claude Ads não substitui o julgamento, ele substitui as horas faturadas para percorrer checklists. Para um empreendedor que gerencia suas próprias campanhas, é um nível de auditoria ao qual ele simplesmente não tinha acesso. Para uma agência, é um multiplicador: a auditoria que levava meio dia por conta vira um ponto de passagem semanal.
Claude Ads no AgentsRoom: seu polo de publicidade ao lado do polo de dev
É aqui que fica interessante se você já usa agentes para programar. Um skill como o Claude Ads, lançado à mão em um terminal, é uma ferramenta. O mesmo skill, confiado a um agente dedicado em um cockpit multiagente, é um polo de negócio que roda.
O AgentsRoom foi feito exatamente para isso: cada agente tem um papel, um status ao vivo e sua própria cor, e você supervisiona toda a frota a partir de uma única janela. Nada obriga você a rodar apenas agentes de código. Crie um agente com um papel de publicidade, instale nele o skill Claude Ads, e ele se torna seu media buyer júnior: ele pega os tickets de auditoria no backlog, percorre seus comandos /ads e deposita o relatório como saída.
O ciclo completo se parece com isto. O agente Ads lança /ads audit nas suas exportações de segunda de manhã e coloca suas conclusões no backlog. Os problemas técnicos que ele reporta (uma conversão do GA4 contada em dobro por deduplicação, um Consent Mode mal configurado, uma landing page lenta demais) viram tickets que seu agente de dev pega e corrige no código, cada um no seu próprio worktree para que os agentes em paralelo nunca se atrapalhem. Enquanto isso, um agente de SEO mantém as páginas de destino alinhadas com as campanhas que estão no ar. Você relê os relatórios e valida o que vai para produção.
E como o Claude Ads também se instala no Codex, Gemini CLI ou Cursor, ele se encaixa naturalmente em uma frota multi-provider: seu agente de auditoria pode rodar em um provedor diferente dos seus agentes de código, no mesmo dashboard, e a matriz de compatibilidade lista o que é suportado.
O ofício ao lado sempre foi o mais difícil de integrar: dev não fala de mídia, mídia não fala de dev. Uma frota de agentes que compartilham o mesmo backlog fecha essa lacuna melhor do que qualquer reunião semanal.
Instale o skill, lance sua primeira /ads audit, e se você quer que isso rode sem você: baixe o AgentsRoom e dê ao seu polo de publicidade a mesma infraestrutura que o seu polo de dev.
Baixar AgentsRoom
Rode seus agentes Claude em todos os seus projetos, de uma única janela.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
Envie bugs e pedidos direto para o seu backlog público.
Uma visão do AgentsRoom em ação.