Nossa head de crescimento, Ivan Falco, gerencia US$ 300 mil mensais em gastos com anúncios no Google, Meta e LinkedIn sem abrir um único gerenciador de anúncios. Ele faz isso a partir de um terminal, em inglês simples, dentro do Claude Code.
Ele passou mais de 200 horas transformando isso em 12 habilidades e depois colocou tudo em um repositório público. Estamos detalhando exatamente como funciona abaixo, para que qualquer pessoa tentando fazer isso possa colocar em funcionamento sem precisar adivinhar. Se você preferir receber os arquivos diretamente, comente "ads" e enviaremos o repositório.
Algumas partes exigem paciência, e vamos sinalizá-las ao longo do caminho. Ao final, você saberá o que é isso, o que não pode fazer, os prompts exatos para executar e a ordem para ativar tudo sem detonar uma conta ativa no primeiro dia. Este é o manual completo, então siga na 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 pega a maioria das pessoas.
Isso é executado 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 é executado no aplicativo de chat em claude.ai. O aplicativo de chat fica na nuvem e não pode executar scripts na sua máquina, ler suas chaves de API ou conversar com suas contas de anúncios. Se você executar no aplicativo de chat por engano, nada funciona, e você vai pensar 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 contém arquivos de estratégia com frameworks e benchmarks, scripts Python que chamam as APIs das plataformas de anúncios diretamente e lógica de roteamento que diz ao Claude qual conhecimento carregar para a tarefa à sua frente.
Os scripts são a camada de automação, a parte que coleta um relatório ou realiza uma edição em massa.
A base de conhecimento é a camada de estratégia, a parte que sabe como executar anúncios B2B. 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 isso é construído sobre o Mecanismo de Demanda de 5 Estágios que executamos em todas as nossas contas, que substitui o antigo funil TOFU, MOFU, BOFU e aloca 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ê deseja gerenciar.
Essa última é a parte que exige paciência.
Ler a estratégia e pedir auditorias não precisa de nenhuma configuração, você pode fazer isso assim que clonar o repositório. Para permitir que o agente colete 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 Advertising API do LinkedIn pode levar um ou dois dias para ser aprovada, então se o LinkedIn é seu canal principal, solicite esse acesso primeiro e vá fazer outra coisa enquanto ele é liberado.
Fase um: clone e conheça o agente
Os movimentos iniciais são três comandos.
- git clone do repositório, depois cd para dentro da pasta.
- Execute claude para 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ê opera e orienta você pelas credenciais uma plataforma de cada vez, em vez de jogar uma parede de instruções em você. Você também pode pular e 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 depois solicita a Advertising API na aba Products. Essa solicitação é a demorada.
Enquanto espera, você pega seu Client ID e Client Secret na aba Auth, executa o script OAuth incluído, e ele captura o token automaticamente. Sua última peça é o Ad Account ID, que é o número que está na URL do seu Campaign Manager.
Para o Meta, você cria um aplicativo, adiciona o produto Marketing API e gera um token com permissões de gerenciamento de anúncios e leitura.
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. Depois você pega seu Ad Account ID, aquele que começa com act_.
Para o Google, você precisa de um developer token do API Center, o que geralmente significa ter uma conta de gerente configurada primeiro. Esse token mais seu account ID é 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 você preferir não se envolver, Ivan oferece uma análise gratuita e pode ajudar, mas a maioria das pessoas consegue passar por isso sozinhas.
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 em modo somente leitura, onde cada prompt lê sua conta e devolve uma descoberta 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 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 está à vista de todos:
"Extraia meus termos de pesquisa dos últimos 30 dias e sinalize cada consulta que gastou dinheiro com zero conversões."
"Audite meus índices de qualidade e mostre onde estou pagando demais 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 esteja caindo."
"Verifique cada campanha quanto à supersaturação de audiência e me diga o que rotacionar."
"Revise meus textos de anúncio com base no framework voice-of-customer 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 mostre quais cargos e portes de empresa realmente convertem."
"Mostre minha estratégia de lances em todas as campanhas e onde estou deixando eficiência de lado."
Cada um desses é seguro para executar no primeiro dia.
Nenhum deles toca em nada. Eles apenas mostram a conta através dos olhos de alguém que já executou este manual com muitos gastos.
As habilidades e o que cada uma faz
O repositório é organizado como 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álises, lances, dados demográficos, uploads de audiência, formulários de lead. Ele contém 15 arquivos de estratégia e 14 scripts, incluindo um framework de funil completo com divisões de orçamento, regras de dimensionamento de audiência, seis modelos de estrutura de campanha e uma lista de verificação de auditoria de 35 itens.
Meta Ads executa Meta especificamente para B2B, que é uma disciplina própria: criativo como segmentação, estratégia de audiência, 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 de Meta Ads, um pipeline de produção criativa e a argumentação de por que o Meta pode atingir um custo por lead mais baixo que o LinkedIn quando executado corretamente.
Google Ads executa busca baseada em intenção: gerenciamento de palavras-chave, estratégia de lances, auditoria de termos de pesquisa, análise de desempenho. Nove arquivos de estratégia e 13 scripts, construídos sobre a ideia de capturar 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 está uma camada de fundamentos: dez frameworks multiplataforma cobrindo o mecanismo de demanda, alocação de orçamento, redação de anúncios, seleção de canais 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.
As 12 tarefas que você executa no dia a dia
As doze tarefas se dividem em quatro que constroem a campanha e oito que defendem o gasto
Dentro dessas habilidades estão as 12 tarefas de operações de anúncios que Ivan construiu. Quatro delas tiram uma campanha do chão (audience-builder conta duas vezes, já que está disponível tanto no Meta quanto no LinkedIn).
- audience-builder transforma suas listas de CRM em audiências personalizadas segmentáveis, no Meta e no LinkedIn.
- creative-builder gera criativos de anúncios a partir das especificações da sua marca.
- bulk-editor edita em massa campanhas, anúncios e nomenclaturas em segundos.
As outras oito defendem o dinheiro assim que a campanha está no ar, que é a maior parte do trabalho real.
- search-terms encontra as consultas que estão gastando dinheiro com zero conversões.
- negative-keywords transforma essas em exclusões para que você pare de pagar por elas.
- keyword-analyzer audita os índices de qualidade e revela as lacunas onde você está pagando demais ou perdendo demanda.
- performance-auditor compara dois períodos e informa o que realmente mudou.
- creative-fatigue-analyzer monitora sua taxa de cliques e a sinaliza caindo antes que você perceba.
- fatigue-monitor sinaliza quando uma audiência está ficando supersaturada para que você rotacione a tempo.
- spend-tracker monitora o ritmo do orçamento em todas as campanhas para que nada gaste demais despercebido.
- bid-optimizer ajusta lances em várias campanhas de uma vez, 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 alcança o certo. "Encontre o gasto desperdiçado nas minhas campanhas de pesquisa" executa as tarefas search-terms e negative-keywords. "Tem algo fatigando no Meta" executa as verificações de fadiga.
Os nomes são apenas como o trabalho é organizado por baixo.
Fase quatro: entregue as chaves, uma tarefa de cada vez
Assim que as auditorias estiverem correspondendo à sua própria leitura, você deixa o agente começar a fazer edições. Faça isso na mesma ordem cuidadosa, menor raio de explosão primeiro.
Comece com negative keywords, 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, mostrar a lista e adicioná-los como exclusões assim que você aprovar. Depois deixe ele lidar com sinalizações de fadiga criativa 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 você deixa ele executar as tarefas rotineiras por conta própria e relatar o que editou.
A regra que mantém isso seguro é simples.
O agente propõe e executa. Você decide como é "bom". Ele nunca pode inventar o alvo, apenas acertar aquele que você definiu.
O ritual operacional semanal
O ciclo semanal: termos de pesquisa, fadiga criativa, ritmo de orçamento, comparar semana a semana
É aqui que tudo compensa.
O agente é mais valioso quando executado como um ritmo regular, 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 criativa e sinalize qualquer uma com 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 pula quando uma ligação de cliente se estende, e é onde os orçamentos de anúncios vazam silenciosamente. Um agente executa isso da mesma forma toda semana sem ficar entediado, que é exatamente o objetivo. Não é mais inteligente que um bom comprador de mídia. Só nunca se esquece de fazer a parte chata.
A parte que permanece humana
Nada disso demite o operador. Ele os tira dos cliques e 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 espaço restante no orçamento. Mate o que já gastou o suficiente para se provar e não se provou.
O agente apresenta os números e executa as edições, você faz essas escolhas.
Tente executar anúncios totalmente sem supervisão e você aprenderá rapidamente por que isso falha.
O agente vai otimizar alegremente em direção a um evento de conversão mal medido, ou podar uma palavra-chave que estava alimentando sua melhor conta. O julgamento permanece 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. Depois conecte uma plataforma, aquela em que você mais gasta, e fique em modo somente leitura até que as auditorias ganhem seu lugar. Entregue uma tarefa, negative keywords, 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.
Ivan mostra uma construção completa ao vivo na câmera no Claude Code for Ads se você quiser ver funcionando primeiro. Quando estiver pronto para configurar por conta própria, comente "ads" e enviaremos o repositório, gratuito, junto com o resto do nosso stack de GTM. É o mesmo manual que usamos para gerenciar US$ 300 mil por mês.
A única coisa entre você e executar sua estratégia paga a partir de um terminal é a paciência para configurar passo a passo.
