MÁQUINA DE TRÁFEGO COM CLAUDE CODE · ZX CONTROL 5
SETUP 15 · TURMA 5.0
ZX Control 5 · Setup 15

Máquina de Tráfego
com Claude Code

Criativo com IA, tráfego pago, tráfego orgânico e tracking, orquestrados dentro do seu Claude Code. Você entra com uma chave gratuita, sai com uma máquina que aprende sozinha o que escalar — custo de entrada R$ 0, pra qualquer nicho.

0 Base 1 Chaves 2 Imagem 3 Vídeo 4 Tráfego pago 5 Tracking 6 Blog SEO 7 A Máquina 8 Auditoria
Traffic ZX Control 5 · Setup 15 · Turma 5.0
O problema que trava todo mundo
Antes do Setup

Criativo, tráfego e tracking nunca conversam entre si.

Você gera uma arte num app, sobe a campanha noutro, e o pixel mede num terceiro — ninguém fecha o ciclo. O resultado: você não sabe se o criativo que "performou" gerou venda de verdade, escala campanha no número errado, e o tráfego orgânico (que não custa nada) fica esquecido porque ninguém tem tempo de escrever.

"Não sei se o criativo é bom"

Testar ângulo, arte estática, vídeo — cada ferramenta separada, sem comparar performance real entre elas.

"Não sei se o número é real"

Pixel conta clique gerado, não venda paga. Sem tracking correto, você otimiza pro número errado.

"O orgânico fica pra depois"

Tráfego pago come o orçamento; blog e SEO, que custam só tempo, nunca saem do papel.

A questão nunca foi ferramenta. É que não existe um ciclo fechado entre criar, publicar, medir e decidir — cada etapa mora numa aba diferente.

A virada

A Máquina de Tráfego com Claude Code é esse ciclo fechado.

Um orquestrador dentro do seu Claude Code. Você digita INICIAR SETUP 15 e ele conduz as 9 etapas em ordem — criativo, tráfego pago, tracking e tráfego orgânico terminam falando a mesma língua, e a Máquina final lê a conta ao vivo pra recomendar o próximo passo.

A ordem te protege: cada etapa só libera depois da anterior. O progresso fica salvo — pare quando quiser, volte com C.

ETAPA 0

Base e diagnóstico

› 0 // python3 setup/setup_base_s15.py
✓ serve pra qualquer máquina — degrada com aviso, nunca trava no opcional

Como funciona

  • Verifica Python 3.9+ — único requisito bloqueante.
  • Detecta Node, Chrome, ffmpeg e gh CLI — todos opcionais: sem eles, só a parte de vídeo local fica pendente.
  • Cria a estrutura base em ~/.operacao-ia/.
  • Se você já tem um Setup anterior instalado, reaproveita o que for válido em vez de reinstalar do zero.
ETAPA 1

Chaves e contas

› 1 // python3 setup/setup_chaves.py
✓ só a GEMINI_API_KEY é obrigatória, e é gratuita

Como funciona

  • A skill pede a GEMINI_API_KEY na hora se ela não estiver no ambiente — não promete "plugue depois".
  • Meta Ads, Google Ads, Cloudflare e HiggsField são opcionais, com degradação graciosa.
  • Toda chave é validada com uma chamada real antes de ser aceita, e gravada com permissão restrita.
  • Ausência de qualquer conta paga nunca bloqueia o resto do Setup.
ETAPA 2

Criativos com IA: imagem

› 2 // python3 setup/setup_criativos_imagem.py
✓ exemplo real gerado com a Gemini — serve pra qualquer nicho

Como funciona

  • Instala gerar-imagem (Gemini como provider gratuito padrão), zx-safezone, criar-thumbnail, meta-creative-brief e uma versão genérica de criar-arte-oferta.
  • Gera uma arte da sua própria oferta em 1:1 e 9:16.
  • Só aprova depois de passar pelo safe-zone — corte antecipado, texto ilegível e zona morta de UI reprovam antes de você ver.
  • A imagem ao lado é a saída real desse comando — nicho de exemplo, mesmo padrão pro seu.

