Claude Ads
Skill open-source de operações de mídia paga para agentes de código: auditorias com evidência, planos e mudanças de conta em rascunho em doze plataformas de anúncios
Claude Ads é um pacote de skills com licença MIT que transforma o Claude Code —ou Codex, Gemini, Cursor e outros hosts de Agent Skills— em um operador de mídia paga em doze plataformas de anúncios. Ele lê exportações ou leituras de API autorizadas da conta e devolve auditorias baseadas em evidência, planos de mídia, briefings criativos, passagens de monitoramento e relatórios JSON versionados. Todo adaptador é somente leitura por padrão: aplicar uma mudança exige uma capacidade habilitada, um diff explícito de antes e depois, aprovação do dono dentro dos limites da conta e um plano de reversão. É uma camada de operações para quem já anuncia, não um jeito de parar de pensar nos anúncios.
O que é o Claude Ads
O repositório se descreve como operações de mídia paga portáteis e pensadas para o Claude, voltadas a agências, consultores e times internos de performance. Concretamente, é um conjunto de skills e agentes trabalhadores que um assistente de código carrega: uma skill e um worker de auditoria por plataforma, mais passagens de planejamento, criação, monitoramento e relatório entre plataformas. O README lista doze superfícies de primeira classe: Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Reddit Ads, Snapchat Ads e X Ads do lado de busca, vídeo e social, com Apple Ads, Amazon Ads e Pinterest Ads cobrindo comércio e retail media. O Claude Code é o runtime canônico; os mesmos arquivos de skill são documentados como utilizáveis por Codex, Gemini, Cursor, Windsurf e Goose onde esses hosts suportam Agent Skills.
As entranhas são mais disciplinadas do que a categoria costuma ser. Um condutor controla escopo, política e o artefato final; os workers analisam fatias delimitadas e devolvem achados válidos contra esquema; a saída canônica é JSON versionado, e as versões em Markdown, HTML e PDF são renderizações desse mesmo pacote validado. Quando um worker obrigatório falha, a execução é marcada como parcial — o README é explícito em que uma execução parcial nunca é apresentada silenciosamente como auditoria completa. O repositório público é MIT, está em 7.804 estrelas em 2026-08-04 e teve seu último lançamento como v2.0.1 em julho de 2026. É Python, e quer CPython 3.11 ou 3.12, com Playwright para captura em navegador e WeasyPrint para renderizar PDF.
Para que os comandos realmente servem
A superfície de comandos se lê como um ciclo completo de compra de mídia, o que ajuda a enxergar onde um agente ajuda de fato e onde estruturalmente não consegue. Agrupados pelo trabalho que fazem:
- Configuração e auditoria `/ads setup` monta o perfil de cliente, conta, KPI, privacidade e salvaguardas; `/ads audit` roda uma passagem completa ou delimitada baseada em evidência. Esta é a metade que realmente ganha com um agente: o trabalho tedioso em formato de checklist que quase ninguém faz com a frequência necessária.
- Planejar e criar `/ads plan` produz planos de canal, orçamento, concorrência e mensuração; `/ads create` produz briefings de texto, imagem, vídeo e foto de produto. Rascunhos, em outras palavras. O julgamento sobre o que de fato rodar continua com você.
- Lançar e otimizar, sempre em rascunho primeiro `/ads launch --draft` e `/ads optimize --draft` produzem um plano de mutação sem tocar na conta. A flag é o design: nada chega a uma conta ativa por padrão.
- Monitorar, experimentar, reportar Checagens de ritmo, entrega, rastreamento, fadiga e políticas; desenho e leitura de testes controlados; e um pacote JSON validado. O laço de monitoramento é onde o anunciante pequeno costuma perder dinheiro, porque ninguém está olhando todo dia.
A parte que vale copiar mesmo sem instalar
Duas decisões de projeto neste repositório valem ser roubadas para qualquer sistema que gaste dinheiro em seu nome. A primeira é que todo adaptador é somente leitura até que uma operação específica seja deliberadamente habilitada, e aplicar uma mudança então exige tudo isto: uma capacidade testada para aquela operação exata, IDs explícitos de conta e objeto, um diff legível de antes e depois com raio de impacto, aprovação do dono dentro de tetos definidos, uma chave de idempotência com destino de auditoria e reversão, e a verificação de que o estado remoto ainda satisfaz a precondição. Sem tetos configurados não há escrita, e exclusão permanente simplesmente não é suportada.
A segunda é como ele lida com o que não sabe. Controles resolvem para pass, fail, unknown ou not-applicable, e os unknown reduzem a cobertura de evidência sem mexer na nota de saúde — então uma auditoria rasa se reporta como rasa, e não como boa notícia. Cobertura de 80% ou mais é avaliada, de 60 a 79% é provisória e abaixo de 60% é declarada evidência insuficiente. É uma propriedade rara em ferramentas de IA, onde a falha usual é um resumo confiante construído sobre os dados que por acaso carregaram. Se você está avaliando qualquer agente que toque em verba, pergunte o que ele faz quando falta uma fonte: a resposta separa os projetos sérios das demos.
Vale também dizer os limites honestos. É uma camada de operações, não um comprador de mídia: as contas, a verba e a decisão continuam sendo suas. Uma maquinaria de doze plataformas é mais do que precisa um fundador que gasta algumas centenas por mês, e a cadeia de dependências de Python mais Playwright mais WeasyPrint é um custo de instalação real. E uma auditoria de uma conta mal segmentada informa exatamente com que eficiência você está comprando o tráfego errado — o retorno sobre o investimento em anúncios melhora ao consertar a oferta pelo menos tão frequentemente quanto ao consertar a campanha.
Uma nota de primeira mão sobre rodar os próprios anúncios
Nós rodamos Google Ads para a AgentCeres —o AI Growth Officer em agentceres.com— e chegamos por conta própria à mesma postura com que este repositório já vem, o que é parte do motivo de valer a cobertura. Nossa ferramentaria de anúncios é somente leitura por padrão: os scripts puxam relatórios e um snapshot diário, e qualquer mudança na conta é uma decisão deliberada caso a caso, não algo que a automação executa. Toda mudança ganha um registro no mesmo dia dizendo o que mudou, por quê, como verificar e como reverter. Esse registro foi mais útil do que qualquer painel, porque a pergunta que você realmente precisa responder duas semanas depois é qual mudança moveu o número.
A outra coisa que nossa própria conta ensinou é onde está a alavanca, e não é onde as ferramentas de auditoria apontam. A única mudança que mais importou foi pausar um termo genérico de alto volume que estava comprando visitantes fora do nosso perfil de cliente ideal — não um ajuste de lance, não uma renovação de criativo. Nenhuma otimização conserta uma campanha mirada nas pessoas erradas; a segmentação está a montante de tudo o que um motor de pontuação consegue medir. Se você está antes dessa decisão, uma startup em estágio inicial deve investir em anúncios? é a pergunta mais útil, e nosso Gestor de Mídia Paga rascunha campanhas e mantém o gasto atrás de uma aprovação. Para a metade orgânica do mesmo stack, marketingskills é o vizinho mais próximo deste projeto.
FAQ
- O Claude Ads é gratuito?
- O repositório público tem licença MIT e não exige nenhuma assinatura, então você pode instalar e usar sem custo de software. O README também aponta para um mirror comunitário no qual membros de um grupo pago têm acesso antecipado, o que é bom saber mas não bloqueia a versão pública. Seus custos reais são os tokens de modelo que as auditorias consomem e o próprio acesso às APIs das plataformas.
- Ele vai mexer na minha conta de anúncios?
- Não, a menos que você faça bastante esforço para isso. Os adaptadores são somente leitura por padrão, e uma escrita exige uma capacidade habilitada para aquela operação exata, IDs de objeto explícitos, um diff de antes e depois, aprovação do dono dentro de tetos de gasto definidos e um plano de reversão — sem teto configurado, nenhuma escrita acontece. Tanto `launch` quanto `optimize` são documentados como rascunho-primeiro, então a saída normal é um plano de mutação para você revisar.
- Preciso ser técnico para usar?
- Mais do que a embalagem de ferramenta de marketing sugere. A instalação é um git clone mais um script de instalação ou um comando de plugin do Claude Code, e o conjunto completo espera um ambiente Python 3.11 ou 3.12, uma carga de navegador Playwright para captura e bibliotecas de sistema para renderizar PDF. Se você se vira num terminal, é uma tarde; se não, a saída da auditoria continua legível, mas chegar até ela é um obstáculo real.
- Isso substitui uma agência?
- Substitui a parte de auditoria e relatório do que uma agência faz, que é genuinamente a mais sistemática e a mais negligenciada. Não substitui as decisões de julgamento —qual mercado mirar, qual deve ser a oferta, quando parar de gastar— e não consegue concluir que a campanha está boa e o problema é a landing page. Uma forma útil de pensar é que ele deixa um bom operador mais rápido e dá ao fundador que não tem nenhum uma checklist difícil de pular.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.