Ads Infinitos com Claude Code

Ads Infinitos com Claude Code

Se pagas freelancers para te fazerem cada variação de anúncio, estás a perder dinheiro e a perder velocidade. Este guia mostra como ligar Claude Code a um fornecedor de imagens para gerares cem variações de um anúncio num fim de semana, por um custo que cabe num café por dia.

Tempo de leitura: cerca de 15 minutos. Tempo para ter o sistema a andar: dois serões. Nível: não precisas de saber programar.

1. O Problema

Pensa no que acontece quando decides testar um anúncio novo no Instagram ou no Facebook.

• Mandas brief ao designer ou à agência.
• Esperas três a cinco dias.
• Recebes três variações. Pagas entre cem e trezentos euros por cada uma.
• Metes no Meta Ads. Duas não performam. Uma salva o dia.
• Para descobrires qual funciona, tinhas de testar trinta. Mas ias gastar nove mil euros.

Então só testas três. E os teus resultados ficam amarrados à sorte de um designer ter adivinhado o estímulo certo.

O problema fica pior quando começas a escalar. Se tens duas campanhas a correr em paralelo, o orçamento criativo duplica. Se tens dez clientes (caso das agências), o orçamento multiplica por dez. Não há forma de testar vinte ângulos por cliente sem gastar o mês inteiro só em produção.

E ainda há o lado invisível: o custo de oportunidade. Enquanto esperas cinco dias por três variações, o teu concorrente já lançou quarenta e já descobriu qual é o ângulo vencedor. Quando chegas ao mercado, ele já está a escalar.

A resposta tradicional era 'contrata mais um designer'. Só que cada designer novo é mais 2.000€ a 3.000€ por mês. E a velocidade de produção por pessoa não muda. Só multiplicaste o custo, não destravaste o problema.

2. A Solução

Em vez de pedires variações a um humano, pedes a um agente. O agente usa um serviço de imagens (kie.ai) que agrega vários modelos visuais num único sítio. Tu descreves o que queres em linguagem normal. Ele faz as variações em paralelo.

Antes

• Três variações por 600€.
• Cinco dias de espera.
• Dependência do estilo de quem desenha.

Depois

• Cem variações por 5€ em custos de serviço.
• Cinco horas a correr em background.
• Estilo da tua marca definido uma vez, aplicado sempre.

É importante perceber que isto não substitui totalmente designers. Continuas a precisar de alguém que pensa a estratégia criativa, que define ângulos, que decide o que ir testar. Mas libertas essa pessoa da parte braçal da produção de variantes. Passa de executora a estratega.

E o estilo da marca continua a ser trabalho humano. É o que fica guardado no brand.md. Depois de bem escrito, o agente aplica em mil peças sem desvio. Investes 2 horas uma vez, colhes durante 2 anos.

3. Pré-requisitos

Vais precisar destas três ferramentas. Todas têm plano gratuito ou barato para começar.

Links úteis: Claude Code | kie.ai | Cursor | Documentação Claude Code

4. Implementação Passo a Passo

4.1 Criar conta na kie.ai e gerar a chave

Abre kie.ai e regista conta. Recebes um dashboard com várias opções de modelos: Nano Banana, Gemini Image 3, Seedance, ChatGPT Image. Carregas 10 ou 20 dólares iniciais, dá para centenas de imagens.

4.2 Instalar e configurar Claude Code

No terminal, corres o comando de instalação oficial (ver docs). Abres o Claude Code dentro da pasta onde queres guardar os criativos. Crias um ficheiro .env com a tua chave kie.ai.

1. Abre o terminal na pasta do projecto.
2. Corre claude para iniciar o agente.
3. Cria um ficheiro .env na raiz com KIE_API_KEY=... (sem aspas).
4. Adiciona .env ao .gitignore para nunca enviares a chave para a internet.

4.3 Definir o estilo da marca

Este é o passo mais importante e o que a maioria das pessoas salta. Vais escrever um documento chamado brand.md que descreve visualmente a tua marca em linguagem normal.

O que incluir no brand.md:

