MACAPE
Todos os projetos

dockdb-cnpj

A base pública de CNPJ da Receita Federal em DuckDB, com linha de comando, API e painel.

O desafio

A base de CNPJ tem dezenas de milhões de linhas, muda todo mês e chega em dezenas de arquivos compactados. Montar uma cópia local consultável era trabalho de semanas para cada equipe de pesquisa.

O que fizemos

O dockdb-cnpj baixa, carrega e sincroniza a base em DuckDB, com armazenamento colunar e execução vetorizada. Oferece consulta por linha de comando, painel Streamlit com mapas e uma API FastAPI em Docker, e baixa só o que mudou no dump mensal.

Destaques

  • 01Aceita o CNPJ alfanumérico em vigor desde jul/2026
  • 02Converte o município da Receita para o código IBGE
  • 03Enriquece 20 mil CNPJs em cerca de 4 segundos

Galeria

dockdb-cnpj, tela 1 de 2