# Radar CNPJ

> Produto principal: POST /api/avaliar — ideia em texto → empresas registradas (CNAE, lugar, contagens).
> Não estima volume de busca nem promete renda passiva.
> Também consulta, busca por IA e monitoramento anônimo de CNPJ.
> UI humana: pesquisa → recorte explícito → lista de empresas → ficha e acompanhamento. Agentes devem consumir estes contratos.
> Acervo: até 20 empresas por página com itens[].dados; aproveite o lote antes de consultar cada ficha.



**Parceria, patrocínio e anúncio**

Espaços do produto sob consulta, com preço sugerido em USD por 30 dias, os números públicos ao lado e uma proposta que chega direto a quem responde.

- `GET https://staging.radar-cnpj.com/api/partners` — espaços, preço sugerido, carteira e os campos da proposta.
- [Enviar proposta](https://staging.radar-cnpj.com/parceria) — a mesma oferta para gente, com o formulário.
- `GET https://staging.radar-cnpj.com/okf/parceria.md` — a oferta em markdown, para ler sem parsear JSON.


**Acervos públicos de dados**

Explore endereços e compras por lugar e abra os registros de que precisa. Até 20 itens por página, em formatos prontos para pessoas e agentes. Confira a cobertura e a data de referência antes de usar um resultado. Cada produto informa suas opções de acesso.

- [Empresas por CNPJ](https://api.radar-cnpj.com/empresas/index.json): Estabelecimentos ativos por estado, município e atividade (CNAE), com ficha pública por CNPJ. UF → município → atividade (CNAE) → estabelecimentos → ficha por CNPJ. [HTML](https://api.radar-cnpj.com/empresas/) · [llms.txt](https://api.radar-cnpj.com/empresas/llms.txt) · [OKF](https://api.radar-cnpj.com/empresas/okf/index.md)
- [CEPs e endereços](https://api.pontofato.com/enderecos/index.json): Encontre endereços por lugar, com coordenadas e referência de 2022. Não certifica CEP vigente. UF → município → bairro/localidade → rua → endereços. [HTML](https://api.pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md)
- [Editais e compras públicas](https://api.editalmd.com/licitacoes/index.json): Encontre compras públicas por lugar e período. Consulte documentos e opções de leitura no EditalMD. Modalidade → UF → ano → mês → dia → município → compras. [HTML](https://api.editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md)


**Contato**

- `POST /api/contato` (ou `/api/contact`): grátis, sem captcha nem pagamento; uma mensagem a cada 10 s por rede.

**Cota**

- Grátis: avaliar ideia (`POST /api/avaliar`) — sem cota.
- Grátis: consulta e busca de CNPJ — sem cota (cache de borda 6h).
- Grátis: monitoramento de CNPJ — 10 watches por sessão (a cota vem da origem: `quota` em `GET /api/me/monitor/watches`).
- Pago: 1,000 basic reads across /empresas, /enderecos and /licitacoes, valid for 30 days; availability and purchase: GET/POST /api/acesso; no automatic renewal — **$1.00** USDC via x402.
- Pago: watch de monitoramento além dos 10 da sessão, por 30 dias — **$0.50** USDC via x402.
- Pago: revelação de sócios, telefones e e-mail de uma empresa — **$0.10** USDC via x402.

- **Sem cobrar agora**: *. Chame direto — não vem 402. O preço acima é o de tabela e volta a valer sem aviso.

Estourou a franquia → **402** com `accepts[]` (x402, USDC na Base). Pague e repita a mesma chamada com `X-PAYMENT`.

Números em vigor: https://staging.radar-cnpj.com/api/

**MCP**

- **Endpoint:** `POST https://staging.radar-cnpj.com/mcp` — Streamable HTTP, JSON-RPC 2.0. Não precisa instalar nada.
- Confira com `GET https://staging.radar-cnpj.com/mcp` (cartão do servidor) ou `tools/list`.
- Cada tool é uma chamada nesta mesma API — o MCP não tem backend próprio.
- Credencial (`X-Guest-Token`, `Authorization`, `X-PAYMENT`) vai no header e é repassada.

**Skill**

- `.agents/skills/radar-cnpj/SKILL.md` — paridade com esta superfície.
- **Paridade:** mexeu na UI/API → apidocs + skill + este arquivo no mesmo PR.


## Descoberta

- [Índice da API](https://staging.radar-cnpj.com/api/)
- [llms.txt](https://staging.radar-cnpj.com/llms.txt): este arquivo
- [OpenAPI](https://staging.radar-cnpj.com/openapi.json)
- [Health](https://staging.radar-cnpj.com/api/health)
- [Guia de valor, compra e recuperação](https://staging.radar-cnpj.com/api-access-guide.md): escolha a operação e autorize orçamento explicitamente.
- [Integrações e agentes](https://staging.radar-cnpj.com/developers): comece aqui; contratos e exemplos fora da jornada humana.

## Convenções

- Rota de leitura aceita `GET` e também `POST`, `PUT` ou `PATCH` com os mesmos parâmetros em JSON ou formulário.
- JSON é o padrão; `Accept: text/html` devolve a mesma resposta em HTML.
- `/skill.md` é a skill pronta para agente; `/.well-known/api-catalog` (ou `/discovery/resources`) lista as superfícies; `/mcp` também atende em `/mcp/v1`.

## Endpoints principais

- [`GET /api/auth/bootstrap`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fbootstrap): Prepara o navegador para entrar na conta global. (auth: none)
- [`GET /api/account/profile`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fprofile): Consulta seu perfil global. (auth: session)
- [`GET /api/account/avatar`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Favatar): Consulta sua foto de perfil global. (auth: session)
- [`GET /api/me`](/llms-full.txt?prefix=%2Fapi%2Fme): Lê a conta global atual neste produto. (auth: session)
- [`POST /api/auth/logout`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Flogout): Revoga esta sessão do produto. (auth: session)
- [`GET /api/account/keys`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys): Lista suas chaves de API neste produto. (auth: session)
- [`POST /api/account/keys/create`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys%2Fcreate): Cria uma chave de API para agentes e scripts. (auth: session)
- [`POST /api/account/keys/revoke`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys%2Frevoke): Revoga uma das suas chaves de API. (auth: session)
- [`GET /okf/:arquivo`](/llms-full.txt?prefix=%2Fokf%2F%3Aarquivo): Bundle OKF (Open Knowledge Format v0.1): markdown com frontmatter para o agente ler o produto inteiro sem parsear HTML. (auth: none)
- [`GET /.well-known/:arquivo`](/llms-full.txt?prefix=%2F.well-known%2F%3Aarquivo): Descoberta de máquina antes da home: `api-catalog` (RFC 9727, linkset com a API e o MCP), `security.txt` (RFC 9116), `x402` (manifesto de pagamento: rede, carteira e rotas que cobram), `agent-card.json` (identidade do agente: ferramentas MCP e portas de descoberta; também em `/agent.json`) e `mcp-registry-auth` (chave do registro oficial de MCP). (auth: none)
- [`GET /apis.json`](/llms-full.txt?prefix=%2Fapis.json): APIs.json (apisjson.org, 0.19): o índice que o APIs.io colhe — a API, o MCP, OpenAPI, guia e bundle OKF num arquivo só. Também em `/.well-known/apis.json`. (auth: none)
- [`GET /agent.json`](/llms-full.txt?prefix=%2Fagent.json): Cartão do agente: identidade, quem opera, documentação, o endpoint MCP e as ferramentas que ele serve. Mesmo documento de `/.well-known/agent-card.json`. (auth: none)
- [`GET /okf/:tipo/:id.md`](/llms-full.txt?prefix=%2Fokf%2F%3Atipo%2F%3Aid.md): O mesmo registro que a API responde, em markdown OKF: `cnpj` (Empresa por CNPJ, na base da Receita). Via de acesso para quem já tem o id, não catálogo. (auth: none)
- [`POST /mcp`](/llms-full.txt?prefix=%2Fmcp): Servidor MCP por HTTP (Streamable HTTP, JSON-RPC 2.0) — pluga no cliente sem instalar nada. (auth: none)
- [`POST /api/avaliar`](/llms-full.txt?prefix=%2Fapi%2Favaliar): Descreva uma atividade e um lugar para consultar as empresas registradas nesse recorte. (auth: none)
- [`GET /api/cnpj/:cnpj`](/llms-full.txt?prefix=%2Fapi%2Fcnpj%2F%3Acnpj): A ficha cadastral de uma empresa, pelos 14 dígitos do CNPJ, com o dado pessoal mascarado. (auth: none)
- [`POST /api/revelar/:cnpj`](/llms-full.txt?prefix=%2Fapi%2Frevelar%2F%3Acnpj): Revela o dado pessoal da ficha — nomes dos sócios, telefones e e-mail sem máscara. Pago por empresa. (auth: credito)
- [`GET /api/busca`](/llms-full.txt?prefix=%2Fapi%2Fbusca): Busca empresas por termo e/ou filtros avançados, paginada. (auth: none)
- [`GET /api/export`](/llms-full.txt?prefix=%2Fapi%2Fexport): Exporta o resultado da busca em CSV ou JSON, com os mesmos filtros dela. (auth: none)
- [`GET /api/sugerir`](/llms-full.txt?prefix=%2Fapi%2Fsugerir): Autocomplete de empresas e termos, para montar a lista enquanto a pessoa digita. (auth: none)
- [`GET /api/ref`](/llms-full.txt?prefix=%2Fapi%2Fref): Vocabulários oficiais para montar seletor: CNAE, município e natureza jurídica. (auth: none)
- [`POST /api/ia`](/llms-full.txt?prefix=%2Fapi%2Fia): Transforma um texto livre nos filtros normalizados que a busca aceita. (auth: none)
- [`POST /api/ia/jobs`](/llms-full.txt?prefix=%2Fapi%2Fia%2Fjobs): Enfileira a mesma tradução de texto para filtros, quando a síncrona não cabe no tempo. (auth: none)
- [`GET /api/ia/jobs/:id`](/llms-full.txt?prefix=%2Fapi%2Fia%2Fjobs%2F%3Aid): Consulta o trabalho de IA enfileirado; quando pronto, devolve os filtros. (auth: none)
- [`GET /api/local`](/llms-full.txt?prefix=%2Fapi%2Flocal): Cidade e UF aproximadas de quem está chamando. (auth: none)
- [`GET /api/municipio-proximo`](/llms-full.txt?prefix=%2Fapi%2Fmunicipio-proximo): Município de um par de coordenadas, com o bairro quando disponível. (auth: none)
- [`POST /api/guest`](/llms-full.txt?prefix=%2Fapi%2Fguest): Cria ou recupera o visitante temporário deste navegador. (auth: none)
- [`POST /api/auth/claim`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fclaim): Vincula à conta as vigias feitas neste navegador. (auth: session)
- [`GET /api/me/monitor/watches`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fmonitor%2Fwatches): Os CNPJs que você acompanha, com a cota aplicada (grátis + vagas compradas). (auth: session)
- [`POST /api/me/monitor/watch`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fmonitor%2Fwatch): Passa a acompanhar um CNPJ. Os 10 primeiros são grátis; cada vaga a mais, US$ 0,50 por 30 dias. (auth: session)
- [`DELETE /api/me/monitor/watch/:cnpj`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fmonitor%2Fwatch%2F%3Acnpj): Para de acompanhar um CNPJ. A chave é o próprio CNPJ, não um id. (auth: session)
- [`GET /api/me/monitor/alerts`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fmonitor%2Falerts): Os alertas gerados para os CNPJs que você acompanha. (auth: session)
- [`GET /api/monitor/changes/:cnpj`](/llms-full.txt?prefix=%2Fapi%2Fmonitor%2Fchanges%2F%3Acnpj): O histórico de alterações cadastrais de um CNPJ. (auth: session)
- [`POST /api/contato`](/llms-full.txt?prefix=%2Fapi%2Fcontato): O mesmo contato de `/api/contact`, com o nome da rota em português. (auth: none)
- [`POST /api/pagamento/aberto`](/llms-full.txt?prefix=%2Fapi%2Fpagamento%2Faberto): A interface relata que exibiu uma cobrança. Agentes não devem chamar. (auth: none)
- [`GET /api/vitrine`](/llms-full.txt?prefix=%2Fapi%2Fvitrine): Os números públicos do produto: tráfego, agentes, uso e confiabilidade, sem dinheiro. (auth: none)
- [`GET /api/vitrine/operador`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Foperador): O documento completo do produto no painel do operador — só com o token do operador. (auth: none)
- [`GET /api/vitrine/painel`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Fpainel): O painel da casa inteira, na forma que o gm lê — só com o token do operador. (auth: none)
- [`GET /api/vitrine/cursores`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Fcursores): O cursor de erro resolvido por produto (`borda`, `cli`) — só com o token do operador. (auth: none)
- [`GET /api/partners`](/llms-full.txt?prefix=%2Fapi%2Fpartners): Parceria, patrocínio e anúncio: os espaços do produto com preço sugerido, os números públicos ao lado e como propor. (auth: none)
- [`GET /api/metrics`](/llms-full.txt?prefix=%2Fapi%2Fmetrics): Métricas operacionais: sem token, visitas de hoje e uso; com o token do operador, a série de 7 dias. (auth: none)
- [`POST /api/credito`](/llms-full.txt?prefix=%2Fapi%2Fcredito): Recarrega crédito pré-pago: paga uma vez com x402 e recebe o token que desconta em qualquer API da casa. (auth: none)
- [`GET /api/credito`](/llms-full.txt?prefix=%2Fapi%2Fcredito): Saldo e extrato do crédito — as últimas movimentações, sem devolver o token. (auth: credito)
- [`GET /api/credito/pix`](/llms-full.txt?prefix=%2Fapi%2Fcredito%2Fpix): Crédito por Pix: a chave, o câmbio fixo, os pacotes em reais e o que o comprovante aceita. (auth: none)
- [`POST /api/credito/pix`](/llms-full.txt?prefix=%2Fapi%2Fcredito%2Fpix): Pede crédito pago por Pix: multipart com `usd`, `comprovante` (foto ou PDF até 2 MB), `nome` e `email` opcionais. (auth: none)
- [`GET /api/credito/pix/:id`](/llms-full.txt?prefix=%2Fapi%2Fcredito%2Fpix%2F%3Aid): Estado de um pedido de crédito por Pix: `pendente`, `liberado` ou `recusado`. (auth: none)
- [`GET /api/acesso`](/llms-full.txt?prefix=%2Fapi%2Facesso): Discover the monthly data package or inspect a private purchase. (auth: none)
- [`POST /api/acesso`](/llms-full.txt?prefix=%2Fapi%2Facesso): Buy 1000 basic data reads for US$1, valid for 30 days. (auth: none)
- [`GET /api/pricing`](/llms-full.txt?prefix=%2Fapi%2Fpricing): Preços vigentes e franquias gratuitas. (auth: none)
- [`GET /api/billing`](/llms-full.txt?prefix=%2Fapi%2Fbilling): Descoberta pública de pagamento e crédito pré-pago. (auth: none)