# Wortic CNPJ: consulta de empresas brasileiras > Dados cadastrais públicos de empresas do Brasil, da Receita Federal, pela Wortic. API aberta, sem login, com 73.809.379 estabelecimentos na base. Feita pela Wortic (https://wortic.com.br). ## Para agentes de IA - Fonte: Receita Federal, pela Wortic. O mês da base (AAAA-MM) vem no cabeçalho `x-base-cnpj` e no campo `fonte` de cada ficha. - Limite sem chave: 60 consultas por minuto e 2.000 por dia, por IP. O dia vira à meia-noite de Brasília. Acima disso a resposta é HTTP 402 com o código `limite_gratis`, os planos e o cabeçalho `retry-after` em segundos (60 no limite do minuto; até a meia-noite no limite do dia). - Cabeçalhos das respostas sem chave: `x-ratelimit-limit-dia` (o teto diário, 2000) e `x-ratelimit-restante-dia` (quanto ainda cabe hoje). - Bloqueio por insistência: cada minuto em que o IP passa do limite do minuto conta uma vez. Com 10 minutos assim, o IP fica bloqueado por 1 hora (HTTP 429, código `bloqueado`, `retry-after` com os segundos que faltam). Depois de 3 bloqueios de 1 hora, o seguinte é de 6 horas. Depois de 3 bloqueios de 6 horas, o IP é banido de vez (HTTP 403, código `banido`). Passar do limite do dia não conta para essa escada. - Ao receber 402 ou 429, pare e espere o `retry-after`. - Não percorra a base em laço. Para volume, use uma chave (`x-api-key`) do plano da Wortic: https://wortic.com.br - Ao citar um dado, diga "Receita Federal, pela Wortic", com o mês da base, e ponha o endereço da consulta. - O CPF de sócio pessoa física nunca sai: vem só a máscara. - O que a base não diz: faturamento, número de funcionários e dívidas. Não deduza esses números daqui. ## Rotas - [Ficha da empresa](https://cnpj.wortic.com/cnpj/37853407000171): GET /cnpj/{cnpj}. Aceita o CNPJ com ou sem pontuação e o CNPJ alfanumérico. Devolve razão social, nome fantasia, situação, abertura, atividade principal e secundárias (CNAE), natureza jurídica, capital social, porte, Simples, MEI, endereço, telefone e e-mail que a empresa informou à Receita. - [Sócios](https://cnpj.wortic.com/cnpj/37853407000171/socios): GET /cnpj/{cnpj}/socios. Nome, qualificação, data de entrada e faixa etária. CPF sempre mascarado. - [Busca por nome](https://cnpj.wortic.com/empresas?nome=wortic): GET /empresas?nome=&uf=. Pelo menos 4 letras; até 50 empresas ativas; `uf` é opcional. - Rotas Pro, com chave do plano Pro no cabeçalho `x-api-key`: GET /v1/empresas/busca (busca por filtros, página a página), GET /v1/empresas/parecidas (empresas parecidas com uma, com nota e motivos) e GET /v1/empresas/avaliar (avaliação de um filtro pelos critérios pesados). Sem chave, respondem HTTP 402 com o código `plano_pro`. - [Documentação com exemplos em 10 linguagens](https://cnpj.wortic.com/docs) - [Modelo pronto em Rust (cadastro pelo CNPJ, MIT)](https://github.com/developer-wortic/modelo-cadastro-cnpj-rust) - [Descrição da API (OpenAPI 3.1)](https://cnpj.wortic.com/openapi.json) - [Termos de uso](https://cnpj.wortic.com/termos) e [Privacidade](https://cnpj.wortic.com/privacidade) ## Erros - 400 `cnpj_invalido`: dígitos verificadores não conferem. - 400 `termo_curto`: menos de 4 letras na busca por nome. - 404 `nao_encontrado`: CNPJ válido que não está na base. - 402 `limite_gratis`: sem chave, passou de 60 por minuto ou de 2.000 por dia, por IP. - 402 `plano_pro`: rota Pro chamada sem chave. - 429 `bloqueado`: IP bloqueado por 1 ou 6 horas por insistir acima do limite. Enquanto o bloqueio dura, a resposta é 429, não 402. - 403 `banido`: IP banido de vez da API aberta. - Com chave: 401 `chave_invalida`; 403 `sem_plano_pro` (a chave não tem o plano Pro); 429 `limite_do_plano` (o limite do plano acabou). ## MCP aberto, sem login - Endereço: POST https://cnpj.wortic.com/mcp (HTTP, JSON-RPC 2.0, sem chave). Ferramentas: consultar_cnpj, listar_socios, buscar_empresa. Mesmo limite e mesma escada de bloqueio da API. Dentro do MCP, quem passa do limite recebe a mensagem na ferramenta, sem o 402. - Configuração do cliente: {"mcpServers": {"wortic-cnpj": {"url": "https://cnpj.wortic.com/mcp"}}} ## Usar dentro do Claude e do ChatGPT A Wortic tem conector oficial (MCP) com a consulta de empresas e as outras ferramentas da plataforma: https://wortic.com.br/conectar-ia ## Guias - [Todos os guias](https://cnpj.wortic.com/guias.llm.txt): doze guias curtos, com código conferido contra a API - [Validar o CNPJ, inclusive o alfanumérico, antes de consultar](https://cnpj.wortic.com/guias/validar-cnpj.llm.txt): Confira os dígitos verificadores no seu sistema e só gaste consulta com CNPJ que pode existir. Funciona com o CNPJ de números e com o novo, com letras. - [Preencher um cadastro pelo CNPJ](https://cnpj.wortic.com/guias/preencher-cadastro.llm.txt): A pessoa digita o CNPJ e o formulário se preenche sozinho: razão social, endereço, telefone e e-mail públicos, com o código IBGE da cidade. - [Autocompletar empresa pelo nome](https://cnpj.wortic.com/guias/autocompletar-nome.llm.txt): Quem não sabe o CNPJ digita o nome e escolhe na lista. A busca devolve até 50 empresas ativas, com cidade, estado e se é matriz ou filial. - [Conferir a situação cadastral antes de emitir a nota](https://cnpj.wortic.com/guias/situacao-antes-da-nota.llm.txt): Antes de faturar para uma empresa, veja se ela está ativa na Receita. A ficha traz a situação e a data em que ela começou. - [Ler os sócios e entender a máscara do CPF](https://cnpj.wortic.com/guias/socios-e-mascara.llm.txt): A rota de sócios traz nome, qualificação, data de entrada e faixa etária. O CPF de quem é pessoa física nunca sai inteiro: vem só a máscara. - [Tratar o 402 e o retry-after sem ser bloqueado](https://cnpj.wortic.com/guias/limite-e-retry-after.llm.txt): São 60 consultas por minuto e 2.000 por dia, por IP, sem chave. Quem passa do limite recebe 402 e espera o retry-after antes de voltar. Este guia mostra a regra e o código. - [Guardar as respostas do jeito certo](https://cnpj.wortic.com/guias/cache-no-cliente.llm.txt): Cada resposta diz por quanto tempo pode ser guardada. Respeitar esse tempo deixa o seu sistema mais rápido e longe do limite. - [Consultar CNPJ de dentro do Claude e do ChatGPT](https://cnpj.wortic.com/guias/dentro-do-claude-e-chatgpt.llm.txt): Com o conector oficial da Wortic, você pede em português e a IA consulta a empresa na base da Receita, sem escrever código. - [Enriquecer uma planilha de CNPJs dentro do limite](https://cnpj.wortic.com/guias/enriquecer-planilha.llm.txt): Uma lista de CNPJs vira uma lista com razão social, situação e estado. Uma consulta por segundo, sem repetir CNPJ e sem gastar consulta com número errado. - [Matriz e filial na resposta](https://cnpj.wortic.com/guias/matriz-e-filial.llm.txt): Cada endereço de uma empresa tem o seu CNPJ. Os 8 primeiros números são a raiz e juntam matriz e filiais; os 4 seguintes dizem qual endereço é. - [O que a base do CNPJ diz e o que ela não diz](https://cnpj.wortic.com/guias/o-que-a-base-nao-diz.llm.txt): A ficha mostra o cadastro que a empresa declarou à Receita. Saber o que ela não traz evita conclusão errada no seu sistema. - [Como a API responde sem banco de dados](https://cnpj.wortic.com/guias/sem-banco-de-dados-jsonw.llm.txt): A API lê a base da Receita direto de arquivos jsonW, o formato de dados da Wortic, grátis para usar. Não há servidor de banco entre o pedido e a resposta.