Desenvolvimento de Automação Completa para Captação e Enriquecimento de Leads B2b (N8n, Apify, Ia)

# Automação de captação e enriquecimento de leads B2B (n8n + Apify + ia) — saída em csv por e-mail

## resumo do projeto

quero construir uma automação que **coleta leads b2b de fontes públicas, consolida, remove duplicados, enriquece com ia e envia por e-mail um arquivo csv pronto para importar na nossa ferramenta interna**. Ela deve rodar de forma agendada, com mínima intervenção manual.

Já temos a ferramenta interna que recebe os leads via CSV (o formato exato está definido). O que preciso construir é o **"extrator"** que a alimenta automaticamente, todos os dias.

Vou fornecer ao profissional contratado: o playbook com as queries de busca (Cnaes, nichos por cidade, hashtags, cargos), a planilha-modelo com o esquema exato do csv, e o prompt da ia. Ou seja, o profissional **não começa do zero** — a lógica de negócio já está documentada.

## O que construir (escopo)

Orquestração (preferência por **n8n**; aceito proposta de stack equivalente, desde que justificada) contendo:

1. **Agendador + configuração de lotes** — roda em horário definido e seleciona o "lote do dia" (cidade × nicho) em rodízio, com teto configurável (ex.: 40–80 leads por execução).
2. **Fontes de dados (em paralelo):**
  - **Google Maps** via API do Apify — queries nicho × cidade → nome, telefone, site, redes sociais.
  - **cnpj por cnae** via api (casa dos dados / econodata) → base cadastral. *(Confirme na proposta a disponibilidade dessa API)*
  - **Instagram** via Apify (hashtags ou @ vindos do Maps) → contato/WhatsApp da bio.
  - **LinkedIn (decisor):** no MVP, consumir um export do Sales Navigator (passo **semi-manual**). Deixar ponto de extensão para evoluir. **Não** automatizar scraping logado na conta (risco de banimento).
3. **Consolidação + deduplicação** — junta as fontes e remove repetidos (chave: telefone; na ausência, empresa + cidade).
4. **Enriquecimento por ia** — chamada a um llm (api anthropic) que escreve a coluna `observacoes` (um "gancho" comercial de uma linha) a partir de segmento/cnae/porte. O prompt será fornecido por nós.
5. **Lista de supressão + log** — não reenviar leads já enviados; registrar cada execução.
6. **Saída: csv utf-8** com exatamente estas 10 colunas, nesta ordem:
  `empresa, contato, telefone, email, cidade, segmento, cnae, porte, origem, observacoes`
7. **Envio automático por e-mail** (SMTP/Gmail) ao vendedor, com o CSV anexo e uma linha de instrução.
8. **Robustez:** tetos de gasto nas APIs/Apify/llm, proxy residencial e throttle nos scrapers, e **tratamento de erro** — em caso de falha, alertar e **não** enviar um csv quebrado.

**(Opcional — pode ser fase separada)** Hospedar e tornar multiusuário a nossa ferramenta interna de gestão de leads (hoje um protótipo que roda local). Avaliar e orçar à parte.

## Entregas por fase (marcos de pagamento)

- **Fase 1:** Google Maps + ia do gancho + envio por e-mail — já gera um csv útil de ponta a ponta.
- **Fase 2:** + cnpj por api.
- **Fase 3:** + Instagram.
- **Fase 4:** + LinkedIn (semi-manual).

Cada fase entrega um CSV válido e funcional e é um marco com pagamento próprio.

## Stack desejada

n8n (ou equivalente justificado), Apify, integrações rest/webhook, api anthropic (llm), envio de e-mail (smtp/gmail), banco leve (sqlite/postgresql) para supressão/log, deploy em vps/docker ou n8n cloud. Tudo roda com as **nossas chaves**.

## Critérios de aceitação

- Roda agendado sem intervenção (exceto o passo semi-manual do LinkedIn).
- O CSV gerado importa na nossa ferramenta **sem erro** (vamos validar com um teste real).
- Deduplica corretamente e não reenvia leads já enviados.
- Trata erros e avisa em caso de falha.
- Entrega **documentação** (como trocar lotes/queries/chaves, como subir e manter) + walkthrough por vídeo ou call.
- Código/workflow versionado e entregue a nós — **o código é nosso**.

## O que esperamos na sua proposta

1. Um caso parecido que você já fez (pipeline de automação + scraping + API). Link ou print.
2. Como você lidaria com o risco de ToS/banimento do LinkedIn e com a LGPD (lista de supressão, opt-out).
3. Estimativa de prazo e valor **por fase**.
4. Qualquer dúvida sobre as APIs das fontes (ex.: Disponibilidade de API do Casa dos Dados/Econodata).

Propostas genéricas (copia-e-cola) serão descartadas. Quero ver que você leu o escopo.

## Observações importantes

- Não compartilharei chaves de API antes de fechar, e usaremos chaves com **limite de gasto** durante o desenvolvimento.
- Para testar, forneço um CSV de exemplo — você **não** precisa de acesso aos nossos dados reais.
- Todos os combinados ficam registrados no chat da Workana.