Sobre o projeto

Claude Ads é uma skill do Claude Code que traz operações de mídia paga estruturadas e baseadas em evidências para agências, consultores e equipes internas de performance. Ela cobre doze plataformas de publicidade—Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Reddit Ads, Snapchat Ads, X Ads, Apple Ads, Amazon Ads e Pinterest Ads—cada uma com uma skill focada, worker de auditoria, referência de controle, declaração de capacidade e superfície de roteamento testável. A ferramenta é somente leitura por padrão. Alterações ao vivo na conta permanecem desabilitadas até que a plataforma e a operação exatas passem pelos gates de aprovação, idempotência, verificação, auditoria e rollback. Esse design de segurança em primeiro lugar significa que a ferramenta pode ser usada para analisar e planejar sem risco de mutações não intencionais. As capacidades principais incluem: auditar contas de mídia paga com evidências datadas e níveis explícitos de confiança; planejar campanhas, canais, orçamentos, medição e experimentos; criar briefs e ativos de copy, imagem, vídeo e foto de produto; monitorar pacing, entrega, rastreamento, fadiga, política e desempenho; e produzir relatórios JSON versionados que renderizam em Markdown, HTML e PDF opcional. A arquitetura usa um único condutor que detém escopo, política, agregação e artefatos finais, despachando workers de plataforma e entre plataformas que analisam fatias limitadas e retornam descobertas válidas por esquema. Falha de worker obrigatório torna a execução parcial, em vez de apresentar silenciosamente uma auditoria incompleta como completa. A pontuação separa saúde, cobertura de evidências, exposição regulatória e oportunidades. Os controles usam estados de aprovação, falha, desconhecido ou não aplicável. Cobertura de 80% ou mais é classificada, 60 a 79% é provisória e abaixo de 60% é evidência insuficiente. Recursos opcionais, beta, premium, indisponíveis e inelegíveis permanecem sem pontuação. Um perfil de plataforma desabilitado ou não aprovado não produz pontuação de saúde. A segurança da conta exige seis condições antes de qualquer escrita: uma capacidade testada e habilitada para a operação exata, IDs explícitos de conta e objeto, um diff legível por humanos de antes e depois com raio de explosão, aprovação do proprietário dentro de limites definidos pela conta, uma chave de idempotência com destino de auditoria e rollback, e verificação de que o estado remoto ainda corresponde à pré-condição da mutação. Limites ausentes significam nenhuma escrita. Exclusão permanente não é suportada na v2. O diretório de plano de controle registra limites de produto, fontes datadas, reivindicações, capacidades, regras de segurança, regras de privacidade, decisões de ecossistema e requisitos de lançamento. Sem fonte, não há reivindicação de plataforma atual. Sem implementação, fixture e teste, não há reivindicação de capacidade. Sem aprovação e rollback, não há mutação de conta. Sem verificação independente, não há lançamento. A instalação suporta Claude Code como runtime canônico, com Codex, Gemini, Cursor, Windsurf, Goose e hosts compatíveis de Agent Skills capazes de consumir os mesmos arquivos de skill. Dependências gerenciadas suportam CPython 3.11 e 3.12 em Linux, macOS e Windows. Captura de navegador requer um payload Playwright instalado pelo operador, e renderização de PDF requer WeasyPrint e bibliotecas de sistema Pango. O projeto é lançado sob a Licença MIT, com lançamento público em Agricidaniel/claude-ads e um espelho comunitário em AI-Marketing-Hub/claude-ads para acesso antecipado e colaboração direta.