• Paleta de cores (com códigos hex se souberes, ou descritivos tipo 'verde musgo, creme quente, preto carvão').
• Tipo de luz preferida (natural, estúdio clean, contraste cinematográfico).
• Tipos de ambiente (escritório moderno, cozinha caseira, rua europeia, estúdio minimalista).
• Referências visuais (três a cinco marcas de quem gostas: Apple, Patagonia, Studio Ghibli).
• O que evitar (stock photos genéricas, demasiado colorido, pessoas de grandes sorrisos falsos).

Dica prática para não perderes duas horas a tentar afinar o brand.md: escolhe dez imagens que representam exactamente a tua marca, descreve cada uma em três a cinco frases, agrega num único ficheiro. O agente absorve o padrão muito mais depressa quando tem exemplos ancorados do que quando tem regras abstractas.

Se já tens identidade visual definida num PDF de brand guidelines, extrai as páginas relevantes e cola directamente dentro do brand.md (convertendo em texto). O Claude Code lê markdown e blocos de texto sem problema. Não precisas de reformatar nada.

4.4 Criar o skill (agente) dedicado

No Claude Code, cria uma skill chamada ads-factory. A skill tem três coisas: um SKILL.md que explica o que faz, uma função Python para chamar a kie.ai, e uma pasta output onde são guardadas as imagens.

Estrutura da pasta:

ads-factory/SKILL.md → instruções para o agente

ads-factory/scripts/generate.py → chamada à kie.ai

ads-factory/output/ → imagens geradas

4.5 Escrever o SKILL.md

O SKILL.md é o 'contracto' entre ti e o agente. Descreve em passos o que o agente tem de fazer quando lhe pedires 'faz ads'.

Quando o utilizador pedir variações de anúncio: 1) Lê o brief e o brand.md. 2) Gera dez prompts diferentes com base no brief, todos respeitando o estilo da marca. 3) Para cada prompt chama generate.py. 4) Nomeia cada imagem com o prompt usado. 5) Ao fim entrega resumo com link para a pasta output.

4.6 Criar o primeiro brief

Um brief é um ficheiro curto que descreve a campanha: o produto, o ângulo, o público, o formato (story, feed, reel thumbnail).

Exemplo de brief:

Produto: curso online de edição de vídeo. Ângulo: resultado em 30 dias mesmo sem experiência. Público: criadores de conteúdo iniciantes. Formato: feed quadrado 1080x1080. Tom: confiança sem hype.

4.7 Correr a primeira geração

No Claude Code pedes: 'corre ads-factory com o brief ecourse-edit.md'. O agente lê tudo, gera os prompts, chama a kie.ai, guarda as imagens em output/ nomeadas pelo prompt.

4.8 Rever e seleccionar

De manhã abres a pasta output. Em dois minutos eliminas metade (estilo desviou, composição estranha, texto em cima do produto). Das que ficaram, escolhes as três a cinco mais fortes.

Para o Meta Ads Manager, redimensionas para 1:1 (feed), 4:5 (feed vertical), 9:16 (stories/reels). O Claude Code faz isso em batch via imagemagick com um comando.

4.9 Iterar com base em performance

Depois de lançares os criativos, ao fim de 48h sabes quais performam. Voltas ao Claude Code e dizes: 'das dez que lancei, a variação com o ângulo X foi a que deu mais cliques. Gera outras 20 com esse ângulo, variando a composição.' O agente ajusta automaticamente.

Com o tempo, podes pedir ao agente para ler os relatórios do Meta Ads directamente (via API ou export CSV) e sugerir novas variações com base em padrões de performance. O sistema deixa de precisar de ti para pensar 'o que testar a seguir' e começa a propor hipóteses por si.

A partir daqui o ciclo é: lanças 10, aprendes em 48h, ajustas, lanças mais 10. Semana a semana o custo por aquisição cai e a taxa de conversão sobe. Não por magia, mas por volume de testes que eras incapaz de fazer antes.

5. Ferramentas e Recursos

Stack completo, com alternativas para se alguma não der para o teu caso.

6. Caso Prático

Para veres o ganho em números, imagina uma agência de marketing pequena, cinco pessoas, que gere tráfego pago para uma dezena de clientes e-commerce portugueses.

Implementação do sistema:

