CNPJ Lookup 🔍
Consulta empresas brasileiras via CNPJ usando APIs públicas com fallback automático.
Início Rápido
"Consultar CNPJ 12.345.678/0001-95"
"Pesquisar empresa pelo CNPJ 19131243000197"
"Me diga razão social, situação cadastral, CNAE principal, endereço e QSA"
"Detalhe do CNPJ 19131243000197 em JSON"
Workflows
Workflow 1: Consulta Simples (Resumo)
O usuário pede apenas informações básicas:
- Razão social
- Nome fantasia
- Situação cadastral
- Endereço resumido
Prompt típico: "consultar cnpj 19131243000197"
Workflow 2: Consulta Completa (Detalhes + QSA)
O usuário pede informações detalhadas incluindo:
- CNAE principal e secundários
- Quadro de Sócios e Administradores (QSA)
- Contato (email, telefone)
- Capital social
Prompt típico: "consulta completa do CNPJ 19131243000197" ou "detalhes QSA"
Workflow 3: Exportar JSON
O usuário quer dados estruturados para integração:
- Retorna JSON com schema normalizado
- Inclui metadados (fonte, cache, timestamp)
Prompt típico: "cnpj 19131243000197 json" ou "exportar dados CNPJ"
Como Funciona
- Validação: CNPJ é sanitizado (só dígitos) e verifica dígitos verificadores
- Cache: Consulta anterior retorna dados em cache (TTL: 24h)
- Fallback em cascata:
- BrasilAPI → CNPJ.ws → OpenCNPJ
- Rate Limit: Respeita limites de cada provider (30/2/30 req/min)
- Normalização: Output padronizado independente do provider
Execução via Script
# Consulta completa (já vem com detalhes por padrão: QSA, CNAEs, etc)
python3 scripts/cnpj_lookup.py 19131243000197
# Consulta com JSON
python3 scripts/cnpj_lookup.py 19131243000197 --json
# Forçar provider específico
python3 scripts/cnpj_lookup.py 19131243000197 --provider brasilapi
# Ignorar cache
python3 scripts/cnpj_lookup.py 19131243000197 --no-cache
# TTL customizado (em segundos)
python3 scripts/cnpj_lookup.py 19131243000197 --ttl 3600
# Consulta simples (apenas基本信息)
python3 scripts/cnpj_lookup.py 19131243000197 --detailed False
Referências
- Provedores - Endpoints, limites e comportamento de rate limit
- Campos - Schema normalizado e divergências entre provedores
Aviso
Dados para consulta/enriquecimento; não substitui documento oficial.