Aplicativo local do Grupo GTI para capturar e tratar leads B2B em qualquer estado/cidade do Brasil, com foco na base oficial de CNPJs da Receita Federal.

Como usar (dia a dia)

Dê dois cliques em GTI-Comercial.exe (ou em INICIAR-GTI.bat).
O navegador abre em http://127.0.0.1:3900 com duas abas:
- 📡 Capturar Leads — escolha estado, cidades, nichos e fontes e rode a captura com progresso ao vivo. Se a base CNPJ do estado ainda não existe, o botão "Extrair base agora" prepara tudo (~40–60 min, uma única vez por estado).
- 📊 Tratar Leads — dashboard com totais e rankings por cidade/nicho, navegador de leads com filtros (qualidade, WhatsApp, exportado...) e o botão Gerar relatório / exportação que produz os arquivos para envio.

Tudo roda somente neste computador (porta local 127.0.0.1). Nenhum dado sai da máquina, exceto as consultas às fontes públicas durante a captura.

Exportações disponíveis

Tipo	Para quê
📊 Planilha (CSV + Excel)	Lista completa com score — números como texto, sem notação científica
🗂️ Z-PRO Oportunidades (JSONL)	Um payload `createOpportunity` por linha, pronto para importar
📨 Z-PRO Disparo em massa (CSV)	`dataInput` para `BulkSendMessageWithVariable` + instruções

Leads exportados ficam marcados — o filtro "ainda não exportados" evita reenvio. Os IDs padrão do Z-PRO (pipeline/etapa/responsável) ficam no ⚙️ Configurações.

O .xls gerado é uma tabela HTML (o Excel avisa sobre o formato ao abrir — é normal, basta confirmar). Use o .csv se preferir.

Qualidade dos leads (score)

Score: +35 telefone válido, +25 CNPJ válido, +25 empresa válida, +5 cidade, +5 nicho, +5 CNAE. Bom ≥ 85, médio 60–84, ruim < 60. Empresa vazia, com lixo ou começando com número é sempre ruim (regra crítica). Duplicidade: CNPJ → WhatsApp → empresa+cidade.

Fontes de captura

Base CNPJ (Receita Federal) — principal: todas as empresas ativas da UF, ~97% com telefone.
OpenStreetMap (Overpass e Nominatim) — grátis, complementar.
Wikidata — grátis, volume baixo.
BrasilAPI — enriquecimento opcional da base CNPJ.
Google Places — paga; preencha GOOGLE_MAPS_API_KEY no .env.

Novo estado (ex.: expandir para Sergipe)

Na aba Captura, escolha SE — Sergipe.
Clique em Extrair base agora e aguarde (usa os zips já baixados em prospeccao/cnpj/rfb-raw/).
Pronto: capture qualquer cidade de SE normalmente. Nada muda na interface.

Os zips brutos da Receita (7 GB, Brasil inteiro) já estão no projeto. Para atualizá-los no futuro (a Receita publica mensalmente): bash scripts/baixar-base-rfb.sh.

Uso avançado (linha de comando)

npm start                                             # sobe o servidor
npm test                                              # roda os testes
node scripts/capturar-leads.mjs --sources=cnpj-base --uf=BA --cities="Ilheus"
node scripts/extrair-base-cnpj.mjs --uf=SP            # extrai base de outra UF

Estrutura do projeto

GTI-Comercial.exe      inicia tudo (servidor + navegador)
scripts/               entradas de linha de comando
src/                   código do servidor, fontes de captura, exportações
public/                interface (HTML/CSS/JS)
data/gti.db            banco local (SQLite) com todos os leads
data/exports/          arquivos de exportação gerados
prospeccao/cnpj/       base CNPJ extraída por UF + zips brutos da Receita
docs/                  playbook comercial, LGPD e referência da API Z-PRO

Requisitos

Windows com Node.js 24+ (https://nodejs.org)
Para extrair novas UFs: unzip (vem com o Git para Windows) ou o tar nativo do Windows

Log e problemas

Log do servidor: data/server.log
Se a tela não abrir: rode node scripts/servidor.mjs num terminal e veja a mensagem.

README.md Unescape Escape

GTI Máquina Comercial