chore: import maquina-comercial-pessoal history via subtree

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

git-subtree-dir: maquina-comercial-pessoal
git-subtree-mainline: f5af038e19
git-subtree-split: a9ef4d776d

maquina-comercial-pessoal/prospeccao/cnpj/README.md

@@ -0,0 +1,43 @@
+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.