ESPIONAGEM
Todas as fases
FASE 0⏱ 15 min

Setup do Arsenal

Em 15 minutos tu sai do zero pra um Claude Code armado com Playwright, Apify, EXA, Firecrawl, defuddle e yt-dlp. É a base que sustenta tudo o resto.

Próxima: Mapeamento

1. Instalar o Claude Code

1

Abre o terminal (PowerShell, bash ou zsh)

No Windows: Win+R, digita powershell, Enter. No Mac/Linux: Cmd+Space, "Terminal".

2

Instala via npm (vem com Node 20+)

bash· Instalação global
npm install -g @anthropic-ai/claude-code

# Confere
claude --version

Se aparecer um número de versão, deu certo. Se der erro de permissão no Windows, roda PowerShell como Admin.

3

Faz login na sua conta Claude

bash· Login OAuth
claude /login

Ele abre o browser, você loga, fecha. Pronto.

Não tem conta Anthropic?

Cria em claude.ai. O plano Max é o mais usado pra esse tipo de trabalho (US$ 20/mês, dá folga de uso). Pro plano API direto, é via console.anthropic.com, vai por consumo. Faz a conta.

2. MCPs (os superpoderes)

MCP é tipo um "plugin" que dá ferramenta extra pro Claude. Pra esse playbook, tu precisa destes aqui:

1

Playwright MCP, controla browser real

Pra navegar em site, tirar screenshot, emular mobile, quebrar cloacker. Sem ele, tu não vê a landing real. Sem ele, o playbook não roda.

bash· Adicionar Playwright MCP
# Instala o servidor MCP oficial Microsoft
claude mcp add playwright -- npx -y @playwright/mcp@latest

# Confere
claude mcp list
2

Apify MCP, scraping pesado (Instagram, TikTok, Meta)

Apify tem 6.000+ "Actors" prontos. Você usa os de Instagram, TikTok, Google, YouTube. Free tier dá uns US$ 5/mês de crédito.

bash· Adicionar Apify MCP
# Crie conta grátis em apify.com → Settings → Integrations → API tokens
# Copia teu API token

claude mcp add apify -- npx -y @apify/actors-mcp-server --apify-token SEU_TOKEN_AQUI

# Confere
claude mcp list

Sobre o token

Nunca cola token em chat público, GitHub, print. Trata como senha, cara. Em projeto Vercel, usa vercel env add.

3

EXA MCP, busca semântica na web

Melhor que Google pra pesquisa profunda. Encontra concorrentes, reviews, posts de fórum.

bash· Adicionar EXA MCP
# Crie conta grátis em exa.ai → Dashboard → API Key
claude mcp add exa -- npx -y exa-mcp-server --api-key SUA_KEY_EXA
4

Firecrawl MCP, extração markdown limpa

Pega qualquer site e devolve markdown sem CSS/JS/banner. Perfeito pra alimentar o contexto do Claude.

bash· Adicionar Firecrawl MCP
# firecrawl.dev → API key (tem free tier)
claude mcp add firecrawl -- npx -y firecrawl-mcp --api-key SUA_KEY_FIRECRAWL
5

(Opcional) Defuddle CLI, para extração local sem MCP

bash· Defuddle
npm install -g defuddle-cli

# Uso direto
defuddle https://exemplo.com.br/pagina-do-concorrente

3. Ferramentas auxiliares

1

yt-dlp (baixa qualquer vídeo)

bash· yt-dlp
# Windows (via winget)
winget install yt-dlp

# Mac (via brew)
brew install yt-dlp

# Confere
yt-dlp --version

Vai usar pra baixar VSLs do YouTube, Vimeo, etc. Pra VTurb/Panda, também funciona se passar a URL .m3u8.

2

ffmpeg (converte vídeo, extrai áudio)

bash· ffmpeg
# Windows
winget install Gyan.FFmpeg

# Mac
brew install ffmpeg

# Confere
ffmpeg -version
3

(Opcional) Whisper local (transcrição offline)

bash· Whisper
# Python 3.10+
pip install openai-whisper

# Ou versão rápida (faster-whisper)
pip install faster-whisper

# Uso
whisper audio.mp3 --language Portuguese --output_format txt

Alternativa: usa a API da OpenAI direto (US$ 0,006/min), fica mais rápido sem GPU.

4. Estrutura de pastas

Cria uma pasta de trabalho com essa estrutura. Cada nicho/projeto vira uma sub-pasta.

bash· Estrutura recomendada
espionagem/
├── _swipes/                     # screenshots e materiais coletados
├── _docs/                       # documentação geral
└── nichos/
    └── nicho-x/
        ├── 01-mapeamento.md     # Lista de 20 players
        ├── 02-meta-ads/         # Ads coletados
        ├── 03-funis/            # Funis capturados
        ├── 04-vsls/             # VSLs e transcrições
        ├── 05-trafego.csv       # Dados de tráfego
        ├── 06-instagram/        # Intel IG
        ├── 07-sintese.md        # Padrões e modelagem
        └── claude.md            # Contexto pro Claude
1

Cria com 1 comando

bash· Bootstrap da pasta
mkdir -p espionagem/nichos/nicho-x/{02-meta-ads,03-funis,04-vsls,06-instagram} && \
cd espionagem/nichos/nicho-x && \
touch 01-mapeamento.md 05-trafego.csv 07-sintese.md claude.md && \
echo "# Nicho X, Espionagem" > claude.md

5. Validação final

bash· Tudo OK?
claude mcp list
# Deve listar: playwright, apify, exa, firecrawl

yt-dlp --version
ffmpeg -version

claude --version
# Tudo respondendo? Setup pronto.

Setup completo. Próximo passo: Mapeamento.

Tu agora tem um Claude com olho de águia. Bora pra Fase 1 mapear os 20 players principais do nicho. Te espero do outro lado.