Consulta Empresas · Receita Federal
Consulta de CNPJ sobre a base pública da RFB (38,5 milhões de estabelecimentos) com filtros, keyset pagination e estatísticas.
Stack
Django 6.1
PostgreSQL 15
psycopg2 (SQL puro)
Keyset pagination
Destaques técnicos
- 38,5M de linhas com keyset pagination (nenhum OFFSET no código)
- Índices parciais (WHERE cd_matriz_filial = 1) e CTE MATERIALIZED
- Estatísticas pré-agregadas em c_estatisticas_totais (<5 ms)
- Filtro por cidade com semi-join (cnpj_basico IN ...) em 0,3 s
Fontes de dados (7 bases públicas)
- Receita Federal · dados.gov.br Base pública do CNPJ: 38,5M de estabelecimentos, sócios, CNAE e natureza jurídica
- Base dos Dados · br_me_cnpj Espelho tratado da RFB em BigQuery (usado para conferir totais e amostras)
- Base dos Dados · br_bd_diretorios_brasil.cep CEP com centroide em WKT (tabela cep) - o mesmo console BigQuery usado na carga
- AddressForAll Endereços e CEPs abertos, derivados do CNEFE/IBGE
- Kaggle · GeoCEP CEP geocodificado por número do endereço (média por CEP na carga)
- Correios · eDNE 2018 Base oficial de logradouros por CEP (arquivo de 2018, prioridade baixa)
- IBGE · Malha Municipal 2025 Código TOM ↔ IBGE de cada município (liga c_estabelecimentos.municipio a c_ceps.id_municipio)
Galeria de telas (5 imagens)
Filtros de consulta
Lista de empresas
Detalhe: dados da empresa
Detalhe: endereço
Detalhe: estabelecimentos e sócios