1. Semana 1: duas pessoas montam o ads-factory, definem brand.md por cada cliente.
2. Semana 2: testam com dois clientes. Entregam 40 variações em vez de 6, por cliente.
3. Semana 3: rollout para os outros oito clientes.

Resultado em números hipotéticos:

• Custo de criativos por cliente: 1.200€ antes → 60€ agora.
• Tempo de entrega: cinco dias antes → meio dia agora.
• Variações por campanha: 6 antes → 40 agora.
• Dois funcionários que faziam produção passam a fazer criação estratégica e testes, porque a máquina dá mãos vagas.

A conta que qualquer um faz: se cada hora de produção custa 30€ em Portugal e cortas 80h por mês, são 2.400€ que recuperas. Sem despedir ninguém. A agência deixa de vender horas de produção e passa a vender resultado.

O ganho composto é o que importa: depois dos três primeiros meses, a agência pode aceitar mais clientes sem aumentar equipa. Cada cliente novo é margem quase pura. O mesmo sistema que corria para dez clientes corre para quinze com ajustes mínimos nos brand.md de cada um.

E quando algum cliente sair, não há 'despedimento' de freelancer. A capacidade fica intacta, pronta para quem chegar a seguir. O negócio fica mais elástico.

7. Erros Comuns e Como Evitar

Lista dos cinco erros que vão aparecer nas primeiras duas semanas, se fores como 9 em 10 pessoas que montam isto.

Erro 1: começar sem brand.md

Saltar o brand.md e gerar logo 50 variações. O agente não sabe o que é a tua marca, produz genérico. Pareces qualquer loja Shopify do mundo.

Erro 2: prompts demasiado longos

Escrever prompts de 500 palavras para cada variação. O modelo confunde-se, sai tudo parecido, perdes o efeito da variedade.

Erro 3: gerar sem brief da campanha

Pedir 'faz-me ads fixes' sem contexto do produto, ângulo ou público. O agente tenta adivinhar, falha, tu ficas a discutir com a máquina em vez de trabalhares.

Erro 4: não testar pequenas doses

Gerar 100 de uma vez sem ver intermediárias. Se o estilo partiu, gastas 3 euros em imagens inúteis.

Erro 5: confundir quantidade com qualidade

Publicar as 100 no Meta Ads. O algoritmo distribui atenção pelas 100, nenhuma chega a massa crítica. Gastas orçamento sem aprender.

Erro 6: não guardar os prompts usados

Gerar centenas de imagens sem guardar o prompt que produziu cada uma. Quando uma performa bem, não consegues replicar o ângulo porque não sabes como a pediste.

Erro 7: pular a revisão humana

Assumir que tudo o que o agente gera está pronto a publicar. Saem imagens com dedos deformados, tipografia estranha ou composição esquisita. Publicar sem olhar mancha a marca.

8. Checklist de Implementação

Fase 1: Setup (30 a 60 minutos)

• Criar conta na kie.ai
• Carregar 10 a 20 dólares iniciais
• Gerar API key kie.ai e guardá-la em .env
• Instalar Claude Code
• Criar pasta do projecto e abrir Claude Code dentro dela

Fase 2: Construção (1 a 2 horas)

• Escrever brand.md com paleta, luz, estilo, referências
• Criar skill ads-factory com SKILL.md e scripts/
• Testar generate.py com um prompt manual para validar conexão
• Criar primeiro brief.md para a campanha de teste

Fase 3: Teste (30 minutos)

• Correr a skill com 10 variações
• Rever a pasta output e identificar o que está bem e o que está desviado
• Ajustar brand.md com base no feedback
• Voltar a correr com 10 variações para confirmar correcção

Fase 4: Lançamento (45 minutos)

• Gerar 50 variações da campanha real
• Seleccionar as 10 melhores
• Redimensionar para formatos 1:1, 4:5 e 9:16
• Carregar no Meta Ads Manager e lançar
• Marcar revisão aos 48h para iterar com base em performance

Preferes que isto seja feito por nós? Conhece o nosso serviço de automação de processos.

Guias relacionados

• Como Publicar em 6 Plataformas Sem Tocar no Telemóvel
• Três Agentes Que Já Trabalham Para Outros
• Três Travões Invisíveis ao Crescimento