Files
COMERCIAL-GTI/prospeccao/cnpj/README.md
T
Gustavo d330bb5ff0 Baseline commit of the existing Maquina Comercial Pessoal project
Tracks the app that was already in place (capture, treatment, outreach,
WhatsApp integration, server, frontend, tests, docs) so future feature
work can branch and use isolated worktrees.
2026-07-31 10:54:07 -03:00

44 lines
1.5 KiB
Markdown

Coloque aqui arquivos CSV extraidos da base publica de CNPJ da Receita Federal ou uma planilha ja tratada.
O captador aceita CSV com cabecalho e tenta reconhecer colunas comuns como:
- `cnpj`
- `razao_social` ou `razao social`
- `nome_fantasia` ou `nome fantasia`
- `telefone`, `telefone 1`, `ddd`, `ddd 1`
- `municipio` ou `cidade`
- `uf`
- `cnae`, `cnae_fiscal` ou `cnae principal`
- `logradouro`, `numero`, `bairro`
Comando para baixar/retomar somente os 21 ZIPs necessários da Receita Federal (cerca de 6 GB):
```powershell
npm run download-rfb
```
Snapshots novos exigem 8 GiB livres antes de tocar a base existente. Na retomada do mesmo snapshot, arquivos finais confirmados e parciais retomáveis são descontados, mantendo ao menos 2 GiB para extração. A base completa anterior permanece em `.rfb-backup` até a substituta ser validada; estados incompletos preservados usam `.rfb-incomplete*`.
Comando para baixar o que estiver faltando e extrair uma UF (gera o CSV
`estabelecimentos-<UF>.csv` usado pela captura):
```powershell
npm run extract -- --uf=BA
```
Use `--no-download` apenas para exigir a base local completa sem consultar ou baixar o snapshot atual.
Comando para capturar leads usando a base já extraída:
```powershell
npm run capture -- --sources=cnpj-base --uf=BA --cities="Ilheus"
```
Com enriquecimento pela BrasilAPI, inclua a fonte `brasilapi`:
```powershell
npm run capture -- --sources=cnpj-base,brasilapi --uf=BA --cities="Ilheus"
```
O modo `brasilapi` usa os CNPJs encontrados nos CSVs locais para consultar dados atualizados por CNPJ.