🗺️ O sistema em quatro passos
A grande lição deste módulo não é "como conseguir leads". É como compor várias skills num sistema. Em vez de uma skill gigante que faz tudo (e quebra inteira), o sistema é um pipeline: cada estágio é uma skill autônoma, a saída de uma vira a entrada da próxima, e cada peça pode ser testada e corrigida sozinha.
🎯 A premissa
Você é uma agência de IA e quer clientes. A resposta: negócios locais que têm dinheiro. O sistema os encontra para você — começando por fontes onde os negócios já se pré-qualificaram como estabelecidos e com orçamento.
Uma skill por estágio.
Saída de uma = entrada da próxima.
Conserta um estágio sem mexer no resto.
Do diretório ao formulário enviado.
🕸️ Scraping de diretórios com Playwright
O primeiro estágio define a qualidade de tudo o que vem depois. A escolha estratégica aqui é a fonte: diretórios de associações comerciais e redes de networking listam negócios que já se pré-qualificaram — estabelecidos há anos, com orçamento, e frequentemente com sites datados (justamente a dor que a agência resolve).
📚 Três fontes de leads pré-qualificados
- • Diretórios de câmaras de comércio: negócios membros, geralmente longevos e estabelecidos na região.
- • Diretórios de redes de networking (estilo BNI): donos de negócio ativos em grupos de indicação.
- • Revistas de estilo de vida locais: cada anunciante paga caro pelo espaço — sinal forte de orçamento.
Como o scraping funciona
A skill usa automação de navegador (Playwright) para percorrer o diretório: abre cada cartão de membro, lê as informações do perfil e estrutura tudo numa planilha. Esse é o padrão de "scraping com browser real" da Trilha 3 aplicado a um objetivo de negócio.
para cada cartão no diretório:
abrir o cartão / "learn more"
ler nome, negócio, telefone, endereço
anexar linha à planilha de leads
💡 Dica: pré-qualificação vem da fonte
Você não "pré-qualifica" os leads depois — você escolhe uma fonte onde eles já chegam pré-qualificados. Um negócio que paga anuidade numa câmara de comércio há anos já provou longevidade e capacidade de pagar. A qualidade da lista nasce na escolha do diretório.
Abre cada cartão como um humano.
Diretório já filtra por estabilidade.
Perfil vira linha de planilha.
O alvo certo tem o problema certo.
💧 Enriquecimento em cascata
Um nome e um negócio não bastam. O estágio de enriquecimento descobre o site e o perfil de LinkedIn de cada contato. A técnica é a cascata (waterfall): tenta um provedor; se ele não encontrou, cai para o próximo, na ordem do mais barato/rápido para o mais caro/completo.
A lógica da cascata
resultado = vazio
para provedor em [barato, médio, caro]:
resultado = provedor.buscar(nome, negócio)
se resultado tem site E linkedin:
parar # achou, não gasta com os próximos
se resultado vazio E quer e-mail:
usar API de e-mail dedicada (a mais cara)
Encadeando provedores de busca, o sistema localiza o site e o LinkedIn associados a um nome com alta precisão — sem disparar a chamada cara em todo lead.
✓ Cascata bem feita
- ✓Ordena do mais barato para o mais caro.
- ✓Para assim que tem dado suficiente.
- ✓Reserva a API cara só para quem precisa do e-mail.
- ✓Registra qual provedor achou (auditoria).
✗ Cascata mal feita
- ✗Chama todos os provedores em todo lead — custo explode.
- ✗Começa pelo provedor mais caro "porque é melhor".
- ✗Não para quando já achou — desperdício puro.
- ✗Não sabe dizer de onde veio cada dado.
Provedores em sequência ordenada.
Falhou? Tenta o próximo.
Barato → caro, para no acerto.
Site + LinkedIn pelo nome.
🎁 O site como lead magnet
Aqui está o golpe de mestre do sistema. Em vez de mandar uma mensagem pedindo atenção, o pipeline entrega valor antes de pedir qualquer coisa: para cada lead, gera uma versão melhorada do site dele — um clone com o cabeçalho atualizado, um redesign no estilo moderno, ou um widget de chat adicionado — e envia isso como presente para abrir a conversa.
🎯 Por que isso muda o jogo
"Olha, peguei seu site e fiz uma versão melhor" é uma abordagem completamente diferente de "oi, posso te ajudar?". Você já demonstrou a competência, já mostrou o resultado, e fez isso sob medida para aquele negócio específico. O presente é o gancho.
Variações do presente (recriação ilustrativa)
só o cabeçalho refeito; "este é o seu site, modernizado"
layout moderno com boas práticas de design
"veja como ficaria com um chat no seu site atual"
Mocks ilustrativos do conceito de variação do presente — não são telas reais.
💡 Dica: storytelling no funil
O presente não termina em si. Ele leva a um pequeno storytelling: "este é o seu site → veja o que ele poderia ser → vamos conversar". O site-presente é o topo de funil; a meta é puxar para uma reunião, não fechar na primeira mensagem.
Um presente que abre porta.
Entrega antes de pedir.
Sob medida pra cada negócio.
Geração automática por lead.
✉️ Contato via formulário
O passo final fecha o ciclo: a automação de navegador preenche e envia o formulário de contato do próprio site do negócio (ou do diretório), com a mensagem e o link do site-presente. Sair do canal saturado do cold e-mail é uma decisão estratégica — e o screenshot do envio bem-sucedido vira prova de entrega.
Localizar o formulário
A skill encontra o formulário de contato (geralmente no rodapé da página) no site do lead.
Preencher com a mensagem
Insere a mensagem personalizada e o link do site-presente nos campos certos, automaticamente.
Enviar e capturar a prova
Submete o formulário e tira um screenshot da confirmação — a evidência de que a mensagem passou.
📊 Por que formulário e não cold e-mail
- • Canal menos saturado: a caixa de entrada está cheia; o formulário de contato chega ao dono direto.
- • Contexto certo: a pessoa lê uma mensagem sobre o próprio site, vinda do próprio site.
- • Prova de entrega: o screenshot do envio bem-sucedido confirma que a mensagem foi recebida.
⚠️ Atenção: automação responsável
Enviar mensagens automáticas por formulários exige respeito a volume, relevância e às regras de cada site. A força do sistema é a personalização e o valor entregue — não o spam. Mensagens genéricas em massa queimam a reputação e violam termos de uso. Mantenha a abordagem específica e bem-vinda.
Formulário > caixa lotada.
Screenshot da confirmação.
Personalizado, não spam.
Do lead à conversa iniciada.
🔗 Orquestrar as skills do pipeline
Quatro skills encadeadas só formam um sistema se houver uma orquestração que as conecte e um checkpoint que proteja o progresso. Sem isso, um erro no passo 4 te obriga a repetir os passos 1 a 3 — e em pipelines longos, isso custa horas e dinheiro de API.
Prompt copiável — SKILL.md da orquestradora
--- name: local-leads-pipeline description: Orchestrates a local-lead pipeline end to end. Use when the user wants to find local businesses from directories, enrich the contacts, build a gift website per lead, and reach out via their contact form. Triggers include "find local leads", "run the lead pipeline", "enrich and reach these businesses". --- # Local Leads Pipeline (orchestrator) Run four stages in order. Each stage is its own skill. Pass the CSV forward. Save a checkpoint after each lead so the run can resume. 1. scrape-directory → leads.csv (name, business, phone, address) 2. enrich-contacts → +website, +linkedin (waterfall, cheap → costly) 3. build-gift-site → +gift_url (clone / redesign / chat widget) 4. submit-form → +sent_proof (screenshot of the confirmation) ## Rules - A stage only consumes rows where its input columns are filled and its output columns are empty (idempotent — safe to re-run). - Write a checkpoint file after each lead. On restart, skip leads already marked done. - If a stage fails on a lead, log it and continue — do NOT stop the batch. - Keep outreach personalised and respectful of each site's rules.
✓ Orquestração robusta
- ✓Contrato de colunas claro entre estágios.
- ✓Checkpoint após cada lead — retoma de onde parou.
- ✓Idempotente: re-rodar não duplica trabalho.
- ✓Falha de um lead não derruba o lote inteiro.
✗ Pipeline frágil
- ✗Uma skill gigante que faz os quatro passos juntos.
- ✗Sem checkpoint — erro no fim recomeça tudo.
- ✗Re-rodar reprocessa leads já prontos (paga 2x).
- ✗Um lead com erro para o batch de 600.
💡 Dica: o CSV é o contrato
A planilha que atravessa o pipeline é o contrato entre as skills. Cada estágio sabe quais colunas ler e quais escrever. Esse padrão — "uma skill só toca nas linhas onde sua entrada está pronta e sua saída ainda está vazia" — é o que torna o sistema idempotente e seguro para retomar.
✍️ Exercícios práticos
Desenhe o contrato. Para cada um dos quatro estágios, liste as colunas que ele lê e as que escreve no CSV. Onde dois estágios encostam, o contrato bate?
Crie um SKILL.md rodável. Salve a orquestradora acima em ~/.claude/skills/local-leads-pipeline/SKILL.md e implemente só o estágio 1 (scrape) num diretório público qualquer, gravando um CSV. Teste o disparo da skill.
Projete a cascata. Escolha 3 fontes de enriquecimento (gratuitas ou pagas), ordene-as por custo e escreva a regra de "parar quando achou site + LinkedIn".
Teste a retomada. Rode o estágio 1 sobre 10 leads, interrompa no meio e rode de novo. Ele pula os já processados ou reprocessa tudo? Conserte para ser idempotente.
📌 Resumo do Módulo
Próximo Módulo:
4.3 — 📊 Lead Scoring com Apify: pontuar cada lead em três dimensões para saber quem abordar primeiro.