🛠 Skills instaladas nesta etapa

🖼
/gerar-imagem — motor por trás de toda geração de imagem do Setup — Gemini Nano Banana / Imagen 4
🎯
/criar-arte-oferta — arte de oferta com ancoragem de valor, parcelamento, garantia e escassez, em quadrado e story
🎬
/criar-thumbnail — 3 variantes de thumbnail YouTube (rosto+texto, conceitual, comparação)
📝
/meta-creative-brief — briefing criativo pro anúncio Meta — hooks de copy, hooks visuais, CTA e specs por placement
🛡
/zx-safezone — QA de safe-zone — garante que headline/preço/CTA sobrevivem ao corte e ao overlay do Meta
demo-kit/etapa2/exemplo.png — arte gerada pela Etapa 2
exemplo da demo · gerado ao vivo Exemplo de criativo gerado
gerado com gemini-3.1-flash-image-preview · serve pra qualquer nicho
ETAPA 3

Criativos com IA: vídeo

› 3 // python3 setup/setup_criativos_video.py
✓ MP4 9:16, custo zero no caminho padrão

Como funciona

  • Instala criar-anuncio-video-html (caminho padrão, custo zero), criar-anuncio-video-momentum e gerar-video-mp4.
  • O caminho opcional criar-anuncio-video-gemini-omni cria cenas reais via API, com a sua própria chave.
  • Renderiza um MP4 9:16 local e valida no safe-zone especificamente pra Stories.
  • Demonstração ao vivo na aula — a renderização leva minutos e depende de ffmpeg local.

🛠 Skills instaladas nesta etapa

🎞
/criar-anuncio-video-html — vídeo em HTML/CSS → MP4 9:16, telas roteirizadas + música/sonoplastia (caminho padrão, custo zero)
📈
/criar-anuncio-video-momentum — vídeo "Momentum" em Remotion — tipografia cinética, contador animado, gráfico crescendo
🎥
/gerar-video-mp4 — MP4 a partir de animação HTML via puppeteer + Chrome headless + ffmpeg
🤖
/criar-anuncio-video-gemini-omni — opcional — vídeo com Gemini Omni Flash / Veo 3.1, áudio nativo, via API paga
ETAPA 4

Tráfego pago: Meta + Google

› 4 // python3 setup/setup_pago_meta_google.py
✓ só LEITURA nesta etapa — nenhuma campanha publica ou ativa sozinha

Como funciona

  • Instala o núcleo de leitura de tráfego pago. Pra Meta, conduz o MCP oficial com fallback de System User Token.
  • Google Ads conecta só se você escolher — nunca obrigatório.
  • Instala meta-metrics-fetcher e meta-performance-analyzer independente da conexão ter sido feita.
  • cpa/roas vêm do PIXEL, que pode contar PIX gerado e ainda não pago — a skill sempre cruza com venda paga real antes de sugerir cortar budget.

🛠 Skills instaladas nesta etapa

📡
/meta-metrics-fetcher — coleta métricas via MCP oficial, conforme os KPIs do seu perfil — nada hardcoded
📊
/meta-performance-analyzer — decide() personalizado do seu perfil — ranking top SCALE, top KILL, top KEEP
ETAPA 5

Tracking e mensuração

› 5 // python3 setup/setup_tracking.py
✓ o script real que vai pra sua LP — sem invenção

Como funciona

  • Instala o zx-tracking.js generalizado e o preflight_guardian.py — o gate que bloqueia subida de campanha sem rastreamento verificável.
  • Classificação de canal em cascata: sck > gclid > utm > referrer.
  • CAPI de refund parametrizado pelo seu próprio pixel — nunca hardcoded.
  • O código ao lado é o arquivo real que será colado na sua LP, gerado nesta etapa.

