Claude Ads: o skill do Claude Code que audita suas contas de anúncios

Talvez você tenha visto o reel no Instagram: "faça em dez minutos o trabalho da sua agência de anúncios de 3.000 por mês". Por trás do gancho um pouco vendedor, existe um projeto open source bem real: o Claude Ads, um skill para o Claude Code que lê os dados das suas contas de anúncios e diz o que funciona, o que está quebrado e o que corrigir primeiro. Mais de 10.000 estrelas no GitHub em outubro de 2026, licença MIT.

Atualizado em 21 de outubro de 2026 para o Claude Ads v2.1.0, lançado em 16 de outubro de 2026. A primeira versão deste artigo descrevia a v1.7.1. Desde a v2, o skill cobre doze plataformas em vez de oito, não produz mais uma nota de 0 a 100, e os autores agora desaconselham a instalação em uma linha que mostrávamos. Tudo o que vem a seguir foi verificado no README e nos arquivos do skill na v2.1.0.

O que é exatamente o Claude Ads

O Claude Ads é um skill do Claude Code criado por Daniel Agrici. Um skill é um pacote de instruções, referências e agentes que seu agente de código carrega sob demanda: aqui, o know-how de um auditor de mídia paga, dividido em módulos. Não é um produto da Anthropic, e não tem nada a ver com anúncios dentro do Claude: a Anthropic escreveu em fevereiro de 2026 que o Claude vai continuar sem anúncios.

Ele existe em dois lugares: a versão pública em AgriciDaniel/claude-ads (MIT, sem assinatura) e um espelho comunitário em AI-Marketing-Hub/claude-ads, onde os membros de uma comunidade paga têm acesso antecipado.

O que vem na v2.1.0:

• 12 plataformas de anúncios: Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat e X.
• 33 skills por trás de um único comando /ads, um por plataforma mais os transversais (atribuição, tracking do lado do servidor, criativos, landing pages, orçamento, planejamento, relatórios).
• 25 definições de agentes: um worker de auditoria por plataforma, workers de tracking, orçamento, criativos, políticas e conformidade regulatória, quatro agentes criativos (redator de copy, estrategista criativo, adaptador de formatos, designer visual) e agentes de pesquisa e verificação.
• Quatro resultados possíveis por verificação: pass, fail, unknown ou not_applicable. Unknown significa que o dado estava faltando, e o skill nunca tenta adivinhá-lo.
• Nenhuma pontuação de saúde por enquanto. O projeto se apresenta como candidato de desenvolvimento, e os doze perfis de pontuação de saúde das contas estão desativados. Em vez disso, uma auditoria entrega achados, incógnitas e uma cobertura de evidências: com 80 % de cobertura ou mais há avaliação, de 60 a 79 % é provisória, abaixo de 60 % as evidências são insuficientes.

Os números antigos que você talvez tenha lido em outros lugares, 250 verificações, uma nota de 0 a 100 com um conceito de A a F, oito plataformas, descrevem a v1. Não é mais o que o skill diz de si mesmo.

Como funciona por baixo do capô

Um maestro controla o escopo da execução, as regras, a agregação e o relatório final. Os workers analisam fatias delimitadas, uma plataforma ou um tema cada um, e devolvem achados em um esquema fixo. Se um worker necessário falha, a execução é marcada como parcial: nunca é apresentada como uma auditoria completa.

Configurar, auditar, revisar: as três etapas do fluxo v2, do repositório oficial.

Se você já usa o Claude Code para escrever código, vai reconhecer o padrão: é o mecanismo dos subagentes e equipes de agentes, aplicado ao marketing em vez do código. Desde a v2.1.0, os agentes não fixam mais um modelo: o Claude Code os roda com o modelo da sua conversa principal, a menos que algo mais específico esteja configurado.

O resultado de uma execução é um arquivo JSON versionado. Os relatórios em Markdown, HTML e PDF são renderizações desse mesmo arquivo, por isso o /ads report consegue mostrar de novo uma execução passada sem rodar nada.

Na prática, o fluxo cabe em cinco etapas:

1. Rode /ads setup e responda às perguntas: modelo de negócio, objetivo, conversão principal, gasto mensal, plataformas ativas e quem aprova as alterações. Ele avisa para você nunca colar chaves de API ou tokens ali.
2. Traga evidências: uma exportação da conta em CSV ou JSON, capturas de tela ou um resumo colado com o período, a moeda e o fuso horário.
3. Rode /ads audit google, ou /ads audit all. Você recebe o que passou, o que falhou e o que está faltando.
4. Rode /ads report para ver de novo uma execução passada.
5. Rode /ads next para ver o bloqueio mais importante.

