/api/auth/bootstrap

Prepara o navegador para entrar na conta global.

/api/auth/login

Inicia a entrada global; abra o redirect neste navegador.

/api/auth/callback

Callback do backend para entrada global.

/api/account/profile

Consulta seu perfil global.

/api/account/avatar

Consulta sua foto de perfil global.

/api/me

Lê a conta global atual neste produto.

/api/auth/logout

Revoga esta sessão do produto.

/api/vitrine/operador

O documento completo do produto no painel do operador — só com o token do operador.

• Authorization (header, required) — `Bearer ` — a classe operador.

/api/vitrine/painel

O painel da casa inteira, na forma que o gm lê — só com o token do operador.

• Authorization (header, required) — `Bearer ` — a classe operador.

/okf/{arquivo}

Bundle OKF (Open Knowledge Format v0.1): markdown com frontmatter para o agente ler o produto inteiro sem parsear HTML.

• arquivo (path, required) — `index.md`, `sobre.md`, `api.md` ou `faq.md`.

/.well-known/{arquivo}

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).

• arquivo (path, required) — `api-catalog`, `security.txt`, `x402`, `agent-card.json`, `mcp-registry-auth` ou `apis.json`.

/apis.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`.

/agent.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`.

/okf/{tipo}/{id}.md

O mesmo registro que a API responde, em markdown OKF: `cep` (Endereço do CEP no CNEFE 2022). Via de acesso para quem já tem o id, não catálogo.

• tipo (path, required) — Um de: `cep`.
• id (path, required) — O id do registro, como a API o aceita.

/api/

Índice auto-descrito: cada rota, o que cobra e como plugar o MCP.

/api/health

Saúde da origem sqlite e cobertura por UF.

/mcp

MCP Streamable HTTP — as tools deste catálogo, despachadas neste mesmo Worker.

/api/cep/{cep}

Pontos CNEFE de um CEP, com lat/lon IBGE — não é chute de mapa.

• cep (path, required) — 8 dígitos, com ou sem hífen.

/api/cep/{cep}/unidades

Unidades CNEFE de um CEP, com complemento, espécie e id — paginado.

• cep (path, required) — 8 dígitos, com ou sem hífen.
• logradouro (query) — Logradouro exatamente como no lookup (tipo + nome).
• numero (query) — Número do edifício no CNEFE.
• limit (query, limit) — Itens por página, teto 50.
• offset (query, offset) — Deslocamento 0-based.

/api/proximo

Ponto CNEFE mais perto de um par lat/lon. Sem default para (0,0).

• lat (query, required) — Latitude WGS84, −90 a 90.
• lon (query, required) — Longitude WGS84, −180 a 180.

/api/buscar

Busca textual de logradouro (FTS5), com UF e cidade opcionais.

• q (query, required) — Termo com 3+ caracteres.
• uf (query) — Restringe a uma UF.
• cidade (query) — Trecho do município.

/api/empresas

Estabelecimentos da Receita neste CEP (join no c3, teto 50).

• cep (query, required) — 8 dígitos, com ou sem hífen.
• page (query, page) — Página 0-based da origem CNPJ (50 por página).

/api/raio

CEPs a N metros de um ponto, com distância e quantos endereços CNEFE cada um tem — raio em metros, não bairro em texto.

• cep (query) — Centro = média dos pontos deste CEP. Alternativa a lat/lon.
• lat (query) — Latitude do centro, se não vier `cep`.
• lon (query) — Longitude do centro, se não vier `cep`.
• raio (query) — Raio em metros, 1 a 2000.

/api/vizinhanca

Empresas ativas, abertas e baixadas num raio em metros, por CNAE, com as aberturas mais recentes e a distância de cada uma — o CNEFE dá o raio, a Receita dá o fato.

• cep (query) — Centro = média dos pontos deste CEP. Alternativa a lat/lon.
• lat (query) — Latitude do centro, se não vier `cep`.
• lon (query) — Longitude do centro, se não vier `cep`.
• raio (query) — Raio em metros, 1 a 2000.
• cnae (query) — Prefixo de CNAE: divisão (2 dígitos), classe (5) ou subclasse (7).
• desde (query) — Data ISO para “abriu/baixou desde”. Padrão: 90 dias antes da data da base (`base.dump_date`).

/api/local

Cidade/UF de quem chama, pela borda Cloudflare. Sem cache.

/api/contact

Contato: humano com Turnstile (grátis) ou agente com x402 $0.10.

/api/erro-cliente

Relato de erro do navegador, enviado pela própria interface. Agente não precisa chamar.

/api/vitrine

Os números públicos do produto: tráfego, agentes, uso e confiabilidade, sem dinheiro.

/api/vitrine/cursores

O cursor de erro resolvido por produto (`borda`, `cli`) — só com o token do operador.

• Authorization (header, required) — `Bearer ` — a classe operador.

/api/partners

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.

/api/visit

Ping da interface que soma a visita do dia. Agente não precisa chamar.

/api/metrics

Métricas dos últimos 7 dias para o painel do operador; com o token, inclui os pagamentos.

• Authorization (header) — `Bearer ` para incluir o bloco financeiro; token errado é 401.

/api/credito

Saldo e extrato do crédito — as últimas movimentações, sem devolver o token.

/api/credito

Recarrega crédito pré-pago: paga uma vez com x402 e recebe o token que desconta em qualquer API da casa.

• usd (query, required) — Pacote: 1, 5, 10 ou 25 dólares.

/api/pricing

Preços vigentes e franquias gratuitas.

/api/billing

Descoberta pública de pagamento e crédito pré-pago.