Nosso head de crescimento, Ivan Falco, gerencia US$ 300 mil por mês em anúncios no Google, Meta e LinkedIn sem abrir um único gerenciador de anúncios. Ele faz isso de um terminal, em inglês simples, dentro do Claude Code.
Ele passou mais de 200 horas transformando isso em 12 habilidades, e então colocou tudo em um repositório público. Estamos detalhando exatamente como funciona abaixo, para que qualquer pessoa tentando fazer isso consiga rodar sem adivinhar. Se preferir apenas receber os arquivos, comente "ads" e enviaremos o repositório.
Algumas partes exigem paciência, e vamos sinalizá-las ao longo do caminho. No final, você saberá o que é isso, o que não pode fazer, os prompts exatos para executar e a ordem para ativar tudo sem explodir uma conta ativa no primeiro dia. Este é o manual completo, então siga a ordem.
O lançamento em quatro fases: clonar e integrar, conectar contas, ler antes de escrever, entregar as chaves
O que você está instalando
Mapa do sistema: Claude Code no centro, as quatro habilidades e a camada de fundamentos
Primeiro, a coisa que mais confunde as pessoas.
Isso roda no Claude Code no seu próprio computador, que é o comando claude no seu terminal ou no aplicativo de desktop Claude Code configurado como Local. Não roda no aplicativo de chat em claude.ai. O aplicativo de chat vive na nuvem e não pode executar scripts na sua máquina, ler suas chaves de API ou falar com suas contas de anúncios. Execute no aplicativo de chat por engano e nada funciona, e você vai achar que o repositório está quebrado quando não está.
O que você está instalando é um conjunto de habilidades.
Uma habilidade é uma pasta que ensina ao Claude Code uma tarefa: o que fazer, como fazer e quando fazer. Cada uma carrega arquivos de estratégia que contêm os frameworks e benchmarks, scripts Python que chamam as APIs da plataforma de anúncios diretamente e lógica de roteamento que diz ao Claude qual conhecimento carregar para a tarefa em questão.
Os scripts são a camada de automação, a parte que extrai um relatório ou faz uma edição em massa.
A base de conhecimento é a camada de estratégia, a parte que sabe como executar anúncios B2B pagos. Os scripts economizam seu tempo. A base de conhecimento é onde está a verdadeira vantagem, porque é a diferença entre um agente que executa uma instrução burra e um que executa a instrução certa.
Tudo é construído sobre o Mecanismo de Demanda em 5 Estágios que executamos em todas as nossas contas, que substitui o antigo funil TOFU, MOFU, BOFU e aloca o orçamento por estágio e canal.
O que você precisa antes de começar
Três coisas. Claude Code instalado. Python 3.10 ou mais novo, já que os scripts rodam nele. E acesso à API para cada plataforma de anúncios que você quer gerenciar.
Essa última parte é a que exige paciência.
Ler a estratégia e pedir auditorias não precisa de configuração alguma, você pode fazer isso no minuto em que clonar o repositório. Para permitir que o agente extraia relatórios ao vivo e faça edições reais, cada plataforma precisa de credenciais de API, e as aprovações andam em velocidades diferentes. Meta e Google são rápidos. A API de Publicidade do LinkedIn pode levar um ou dois dias para ser aprovada, então, se o LinkedIn for seu canal principal, solicite esse acesso primeiro e vá fazer outra coisa enquanto espera.
Fase um: clone e conheça o agente
Os movimentos iniciais são três comandos.
git clonedo repositório, depoiscdpara a pasta.- Execute
claudepara abrir o Claude Code dentro dela. - Digite
/onboarding.
O onboarding é uma configuração interativa de cinco minutos.
Ele verifica se você está no lugar certo, pergunta quais plataformas você usa e orienta você pelas credenciais uma plataforma de cada vez, em vez de despejar uma parede de instruções. Você também pode pular e apenas começar a perguntar.
O agente carrega a habilidade certa para o que você digitou.
Fase dois: conecte suas contas de anúncios
Esta é a parte mais complicada, então aqui está o que cada plataforma realmente pede.
Para o LinkedIn, você cria um aplicativo no portal de desenvolvedores do LinkedIn e, em seguida, solicita a API de Publicidade na guia Produtos. Essa solicitação é a demorada.
Enquanto espera, pegue seu ID de Cliente e Segredo de Cliente na guia Autenticação, execute o script OAuth incluído, e ele captura o token automaticamente. Sua última peça é o ID da Conta de Anúncios, que é o número que está na URL do seu Gerenciador de Campanhas.
Para o Meta, você cria um aplicativo, adiciona o produto API de Marketing e gera um token com permissões de gerenciamento e leitura de anúncios.
O primeiro token que o Meta fornece expira em uma hora, então o agente ajuda você a trocá-lo por um de longa duração que dura cerca de dois meses. Em seguida, pegue seu ID da Conta de Anúncios, aquele que começa com act_.
Para o Google, você precisa de um token de desenvolvedor do Centro de API, o que geralmente significa ter uma conta de gerente configurada primeiro. Esse token mais o ID da sua conta é o que os scripts usam para autenticar.
Nada disso é difícil, mas é o tipo de configuração que as pessoas abandonam no meio do caminho. Faça uma vez, devagar, uma plataforma de cada vez. Se preferir não lidar com isso, o Ivan faz uma análise gratuita e pode ajudar, mas a maioria das pessoas consegue fazer sozinha.
Fase três: leia antes de escrever
Aqui está a ordem que mantém você seguro.
Não aponte isso para uma conta ativa e comece a deixá-la fazer edições no primeiro dia. Comece no modo somente leitura, onde cada prompt lê sua conta e devolve um resultado sem tocar em nada.
É também aqui que você aprende no que o agente é bom.
Execute as auditorias, compare-as com o que você teria concluído sozinho e só passe para as edições quando elas estiverem consistentemente alinhadas. Aqui estão os prompts iniciais exatos que executamos em cada plataforma.
No Google, onde o gasto desperdiçado se esconde à vista de todos:
"Extraia meus termos de pesquisa dos últimos 30 dias e sinalize toda consulta que gastou dinheiro com zero conversões."
"Audite meus índices de qualidade e me mostre onde estou pagando a mais ou perdendo demanda."
"Compare este mês com o anterior e me diga exatamente o que mudou e por quê."
No Meta, onde o criativo morre silenciosamente:
"Extraia meus anúncios ativos e sinalize qualquer um onde a taxa de cliques está caindo."
"Verifique cada campanha quanto à saturação excessiva do público e me diga o que rotacionar."
"Revise meu texto do anúncio com base no framework de voz do cliente na base de conhecimento."
No LinkedIn, onde os cliques são mais caros:
"Audite minha conta com base na lista de verificação de 35 itens e classifique as correções por impacto."
"Extraia dados demográficos da minha campanha principal e me mostre quais cargos e portes de empresa realmente convertem."
"Mostre-me minha estratégia de lance entre campanhas e onde estou deixando eficiência na mesa."
Cada um desses prompts é seguro para executar no primeiro dia.
Nenhum deles toca em nada. Eles apenas mostram a conta pelos olhos de alguém que já executou este manual com muito gasto.
As habilidades e o que cada uma executa
O repositório é organizado em quatro habilidades, uma por plataforma, mais a de configuração.
LinkedIn Ads lida com todo o ciclo de vida da campanha: estratégia, segmentação, criativo, análise, lances, dados demográficos, uploads de público, formulários de lead. Carrega 15 arquivos de estratégia e 14 scripts, incluindo um framework de funil completo com divisões de orçamento, regras de dimensionamento de público, seis modelos de estrutura de campanha e uma lista de verificação de auditoria de 35 itens.
Meta Ads executa o Meta especificamente para B2B, que é uma disciplina própria: criativo como segmentação, estratégia de público, estrutura de campanha, otimização e detecção de fadiga. Tem 16 arquivos de estratégia e 12 scripts, construídos em torno de um sistema operacional do Meta Ads, um pipeline de produção criativa e o argumento de por que o Meta pode atingir um custo por lead menor que o LinkedIn quando executado corretamente.
Google Ads executa pesquisa baseada em intenção: gerenciamento de palavras-chave, estratégia de lance, auditoria de termos de pesquisa, análise de desempenho. Nove arquivos de estratégia e 13 scripts, construídos na ideia de capturar a demanda antes de tentar criá-la.
A quarta habilidade é Onboarding, o passo a passo de configuração. E por baixo de todas as três plataformas, há uma camada de fundamentos: dez frameworks entre plataformas cobrindo o mecanismo de demanda, alocação de orçamento, redação, seleção de canal e um quadrante de escalabilidade que se aplica independentemente de onde você está gastando. Leia esses arquivos de fundamentos antes de tocar em qualquer coisa. Eles são a parte que faz o resto fazer sentido.
Os 12 trabalhos que você executa no dia a dia
Os doze trabalhos divididos em quatro que constroem a campanha e oito que defendem o gasto
Dentro dessas habilidades estão os 12 trabalhos de operações de anúncios que o Ivan construiu. Quatro deles tiram uma campanha do papel (o construtor de público conta duas vezes, já que é enviado tanto no Meta quanto no LinkedIn).
- construtor-de-público transforma suas listas de CRM em públicos personalizados segmentáveis, no Meta e no LinkedIn.
- construtor-de-criativo gera criativos de anúncio a partir das especificações da sua marca.
- editor-em-massa edita campanhas, anúncios e nomes em massa em segundos.
Os outros oito defendem o dinheiro assim que a campanha está no ar, que é a maior parte do trabalho real.
- termos-de-pesquisa encontra as consultas que estão gastando dinheiro com zero conversões.
- palavras-chave-negativas transforma essas consultas em exclusões para você parar de pagar por elas.
- analisador-de-palavras-chave audita os índices de qualidade e revela as lacunas onde você está pagando a mais ou perdendo demanda.
- auditor-de-desempenho compara dois períodos e diz o que realmente mudou.
- analisador-de-fadiga-de-criativo monitora sua taxa de cliques e sinaliza quando ela está caindo antes que você perceba.
- monitor-de-fadiga sinaliza quando um público está ficando supersaturado para que você rotacione a tempo.
- rastreador-de-gastos monitora o ritmo do orçamento em todas as campanhas para que nada gaste demais sem ser notado.
- otimizador-de-lances ajusta lances entre campanhas em massa, em vez de uma edição lenta de cada vez.
Você não precisa memorizar esses nomes. Você descreve o que quer e o agente busca o certo. "Encontre o gasto desperdiçado nas minhas campanhas de pesquisa" executa os trabalhos de termos de pesquisa e palavras-chave negativas. "Algo está fatigando no Meta?" executa as verificações de fadiga.
Os nomes são apenas como o trabalho é organizado internamente.
Fase quatro: entregue as chaves, um trabalho de cada vez
Assim que as auditorias estiverem correspondendo à sua própria leitura, deixe o agente começar a fazer edições. Faça na mesma ordem cuidadosa, menor raio de explosão primeiro.
Comece com palavras-chave negativas, porque o pior caso é você parar de pagar por uma consulta inútil. Peça para ele extrair os termos de pesquisa com zero conversão, mostre a lista e adicione-os como exclusões após sua aprovação. Em seguida, deixe-o lidar com sinalizações de fadiga de criativo e ajustes de lance da mesma forma: ele propõe, você aprova, ele executa. Mantenha-se no ciclo de aprovação até que as edições sejam entediantes e previsíveis. Só então deixe-o executar os trabalhos de rotina sozinho e relatar o que editou.
A regra que mantém isso seguro é simples.
O agente propõe e executa. Você decide como é o "bom". Ele nunca pode inventar o alvo, apenas acertar aquele que você definiu.
O ritual operacional semanal
O ciclo semanal: termos de pesquisa, fadiga de criativo, ritmo do orçamento, comparar semana a semana
Aqui é onde tudo compensa.
O agente é mais valioso quando executado como um ritmo constante, não aberto em pânico quando um número parece estranho. Uma vez por semana, em uma única sessão, execute este ciclo em todas as contas:
"Extraia os termos de pesquisa do Google desta semana e me dê as consultas com zero conversão para excluir."
"Verifique cada campanha do Meta quanto à fadiga de criativo e sinalize qualquer coisa com uma CTR em queda."
"Revise o ritmo do orçamento em todas as três plataformas e sinalize qualquer coisa que esteja acima ou abaixo."
"Compare esta semana com a anterior e me diga o que mudou e o que você faria a respeito."
Esse ciclo é exatamente a manutenção que um operador ocupado ignora quando uma ligação de cliente se prolonga, e é onde os orçamentos de anúncios vazam silenciosamente. Um agente executa da mesma forma toda semana sem ficar entediado, que é o objetivo principal. Não é mais inteligente que um bom comprador de mídia. Ele apenas nunca se esquece de fazer a parte chata.
A parte que continua humana
Nada disso demite o operador. Isso o tira dos cliques e o coloca no julgamento.
Você ainda decide quais segmentos perseguir, se um ângulo criativo é bom, se um resultado é real ou um artefato de medição, o que escalar e o que matar. Escale o que está atingindo sua meta de custo com margem no orçamento. Mate o que já teve gasto suficiente para se provar e não conseguiu.
O agente apresenta os números e executa as edições, você toma essas decisões.
Tente executar anúncios totalmente sem supervisão e você aprenderá rapidamente por que isso falha.
O agente otimizará felizmente para um evento de conversão que está mal medido, ou podará uma palavra-chave que estava alimentando sua melhor conta. O julgamento continua sendo seu.
A execução repetitiva vai para a máquina.
Por onde começar
Não tente conectar todas as três plataformas e doze habilidades neste fim de semana. Construa na ordem.
Clone o repositório e leia os arquivos de fundamentos primeiro, antes de conectar qualquer coisa. Só isso já vale o download. Em seguida, conecte uma plataforma, aquela em que você mais gasta, e fique no modo somente leitura até que as auditorias ganhem seu lugar. Entregue um trabalho, palavras-chave negativas, e continue aprovando até ficar entediante. Adicione as verificações de fadiga, depois o gerenciamento de lances, depois a próxima plataforma.
Execute o ritual semanal o tempo todo. Você ganha cada camada.
O Ivan mostra uma construção ao vivo completa na câmera no Claude Code para Anúncios se você quiser ver funcionando primeiro. Quando estiver pronto para configurar o seu, comente "ads" e enviaremos o repositório, grátis, junto com o resto da nossa pilha de GTM. É o mesmo manual que usamos para gerenciar US$ 300 mil por mês.
A única coisa entre você e gerenciar seu tráfego pago a partir de um terminal é a paciência para configurá-lo um passo de cada vez.