As doze plataformas

Cada plataforma tem seu próprio skill, seu próprio worker de auditoria, sua própria referência de controles e sua própria declaração de capacidades. Um manifesto de capacidades no repositório registra o que pode ser lido ou alterado ao vivo em cada plataforma. Acima das plataformas vêm as auditorias transversais: atribuição (definições de conversão, janelas, GA4, parceiros de mensuração mobile) e tracking do lado do servidor (tagueamento server-side, Conversions API e Events API, deduplicação, qualidade dos dados de eventos). Muitas vezes são os pontos cegos das auditorias humanas, porque exigem ao mesmo tempo competências de mídia e técnicas.

Os comandos

Tudo passa pelo /ads. Instalado como plugin do Claude Code, os comandos ficam em um namespace e começam com /claude-ads:ads; instalado de forma avulsa, começam com /ads. O README lista estes:

Os atalhos de plataforma levam direto a uma auditoria: /ads google, /ads meta, /ads youtube, /ads linkedin, /ads tiktok, /ads microsoft, /ads apple, /ads amazon, /ads reddit, /ads pinterest, /ads snapchat e /ads x.

Os comandos especializados da v1 continuam sendo roteados pelo skill: /ads dna para o perfil de marca e de oferta de um site, /ads attribution, /ads tracking, /ads creative, /ads landing, /ads budget, /ads math para CPA, ROAS, MER, LTV:CAC e ponto de equilíbrio, /ads competitor, /ads generate para imagens a partir de um brief validado, /ads photoshoot para variantes de fotos de produto, e /ads test como outro nome para /ads experiment. Um pedido em linguagem natural vai para os mesmos skills. Nenhum skill gera vídeo: o trabalho de vídeo para nos conceitos e briefs.

Instale com segurança

Os autores agora escrevem sem rodeios: prefira o fluxo de plugins do host ou um arquivo de release conferido com seu checksum, e nunca passe um instalador remoto direto para um shell. A primeira versão deste artigo mostrava exatamente isso, um curl | bash e um irm | iex: não use.

Dentro do Claude Code, o fluxo de plugins:

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

Se você adicionou o marketplace antes da v2.0.0, o Claude Code ainda o guarda com um alias antigo. Remova-o primeiro:

/plugin marketplace remove agricidaniel-claude-ads

A partir de um clone que você leu, no macOS ou Linux:

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

No Windows, no PowerShell, a partir do mesmo clone: .\install.ps1 -Source local.

Para fixar uma versão, bash install.sh --source=git --ref=v2.1.0 faz o checkout exatamente dessa tag e falha se ela não for resolvida. O caminho verificado continua sendo um zip de release: cada release do GitHub publica o zip, um manifesto, uma lista de materiais de software e um arquivo SHA256SUMS, e cada linha de sha256sum -c SHA256SUMS precisa dizer OK antes de você descompactar. As releases têm checksum, mas não são assinadas.

O que ele precisa: CPython 3.11 ou 3.12 para as dependências gerenciadas, glibc 2.28 ou mais recente no Linux, as bibliotecas WeasyPrint e Pango para os relatórios em PDF, e um navegador Playwright se você quiser capturas pelo navegador.

O instalador também tem --target=codex, --target=gemini e destinos para Cursor, Windsurf e Goose. O README os marca como experimentais: só o Claude Code é verificado, e os outros hosts podem tratar os mesmos arquivos de outro jeito.

O fluxo do reel, revisitado

O reel do Instagram que deixou o skill famoso mostra três etapas. Aqui estão elas com a v2.1.0.

Etapa 1: instale o skill. Pelo fluxo de plugins acima, não com uma linha colada.

Etapa 2: descreva seu negócio e depois planeje. O /ads setup pergunta sobre sua oferta, objetivo, conversão, orçamento e plataformas. Se você tem um site, /ads dna <url> extrai seu perfil de marca e de oferta para que o plano parta do seu posicionamento real. Depois, /ads plan monta o plano de canais, campanhas, orçamento e mensuração.

Etapa 3: o relatório. O /ads report renderiza a execução salva em Markdown, HTML ou PDF, pronta para enviar a um cliente ou à sua diretoria.

Onde o reel simplifica: o resultado só é tão bom quanto as evidências. Dê respostas vagas e você recebe um plano vago. Rode uma auditoria sem exportação nem capturas de tela e você recebe um relatório cheio de unknown, o que é honesto, mas não é um diagnóstico. E na v2.1.0 não há nota para exibir: você recebe achados e quanto da conta pôde ser avaliado.

Seus dados e suas contas