📦 O que é instalado nesta etapa (não é skill de chat)

🔗
zx-tracking.js — script real colado no <head> da sua LP — captura utm/gclid/referrer e classifica o canal
🚧
preflight_guardian.py — gate usado pelo /meta-campaign (Etapa 7) — bloqueia subida de campanha sem tracking configurado
demo-kit/etapa5/preview.html — zx-tracking.js
código real · Etapa 5
ETAPA 6

Tráfego orgânico e Blog SEO

› 6 // python3 setup/setup_blog.py
✓ artigo real, gerado com Gemini durante o teste deste Setup

Como funciona

  • Você escolhe nicho, público, tom e produto; o agente gera uma fila hub-and-spoke de keywords sozinho.
  • O primeiro artigo é escrito com Gemini, direto no seu terminal.
  • Só publica depois de passar nos 24 checks técnicos e no safety-check — reprovado vai pra drafts/, nunca publica em silêncio.
  • O artigo ao lado é o artefato real gerado no teste ponta-a-ponta deste Setup — não é mock.

📦 O que é instalado nesta etapa (motor do repo, não skill portável)

🤖
Agente de conteúdo — blog/agente/ — gera a fila hub-and-spoke de keywords e escreve o artigo com Gemini
⚙️
Gerador do blog — blog/generator/ — monta o HTML final e roda os 24 checks técnicos + safety-check antes de publicar
demo-kit/etapa6/artigo-principal/ — artigo gerado com Gemini
artigo real · gerado no teste
ETAPA 7

A Máquina no automático

› 7 // python3 setup/setup_maquina.py
✓ decide e recomenda — nunca executa sozinha sem QA

Como funciona

  • Instala as duas camadas que fecham o ciclo criativo → tráfego → captura → venda.
  • Camada de decisão: lê a conta ao vivo e recomenda pausar, escalar ou testar — nunca executa sozinha.
  • Camada de execução: prepara criativos e campanha, com QA de safe-zone obrigatório.
  • Ledger que vincula cada arte ao ad_id — rastreabilidade completa do criativo até o resultado.

🛠 Skills instaladas nesta etapa

🧭
/meta-estrategista — camada de DECISÃO — lê CPM/frequência/saturação e recomenda pausar/escalar/testar; nunca executa sozinho
🚀
/meta-campaign — camada de EXECUÇÃO — monta campanha/conjunto/anúncio via Graph API; barra subida sem tracking configurado
ETAPA 8

Auditoria e fechamento

› 8 // python3 setup/setup_audit.py
✓ auto-fix + fecha o Setup — sem etapa escondida

Como funciona

  • Executa a auditoria completa com auto-fix: confere chaves, skills, criativos, tracking, integrações, blog e a política de aprovação da Máquina.
  • Corrige automaticamente o que for seguro corrigir.
  • Nunca esconde uma etapa pulada — reporta o que ainda falta.
  • Fecha o Setup marcando phase_completed = 15.
É só rodar

Criativo, tráfego e tracking,
no mesmo ciclo.

Não tem "próximos passos", não tem "próxima aula", não tem "plugue as credenciais depois". Tudo é feito DURANTE o uso — as skills pedem a chave, o nicho e a conta na hora. Você abre, digita o número, ajusta e aprova enquanto roda.

Uma etapa de cada vez

O menu 0-8 te conduz da base à auditoria. A ordem te protege de pular passo.

Custo de entrada R$ 0

Só a Gemini é obrigatória, e é gratuita. Meta, Google, Cloudflare e HiggsField são opcionais.

Ciclo fechado de verdade

Criativo → tráfego pago → tracking → orgânico → a Máquina decide o próximo passo.

Setup 15 · ZX Control 5 · Turma 5.0 — bora rodar. 🚀

01 / 13
← → navegar · Espaço próximo · F tela cheia