CNPJ Lookup 🔍
Consulta empresas brasileiras via CNPJ usando APIs públicas com fallback automático.
Início Rápido
CODEBLOCK0
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
- 1. 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
- 4. Rate Limit: Respeita limites de cada provider (30/2/30 req/min)
- Normalização: Output padronizado independente do provider
Execução via Script
CODEBLOCK1
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.
CNPJ 查询 🔍
通过CNPJ查询巴西企业信息，使用公共API并具备自动故障切换功能。
快速开始
查询CNPJ 12.345.678/0001-95
通过CNPJ 19131243000197搜索企业
告诉我公司名称、注册状态、主要CNAE、地址和股东信息
以JSON格式显示CNPJ 19131243000197的详细信息
工作流程
工作流程1：简单查询（摘要）
用户仅请求基本信息：
典型提示： 查询cnpj 19131243000197
工作流程2：完整查询（详细信息+股东信息）
用户请求详细信息，包括：
- - 主要和次要CNAE
- 股东和管理层信息（QSA）
- 联系方式（邮箱、电话）
- 注册资本
典型提示： CNPJ 19131243000197的完整查询或股东详细信息
工作流程3：导出JSON
用户需要结构化数据用于集成：
- - 返回标准化模式的JSON
- 包含元数据（来源、缓存、时间戳）
典型提示： cnpj 19131243000197 json或导出CNPJ数据
工作原理
- 1. 验证：CNPJ经过清理（仅保留数字）并验证校验位
- 缓存：之前的查询返回缓存数据（TTL：24小时）
- 级联故障切换：
- BrasilAPI → CNPJ.ws → OpenCNPJ
- 4. 速率限制：遵守每个提供商的限制（30/2/30 请求/分钟）
- 标准化：输出统一格式，与提供商无关
通过脚本执行
bash
完整查询（默认包含详细信息：股东信息、CNAE等）
python3 scripts/cnpj_lookup.py 19131243000197
JSON格式查询
python3 scripts/cnpj_lookup.py 19131243000197 --json
强制使用特定提供商
python3 scripts/cnpj_lookup.py 19131243000197 --provider brasilapi
忽略缓存
python3 scripts/cnpj_lookup.py 19131243000197 --no-cache
自定义TTL（秒）
python3 scripts/cnpj_lookup.py 19131243000197 --ttl 3600
简单查询（仅基本信息）
python3 scripts/cnpj_lookup.py 19131243000197 --detailed False
参考
- - 提供商 - 端点、限制和速率限制行为
- 字段 - 标准化模式及提供商间的差异
声明
数据仅供查询/丰富使用；不能替代官方文件。
