# Radar CNPJ

> Consulta, busca por IA e monitoramento anônimo de empresas (Receita Federal).
> Front em https://radar-cnpj.com — proxy fino; origem api.radar-cnpj.com.
> Cliente principal: agente de IA.

## Descoberta

- [Índice da API](https://www.radar-cnpj.com/api/)
- [llms.txt](https://www.radar-cnpj.com/llms.txt): este arquivo
- [OpenAPI](https://www.radar-cnpj.com/openapi.json)
- [Health](https://www.radar-cnpj.com/api/health)
- UI humana: botão **API** no topo + **Hub de recursos para agentes** no rodapé (mesmos links).

## Endpoints principais

- `GET /api/cnpj/:cnpj` — Ficha de empresa (14 dígitos). Cache de borda 6h. (auth: none)
- `GET /api/busca` — Busca por termo e/ou filtros avançados (`q`, `f` JSON). (auth: none)
- `GET /api/sugerir` — Autocomplete de empresas/termos. (auth: none)
- `GET /api/ref` — Referência para seletores (CNAE, município, natureza): `tipo` + `q` ou `codigos`. (auth: none)
- `GET /api/export` — Export CSV/JSON da busca (`format=csv|json` + mesmos params de busca). (auth: none)
- `POST /api/ia` — Texto → filtros normalizados (caminho síncrono ~18–20s). (auth: none)
- `POST /api/ia/jobs` — Enfileira job de IA (quando o síncrono estoura). (auth: none)
- `GET /api/ia/jobs/:id` — Poll do job de IA. (auth: none)
- `GET /api/local` — Cidade/UF do visitante via geo de borda (nunca cachear). (auth: none)
- `GET /api/municipio-proximo` — Município mais próximo de lat/lon (centroide oficial do IBGE; nunca cachear). (auth: none)
- `POST /api/contato` — Contato: Turnstile (humano) ou x402 $0.10 (agente). Alias /api/contact. (auth: none)
- `POST /api/monitor/session` — Cria sessão anônima de monitoramento (uuid). (auth: none)
- `PUT /api/monitor/session/email` — E-mail de alertas da sessão. (auth: session)
- `GET /api/me/monitor` — Watches da sessão (header x-radar-session). (auth: session)
- `POST /api/me/monitor` — Adiciona watch de CNPJ na sessão. (auth: session)
- `DELETE /api/me/monitor/:id` — Remove watch. (auth: session)
- `GET /api/monitor/changes/:cnpj` — Histórico de alterações cadastrais do CNPJ. (auth: session)

## Contato agente

- `POST /api/contato` sem captcha → **HTTP 402** x402 **$0.10** USDC.

## MCP / skill

- Skill: `.agents/skills/radar-cnpj/SKILL.md`
- MCP: `~/src/make-money/scripts/mcp/server.mjs --product radar-cnpj`
- **Paridade:** mexeu na UI/API → apidocs + skill + MCP + este arquivo no mesmo PR.