cnpj.ia.br vs ReceitaWS: qual escolher?
Fatos e preços públicos de setembro de 2026: dados, contatos, frescor, autenticação, busca, MCP e OpenAPI. Quando usar cada um e como migrar campo a campo.
Resumo em tabela
| Atributo | cnpj.ia.br | ReceitaWS | Fonte |
|---|---|---|---|
| Cobertura de dados | Cadastro da Receita Federal (situação, endereço, natureza jurídica, porte, CNAE principal e secundários, Simples e MEI) no perfil basic; contatos, quadro societário, regime tributário, faixa de funcionários e faixa de faturamento no perfil full. | Cadastro da Receita Federal: nome, fantasia, situacao, abertura, atividade_principal, atividades_secundarias, natureza_juridica, porte, capital_social, endereço, simples, simei; resposta pública observada para o CNPJ 00.000.000/0001-91. | fonte consultado em 03/09/2026 |
| Contatos (telefone e e-mail) | telefones, email, site e contatos_extras no perfil full, quando disponíveis. | Campos telefone e email do cadastro da Receita Federal na resposta pública; sem enriquecimento de contato na oferta observada. | fonte consultado em 03/09/2026 |
| Quadro societário | socios no perfil full, com qualificação, data de entrada, país, faixa etária e representante legal; nunca CPF de sócio ou de representante. | qsa[] com nome e qual de cada sócio na resposta pública. | fonte consultado em 03/09/2026 |
| Faixa de faturamento | faixa_faturamento, derivada do porte e nada mais (faixa_faturamento.origem é a constante porte), no perfil full. | Não verificado: nenhuma rota testada expõe a lista de campos da resposta ao acesso automatizado. | fonte consultado em 02/09/2026 |
| Frescor declarado por resposta | meta.data_as_of informa a data da base em toda resposta de consulta, busca e filtro; a base é atualizada mensalmente e GET /v1/status devolve a mesma data em data_as_of. | Campo ultima_atualizacao por registro na resposta pública. | fonte consultado em 03/09/2026 |
| Free tier | Plano Free permanente, com franquia mensal de créditos e limite por minuto próprios; sem busca com filtros. | Plano gratuito existe e responde do cache público da ReceitaWS, com limite de 3 consultas por minuto; CNPJ fora do cache só nos planos pagos, segundo o texto da própria aplicação. | fonte consultado em 03/09/2026 |
| Autenticação | Chave da conta em Authorization: Bearer (bearerAuth no OpenAPI), nunca em query string; a mesma chave vale para a API REST e para o servidor MCP. | O endpoint público v1/cnpj/{cnpj} respondeu sem chave de API; planos pagos usam chave própria (esquema não legível ao acesso automatizado em 02/09/2026). | fonte consultado em 03/09/2026 |
| Limite de requisições | Limite por minuto por conta, variável por plano, devolvido em X-RateLimit-Limit e X-RateLimit-Remaining; o 429 traz Retry-After. | 3 consultas por minuto no plano gratuito; cada plano pago publica limite por minuto e franquia mensal próprios na página de planos (valores carregados pela aplicação, não pelo HTML servido). | fonte consultado em 03/09/2026 |
| Busca com filtros | GET /v1/cnpjs com filtros por UF, município, CNAE, porte, situação, Simples, MEI, natureza jurídica, capital e data de abertura, com paginação por cursor; disponível nos planos pagos. | Não verificado: nenhuma rota testada expõe a referência da API ao acesso automatizado. | fonte consultado em 02/09/2026 |
| MCP oficial | Servidor MCP oficial da própria API, com as ferramentas consultar_cnpj, buscar_empresas, gerar_filtro e ver_uso declaradas no OpenAPI (x-mcp-tool), autenticadas pela mesma chave. | Nenhum servidor MCP oficial localizado nos registries consultados; o que aparece é receitas-mcp-server, publicado por terceiro. | fonte consultado em 02/09/2026 |
| OpenAPI público baixável | OpenAPI 3.1 publicado como arquivo em /openapi/openapi.json, linkado no site e no llms.txt. | Não localizado: nenhum arquivo OpenAPI ou Swagger público foi encontrado nas rotas testadas. | fonte consultado em 02/09/2026 |
| Renderiza sem JavaScript | Site estático: conteúdo, tabelas e exemplos vêm no HTML; o JavaScript só acrescenta abas, cópia e tema. | Não: as rotas testadas devolvem o mesmo shell HTML de 4.372 bytes, sem conteúdo servido pelo servidor. | fonte consultado em 02/09/2026 |
| Acessível a bots de IA | robots.txt aberto, com Allow: / explícito para GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, Claude-User, PerplexityBot e outros, e Content-Signal: ai-train=yes, search=yes, ai-input=yes; llms.txt publicado e uma gêmea .md por página. | Rotas /robots.txt, /llms.txt, /llms-full.txt e /sitemap.xml do host testadas: robots.txt responde HTTP 404, então nenhuma diretiva bloqueia rastreador; em compensação llms.txt, llms-full.txt e sitemap.xml também devolvem o shell HTML, e não há gêmea .md nem negociação por Accept: text/markdown. | fonte consultado em 02/09/2026 |
| Preço público | R$ 0,0020 por consulta basic e R$ 0,0119 pela full, no Pro | plano de entrada R$ 149/mês; por consulta não público | fonte consultado em 01/09/2026 |
As duas APIs consultam empresas brasileiras por CNPJ a partir dos dados da Receita Federal. A ReceitaWS oferece o cadastro, com quadro societário, em plano gratuito limitado por minuto e em planos mensais; o cnpj.ia.br acrescenta enriquecimento de contato (site e contatos extras), sinais has_*, quadro societário sem CPF, faixa de faturamento derivada do porte, busca por filtros e um servidor MCP oficial, cobrando por crédito. A tabela acima traz os fatos verificados, com fonte e data em cada linha; abaixo, o que pesa em cada escolha e como migrar.
Cobertura de dados
O cadastro (razão social, situação, endereço, CNAE, natureza jurídica, porte, capital, Simples e MEI) vem nos dois. A diferença está no que vem junto. Telefone e e-mail do cadastro da Receita Federal aparecem nos dois quando constam. No cnpj.ia.br, o perfil full acrescenta o site e os contatos extras do enriquecimento da Oportunidados, os sinais has_phone, has_email e has_website já no basic, sócios com qualificação e faixa etária (sem CPF), regime tributário, faixa de faturamento derivada do porte e faixa de funcionários. Na ReceitaWS, o quadro societário vem com nome e qualificação de cada sócio já na resposta pública (fonte: resposta pública de receitaws.com.br/v1/cnpj/{cnpj}, consultada em 03/09/2026; a mesma leitura alimenta a tabela acima).
Toda resposta de consulta, busca e filtro do cnpj.ia.br diz a data da base em meta.data_as_of. A ReceitaWS informa ultima_atualizacao por registro.
Limites e preços
A ReceitaWS tem plano gratuito, limitado a 3 consultas por minuto sobre o cache público, e publica um plano de entrada de R$ 149 por mês; os planos pagos têm limite por minuto e franquia mensal próprios, e não há preço por consulta declarado (fonte: https://receitaws.com.br/api, consultado em 01/09/2026 e em 03/09/2026).
No cnpj.ia.br o preço é por crédito, declarado antes da chamada: a consulta basic custa 1 crédito e a full 6; no plano Pro isso dá R$ 0,0020 por basic e R$ 0,0119 por full. Erros custam 0. A franquia tem hard cap: quando acaba, a API para e nada é cobrado sem uma ação sua. O limite de requisições por minuto é por conta e cresce com o plano. Todos os números em /precos e em /pricing.md.
MCP e IA
O cnpj.ia.br tem servidor MCP oficial em mcp.cnpj.ia.br com quatro ferramentas, contrato OpenAPI baixável, versão em Markdown de toda página e llms.txt. Na auditoria de 02/09/2026 a ReceitaWS não tinha servidor MCP oficial (há um wrapper comunitário não oficial), não tinha OpenAPI público localizável, e o HTML bruto das rotas testadas não traz o conteúdo sem JavaScript (fonte: receitaws.com.br e rotas /docs, /planos, /api, consultadas em 02/09/2026).
Quando escolher a ReceitaWS
- A integração já existe, funciona e você só consulta cadastro por CNPJ.
- O volume cabe no plano gratuito ou no de entrada, e o custo por consulta não é uma variável para o seu caso.
- Você não precisa de contato, busca por filtros nem de agentes consultando a base.
Quando escolher o cnpj.ia.br
- Você precisa do enriquecimento de contato (site, contatos extras, sinais
has_*), de sócios sem CPF ou de faixa de faturamento para segmentar. - Você precisa descobrir empresas por CNAE, cidade, porte, situação ou data de abertura, não só consultar CNPJs conhecidos.
- Um agente (Claude, Cursor, OpenAI) vai consultar a base por MCP com a mesma chave.
- Você quer saber o custo antes de chamar e a data da base em cada resposta.
Migração campo a campo
Nomes lidos das respostas públicas dos dois serviços para o CNPJ 00.000.000/0001-91 em 03/09/2026 (fontes: receitaws.com.br/v1/cnpj/{cnpj} e o contrato OpenAPI do cnpj.ia.br). No cnpj.ia.br, os códigos vêm junto da descrição em objetos { codigo, descricao }.
| ReceitaWS | cnpj.ia.br | Observação |
|---|---|---|
nome | razao_social | |
fantasia | nome_fantasia | null quando não declarado |
situacao, data_situacao, motivo_situacao | situacao_cadastral.descricao, data_situacao_cadastral, motivo_situacao_cadastral.descricao | código em .codigo |
abertura | data_inicio_atividade | ISO 8601 (AAAA-MM-DD) |
tipo | matriz_filial.descricao | |
atividade_principal[].code / .text | cnae_fiscal.codigo / .descricao | código sem pontuação |
atividades_secundarias[] | cnaes_secundarios[] | mesma forma { codigo, descricao } |
natureza_juridica | natureza_juridica.descricao | código em .codigo |
porte | porte.descricao | código em .codigo |
capital_social | capital_social | número |
logradouro, numero, complemento, bairro, cep, municipio, uf | endereco.* | mais codigo_municipio_ibge e codigo_municipio_siafi |
simples.optante, simei.optante | simples.optante, mei.optante | com data_opcao e data_exclusao |
telefone, email | telefones[] (ddd, numero), email | perfil full; site e contatos_extras[] além disso |
qsa[].nome, qsa[].qual | socios[].nome, socios[].qualificacao.descricao | perfil full; mais tipo, data de entrada, país, faixa etária; nunca CPF |
ultima_atualizacao | meta.data_as_of | data da base mensal, em consulta, busca e filtro |
status | status HTTP + error.code | erros custam 0 |
Quando usar cada um
ReceitaWS é a escolha de quem já tem uma integração funcionando com ela, precisa só do cadastro por CNPJ e prefere não mudar de fornecedor: plano gratuito sobre o cache público, plano de entrada mensal público e quadro societário na resposta.
cnpj.ia.br é a escolha de quem precisa de enriquecimento de contato (site e contatos extras além do cadastro, com os sinais has_* para saber onde vale pedir o full), de faixa de faturamento, de busca por filtros, de um servidor MCP oficial para agentes, ou de um contrato legível por máquina: OpenAPI baixável, gêmeas em Markdown e a data da base em toda resposta. Cobra por crédito, com peso declarado antes de chamar.
Perguntas frequentes
Posso migrar da ReceitaWS sem reescrever a integração?
A chamada continua sendo um GET por CNPJ com JSON de resposta, mas os nomes de campo mudam e a autenticação passa a ser por header Authorization: Bearer. A tabela de migração desta página mapeia campo a campo, com os nomes lidos nas respostas públicas em setembro de 2026; a maior diferença é que códigos e descrições vêm juntos em objetos.
A ReceitaWS é mais barata?
Depende do volume e do que você precisa. A ReceitaWS publica um plano de entrada mensal, e o custo por consulta não é público no site; o cnpj.ia.br publica o peso de cada operação e o preço de cada plano, então dá para calcular o custo antes de contratar. A tabela desta página traz os dois com fonte e data.
Os dados são os mesmos nos dois?
O cadastro vem da mesma origem, os dados abertos da Receita Federal, e os dois trazem telefone e e-mail quando constam nele. O cnpj.ia.br acrescenta enriquecimento da Oportunidados (site e contatos extras), os sinais has_*, a faixa de faturamento derivada do porte e a data da base em toda resposta de consulta e busca; a ReceitaWS traz o quadro societário com nome e qualificação e ultima_atualizacao por registro.
Quero usar com um agente. Qual escolher?
O cnpj.ia.br tem servidor MCP oficial com a mesma chave da API, contrato OpenAPI baixável e páginas em Markdown. Na auditoria de setembro de 2026 a ReceitaWS não tinha MCP oficial; existe um wrapper comunitário não oficial.
Com que frequência esta comparação é revisada?
A cada trimestre, com a data de revisão visível no topo da página e a data de consulta em cada linha da tabela. Se um fato mudou antes disso, escreva para o contato do rodapé e corrigimos com a fonte.