O skill roda no seu terminal e analisa as evidências que você fornece. As credenciais ficam em variáveis de ambiente, no chaveiro do sistema operacional ou em um gerenciador de segredos; nunca no repositório, nos perfis, nos relatórios ou nos logs.

A maior mudança desde a v1 está no lado da escrita. A v2 tem /ads launch e /ads optimize, mas cada adaptador é somente leitura por padrão e as alterações ficam como rascunhos. Para aplicar uma, o skill precisa de todas estas seis condições:

1. uma capacidade testada e ativada para aquela operação exata;
2. IDs de conta e de objeto explícitos;
3. um diff legível de antes e depois, com o que ele afeta;
4. a aprovação do proprietário, dentro dos limites definidos para a conta;
5. uma chave de idempotência, um destino para o registro de auditoria, um rollback e uma janela de verificação;
6. uma verificação de que a conta ainda corresponde ao que a alteração espera.

Sem limites definidos não há escrita, e a exclusão definitiva não é suportada na v2.

O que ele substitui, e o que não substitui

Vamos ser honestos, porque "substitua sua agência de 3.000 por mês" merece nuances.

O que o Claude Ads faz bem: a parte sistemática do trabalho. Passar todos os controles em uma conta sem esquecer nenhum, conferir o tracking com o que a plataforma espera, identificar a fadiga dos criativos, recalcular os pontos de equilíbrio e dizer com clareza o que não pôde ser verificado. É a parte objetiva e repetível de uma auditoria, aquela que até um bom consultor faz mais devagar que uma máquina.

O que ele não faz: apertar os botões por você por padrão, nem conhecer o contexto que sua agência conhece: sua sazonalidade, os testes que já falharam, o relacionamento com seu contato no Google. E como qualquer saída de IA, as recomendações dele devem ser verificadas antes de você comprometer um 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 as próprias campanhas, é um nível de auditoria que ele não tinha. Para uma agência, a auditoria que levava meio dia por conta vira um ponto de controle 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 continua rodando.

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 o skill Claude Ads no Claude Code dele, e ele se torna seu media buyer júnior: ele pega os tickets de auditoria no backlog, roda seus comandos /ads e entrega o relatório como saída.

O ciclo completo se parece com isto. O agente Ads lança /ads audit all nas suas exportações de segunda de manhã e publica seus achados no backlog. Os problemas técnicos que ele levanta (uma conversão do GA4 contada em dobro, 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 landing pages alinhadas com as campanhas que estão no ar. Você lê os relatórios, e é você quem aprova uma alteração antes que ela chegue a uma conta de anúncios.

Mantenha o agente Ads no Claude Code, o único host que o Claude Ads verifica. Seus agentes de código podem rodar no CLI que você preferir: o AgentsRoom os roda lado a lado na mesma janela, qualquer que seja o provedor, 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.

Perguntas frequentes

O Claude Ads é feito pela Anthropic?

Não. O Claude Ads é um skill open source para o Claude Code escrito por Daniel Agrici e publicado sob a licença MIT em github.com/AgriciDaniel/claude-ads. A Anthropic faz o Claude e o Claude Code; o skill roda em cima deles.

O Claude mostra anúncios?

Não. Em seu post de 4 de fevereiro de 2026, Claude is a space to think, a Anthropic escreveu que o Claude vai continuar sem anúncios: nenhum link patrocinado ao lado das conversas e nenhuma resposta influenciada por anunciantes. O Claude Ads serve para auditar suas próprias contas de anúncios, não para exibir anúncios dentro do Claude.

O Claude Ads ainda dá uma nota de 0 a 100?

Não na v2.1.0. Os doze perfis de pontuação de saúde das contas estão desativados, então a auditoria entrega achados, incógnitas e uma cobertura de evidências em vez de uma nota. Cada verificação termina em pass, fail, unknown ou not_applicable, e unknown significa que o dado estava faltando.

O Claude Ads pode alterar minhas campanhas de anúncios?

Não por conta própria. Cada adaptador é somente leitura por padrão e as alterações ficam como rascunhos. Aplicar uma exige uma capacidade ativada para aquela operação exata, IDs de conta e de objeto explícitos, um diff de antes e depois, a aprovação do proprietário dentro dos limites da conta, um rollback e a verificação de que a conta não mudou desde então. A exclusão definitiva não é suportada na v2.

O Claude Ads funciona com Codex ou Gemini CLI?

O instalador dele tem destinos Codex, Gemini, Cursor, Windsurf e Goose, mas o README os marca como experimentais: só o Claude Code é verificado. Instale no Claude Code se você quer o caminho com suporte.

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.