# EditalMD

> Pesquise licitações e leia Markdown paginado, confira PDFs e consulte /api/documento/:id/dossie: itens, exigências, atestados, prazos, condições e obrigações com evidências. Baixe ZIP MD+imagens e JSON completo. API e MCP entregam os mesmos resultados.
> Acervo: listas trazem até 20 compras com itens[].dados (objeto, órgão, valor e datas). Acesso documental e evidências têm autorização própria; confira os exemplos antes de comprar.
>
> Cada comprador paga $0.02 por página pelo próprio acesso, inclusive ao texto pronto, via x402/crédito ou depósito USDC. Geração necessária incluída. Cinco exemplos livres; piloto individual oferece um premium e 100 básicos até 50 páginas com X-Agent-Pass (/api/avaliacao, guia /avaliacao.md), sujeito a validade, capacidade e orçamento. Básico não revisado; premium não equivale a aprovação de fidelidade. Conta opcional em /conta/global; /api/me/documentos e /compras são privados. Compra autenticada vincula automaticamente; a anônima pode ser vinculada em POST /api/documento/:id/vincular com sessão e X-Editalmd-Acesso. Depois do vínculo só a conta abre. Sem vínculo, guarde acesso.codigo. GET nunca inicia geração.
>
> **Segundo andar:** prazos de proposta e impugnação em toda ficha (grátis), alerta de compra nova por termos e UF ou pelo **CNPJ** da empresa (cada CNAE vira uma família de termos; dicionário em `/api/cnaes`), vigia de mudanças na compra — alertas e vigias são da sua conta, ou de um convidado `edm_…` criado sem cadastro (`POST /api/dono`). 1º alerta e 1ª vigia grátis; extra $0.10 por alerta (30 dias) e $0.05 por vigia; habilitação e dossiê incluídos no acesso documental.



**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.editalmd.com/api/partners` — espaços, preço sugerido, carteira e os campos da proposta.
- [Enviar proposta](https://staging.editalmd.com/parceria) — a mesma oferta para gente, com o formulário.
- `GET https://staging.editalmd.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.

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


**Pagamento — duas portas, escolha a sua**

- **Por requisição (x402), nas operações cobradas:** HTTP 402 com `accepts[]`. Pague e repita com `X-PAYMENT`.
- **Crédito pré-pago:** `POST https://staging.editalmd.com/api/credito?usd=10` (pacotes 1, 5, 10, 25) → devolve um token `cred_…` **uma única vez**.
  Depois é só mandar `Authorization: Bearer cred_…` nas rotas pagas — **o mesmo token vale em todos os produtos da casa**.
  Saldo e extrato: `GET https://staging.editalmd.com/api/credito` com o token. Serve para quem usa todo dia e não quer assinar cada chamada.
- Documento inexistente (404) ou sem texto nem binário (409) não cobra. Preparação do texto responde 202 com `Retry-After`.
- Pagamento devolve `pagamento.recibo` e `acesso.codigo` privado. Use o código em `X-Editalmd-Acesso` ou `acesso_codigo` nas tools MCP. Depois do 202 acompanhe por GET. O comprador reabre sem nova cobrança; outro cliente precisa comprar o próprio acesso.

**Webhook assinado (alertas e vigias)**

- Todo POST do webhook leva `webhook-id`, `webhook-timestamp` (segundos Unix) e `webhook-signature: v1,<base64>`: HMAC-SHA256 de `id.timestamp.corpo` com a chave do seu `whsec_…` (o base64 depois do prefixo). É o padrão Standard Webhooks — qualquer biblioteca dele confere; rejeite timestamp fora de 5 minutos. Depois de `POST /api/dono/segredo`, o anterior ainda assina por 24 h (duas partes `v1,` no cabeçalho).
- O `id` da entrega vai no cabeçalho `webhook-id` e no corpo, para deduplicar; o corpo ainda traz `alerta_url`/`vigia_url` para conferir por pull.
- Em Node: `chave = Buffer.from(segredo.slice(6), "base64")`; `esperada = createHmac("sha256", chave).update(`${id}.${ts}.${corpoBruto}`).digest("base64")`; compare com `timingSafeEqual` contra cada parte `v1,` do cabeçalho.

**Cota**

- Grátis: piloto documental individual — 1 premium e 100 básicos até 50 páginas; X-Agent-Pass; validade/capacidade em /api/avaliacao.
- Grátis: busca e ficha da compra — sem cota.
- Grátis: cinco exemplos e consulta de estado/cotação — sem cota.
- Grátis: licitações salvas e prévia de interesses — 200 salvas por dono; prévia de até 20 compras em 7 dias.
- 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: acesso individual ao documento, por página; inclui geração necessária — **$0.02** USDC via x402.
- Pago: habilitação e dossiê incluídos no acesso ao documento — **$0.00** USDC via x402.
- Pago: alerta além do 1º (30 dias) — **$0.10** USDC via x402.
- Pago: vigia além da 1ª — **$0.05** USDC via x402.

Cada comprador paga $0.02 por página pelo próprio acesso, inclusive ao texto pronto, via x402/crédito ou depósito USDC. Geração necessária incluída. Cinco exemplos livres; piloto individual oferece um premium e 100 básicos até 50 páginas com X-Agent-Pass (/api/avaliacao, guia /avaliacao.md), sujeito a validade, capacidade e orçamento. Básico não revisado; premium não equivale a aprovação de fidelidade. Conta opcional em /conta/global; /api/me/documentos e /compras são privados. Compra autenticada vincula automaticamente; a anônima pode ser vinculada em POST /api/documento/:id/vincular com sessão e X-Editalmd-Acesso. Depois do vínculo só a conta abre. Sem vínculo, guarde acesso.codigo. GET nunca inicia geração.

Números em vigor: https://staging.editalmd.com/api/

## Descoberta

- [Avaliação documental](https://staging.editalmd.com/avaliacao.md): um premium patrocinado e 100 básicos por agente, até 50 páginas; texto básico sem revisão, premium com artefatos e evidências quando preparados.
- [Minhas empresas](https://staging.editalmd.com/conta?aba=empresas): importe CNPJ ou pesquise razão social, até 20 empresas por conta. Anexe atestados e comprovantes PDF em /api/me/empresas/:cnpj/documentos. Por solicitação explícita, analisar_participacao compara exigências com perfil/anexos; consultar_participacao lê Pendências e Atendidos com motivos, ações e evidências. Selecionar empresa ou consultar não inicia IA.
- [Exemplos / Examples](https://staging.editalmd.com/exemplos): cinco provas prontas gratuitas. [Links e hashes na API](https://staging.editalmd.com/api/exemplos); tool MCP exemplos.
- [Salvas](https://staging.editalmd.com/?painel=salvas) e [Alertas](https://staging.editalmd.com/?painel=alertas): código de acesso exportável, recuperação em outro navegador. API: /api/salvas; /api/alertas/previa testa filtros sem criar.
- [Integrações](https://staging.editalmd.com/developers): comece pelo índice, leia só a família necessária em /llms-full.txt?prefix=/api/... e chame HTTP/MCP. A UI é para pessoas; não raspe a tela.
- [Índice da API](https://staging.editalmd.com/api/)
- [llms-full.txt](https://staging.editalmd.com/llms-full.txt)
- [OpenAPI](https://staging.editalmd.com/openapi.json)
- [MCP](https://staging.editalmd.com/mcp)
- [Guia de valor, compra e recuperação](https://staging.editalmd.com/api-access-guide.md): metadados, dossiê e capacidade são entregas distintas.

## 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/avaliacao`](/llms-full.txt?prefix=%2Fapi%2Favaliacao): Cotas documentais deste agente: um premium patrocinado e 100 leituras básicas. (auth: agente)
- [`POST /api/documento/:id/avaliacao/premium`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Favaliacao%2Fpremium): Concede um documento premium por agente; gera se necessário, sem cobrar o agente. (auth: agente)
- [`POST /api/documento/:id/avaliacao/basico`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Favaliacao%2Fbasico): Enfileira uma leitura básica individual: texto nativo e OCR local, sem revisão. (auth: agente)
- [`GET /api/documento/:id/avaliacao/basico`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Favaliacao%2Fbasico): Recupera estado e texto básico por página, somente para o agente que solicitou. (auth: agente)
- [`GET /api/me/empresas/:cnpj/documentos`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj%2Fdocumentos): Lista os anexos privados da empresa; não inicia leitura ou análise. (auth: owner)
- [`POST /api/me/empresas/:cnpj/documentos`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj%2Fdocumentos): Adiciona PDF de atestado, certidão ou outro comprovante à empresa. (auth: owner)
- [`GET /api/me/empresas/:cnpj/documentos/:arquivo`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj%2Fdocumentos%2F%3Aarquivo): Baixa o PDF privado, sem chamada de IA. (auth: owner)
- [`DELETE /api/me/empresas/:cnpj/documentos/:arquivo`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj%2Fdocumentos%2F%3Aarquivo): Remove o anexo desta empresa e invalida a análise que o utilizou. (auth: owner)
- [`POST /api/me/empresas/:cnpj/analises/:id`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj%2Fanalises%2F%3Aid): Inicia ou retoma comparação de requisitos, atestados e obrigações com a empresa. (auth: owner)
- [`GET /api/me/empresas/:cnpj/analises/:id`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj%2Fanalises%2F%3Aid): Consulta andamento ou resultados paginados; não inicia IA nem modifica a análise. (auth: owner)
- [`GET /api/me/empresas`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas): Lista as empresas importadas e a seleção privada do dono; GET não grava. (auth: owner)
- [`GET /api/me/empresas/busca`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2Fbusca): Busca até oito sugestões por razão social ou CNPJ completo; não cadastra. (auth: owner)
- [`PUT /api/me/empresas/:cnpj`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj): Importa os dados cadastrais e vincula o CNPJ ao dono. (auth: owner)
- [`PUT /api/me/empresas/:cnpj/selecionar`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj%2Fselecionar): Seleciona uma empresa já cadastrada para trabalhar no edital. (auth: owner)
- [`DELETE /api/me/empresas/:cnpj`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fempresas%2F%3Acnpj): Remove somente o vínculo do próprio dono e limpa a seleção se necessário. (auth: owner)
- [`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)
- [`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)
- [`POST /api/auth/claim`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fclaim): Passa para a conta o que o convidado criou: as Salvas, os Alertas e as Vigias que a conta ainda não tem (uma lista de cada por conta), o segredo do webhook se ela ainda não tem um, e as compras do convidado. (auth: session)
- [`GET /api/me`](/llms-full.txt?prefix=%2Fapi%2Fme): Identifica sua conta, conta seus acessos e acompanhamentos e aponta biblioteca e histórico. (auth: session)
- [`GET /api/me/documentos`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fdocumentos): Documentos comprados por esta conta; reabertura sem novo pagamento. (auth: session)
- [`GET /api/me/compras`](/llms-full.txt?prefix=%2Fapi%2Fme%2Fcompras): Histórico privado das aquisições, mais recentes primeiro. (auth: session)
- [`POST /api/documento/:id/vincular`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fvincular): Associa sua aquisição anônima à conta autenticada, sem nova cobrança. (auth: session)
- [`GET /api/documento/:id/acesso`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Facesso): Confere vínculo e permite exportar o código da aquisição ainda anônima. (auth: acesso)
- [`GET /api/me/acompanhamento`](/llms-full.txt?prefix=%2Fapi%2Fme%2Facompanhamento): Confere que Salvas/Alertas/Vigias são da conta da sessão. (auth: session)
- [`GET /api/health`](/llms-full.txt?prefix=%2Fapi%2Fhealth): Saúde da origem e tamanho do acervo. (auth: none)
- [`POST /mcp`](/llms-full.txt?prefix=%2Fmcp): MCP Streamable HTTP — as tools deste catálogo, despachadas neste mesmo Worker. (auth: none)
- [`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: acesso)
- [`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: `documento` (Documento do acervo). Via de acesso para quem já tem o id, não catálogo. (auth: acesso)
- [`GET /feed.xml`](/llms-full.txt?prefix=%2Ffeed.xml): RSS 2.0 das compras publicadas mais recentemente no acervo. (auth: none)
- [`GET /feed.json`](/llms-full.txt?prefix=%2Ffeed.json): JSON Feed 1.1 das compras publicadas mais recentemente — o mesmo stream do RSS. (auth: none)
- [`GET /api/busca`](/llms-full.txt?prefix=%2Fapi%2Fbusca): Busca compras públicas por termo. Consulta grátis. (auth: none)
- [`GET /api/cnaes`](/llms-full.txt?prefix=%2Fapi%2Fcnaes): Atividades econômicas (CNAE), descrições e sugestões de termos para alertas. Grátis. (auth: none)
- [`GET /api/compra/:id`](/llms-full.txt?prefix=%2Fapi%2Fcompra%2F%3Aid): Ficha da compra com prazos de proposta e impugnação, documentos e o regime de cobrança de cada um. (auth: none)
- [`GET /api/documento/:id`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid): Título, tipo, páginas e compra vinculada ao documento. Consulta pública, sem iniciar extração. (auth: none)
- [`GET /api/documento/:id/markdown`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fmarkdown): Markdown com procedência e hash, com acesso comprado ou premium patrocinado. Cinco exemplos gratuitos. (auth: acesso)
- [`POST /api/documento/:id/habilitacao`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fhabilitacao): Lista de habilitação com trechos literais. Exige acesso ao documento comprado; sem cobrança adicional nesta fase. (auth: acesso)
- [`POST /api/dono`](/llms-full.txt?prefix=%2Fapi%2Fdono): Cria o convidado (token edm_…) que abre alertas e vigias, e o segredo que assina os webhooks. Sem cadastro. (auth: none)
- [`GET /api/dono`](/llms-full.txt?prefix=%2Fapi%2Fdono): O estado do dono: conta ou convidado, e-mail dos avisos, franquia e o segredo que assina os webhooks. (auth: owner)
- [`POST /api/dono/segredo`](/llms-full.txt?prefix=%2Fapi%2Fdono%2Fsegredo): Rotaciona o segredo do webhook. O anterior ainda assina por 24 h, para trocar sem janela de falha. (auth: owner)
- [`GET /api/documento/:id/geracao`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fgeracao): Estado, cotação e direito de acesso; consulta gratuita, sem iniciar processamento. (auth: none)
- [`POST /api/documento/:id/geracao`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fgeracao): Compra acesso individual ao documento por US$ 0,02/página, via x402/crédito. (auth: none)
- [`GET /exemplos`](/llms-full.txt?prefix=%2Fexemplos): Galeria de cinco documentos reais já processados: leitura, original, Markdown e ZIP gratuitos. (auth: none)
- [`GET /api/exemplos`](/llms-full.txt?prefix=%2Fapi%2Fexemplos): Cinco exemplos prontos, com procedência, páginas, imagens, SHA-256 e links de leitura e download. (auth: none)
- [`POST /api/documento/:id/cobranca`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fcobranca): Reserva endereço/QR exclusivo para comprar seu acesso com USDC na Base. (auth: cobranca)
- [`GET /api/documento/:id/cobranca`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fcobranca): Consulta endereço, confirmação, recibo e liberação da sua cobrança gratuitamente. (auth: cobranca)
- [`POST /api/cobranca/:id/registrar`](/llms-full.txt?prefix=%2Fapi%2Fcobranca%2F%3Aid%2Fregistrar): Operação interna para registrar transferência confirmada no razão financeiro. (auth: origem)
- [`GET /api/documento/:id/dossie`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fdossie): Dados estruturados: exigências, itens, atestados, prazos, condições e evidências por página. (auth: acesso)
- [`GET /licitacoes/`](/llms-full.txt?prefix=%2Flicitacoes%2F): Navegação pública do acervo por modalidade, UF, data e município. (auth: none)
- [`GET /licitacoes/compra/:id/`](/llms-full.txt?prefix=%2Flicitacoes%2Fcompra%2F%3Aid%2F): Ficha pública com documentos em modo de leitura: Markdown paginado, original e arquivos. (auth: none)
- [`GET /api/documento/:id/original`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Foriginal): Baixar o original preservado, com o acesso comprado. (auth: acesso)
- [`GET /api/documento/:id/partes`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fpartes): Arquivos internos disponíveis no documento comprado. (auth: acesso)
- [`GET /api/documento/:id/partes/:partId/arquivo`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fpartes%2F%3ApartId%2Farquivo): Abrir ou baixar uma peça original com o acesso comprado ao documento. (auth: acesso)
- [`GET /api/documento/:id/leitura`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fleitura): Manifesto do documento comprado: páginas físicas, imagens e hashes da extração atual. (auth: acesso)
- [`GET /api/documento/:id/pacote`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fpacote): Baixar ZIP com Markdown e imagens do documento comprado para leitura fora do site. (auth: acesso)
- [`GET /api/documento/:id/imagens/:version/:imageSha`](/llms-full.txt?prefix=%2Fapi%2Fdocumento%2F%3Aid%2Fimagens%2F%3Aversion%2F%3AimageSha): Imagem PNG/JPEG do documento comprado, conferida por hash. (auth: acesso)
- [`GET /api/precos`](/llms-full.txt?prefix=%2Fapi%2Fprecos): O preço que ganha para um item parecido: mediana, quartis, desconto sobre a referência, quem vence e quem compra. Grátis. (auth: none)
- [`POST /api/alertas/previa`](/llms-full.txt?prefix=%2Fapi%2Falertas%2Fprevia): Testa termos e filtros ou sugere termos pelo CNPJ, sem criar alerta. (auth: none)
- [`GET /api/salvas`](/llms-full.txt?prefix=%2Fapi%2Fsalvas): Lista até 200 licitações salvas pelo dono, gratuitamente. (auth: owner)
- [`GET /api/salvas/:id`](/llms-full.txt?prefix=%2Fapi%2Fsalvas%2F%3Aid): Consulta uma licitação salva pelo dono. (auth: owner)
- [`PUT /api/salvas/:id`](/llms-full.txt?prefix=%2Fapi%2Fsalvas%2F%3Aid): Salva a licitação gratuitamente; repetir não duplica. (auth: owner)
- [`DELETE /api/salvas/:id`](/llms-full.txt?prefix=%2Fapi%2Fsalvas%2F%3Aid): Remove a licitação da lista pessoal; repetir é seguro. (auth: owner)
- [`POST /api/alertas`](/llms-full.txt?prefix=%2Fapi%2Falertas): Cria alertas de compra nova: por termos do objeto e UF, ou pelo CNPJ da empresa (um alerta por família de atividade), entregues por pull, webhook ou e-mail. (auth: owner)
- [`GET /api/alertas`](/llms-full.txt?prefix=%2Fapi%2Falertas): Lista os alertas deste dono, os mais novos primeiro. (auth: owner)
- [`GET /api/alertas/:id`](/llms-full.txt?prefix=%2Fapi%2Falertas%2F%3Aid): Um alerta do dono, com os filtros e a data da última verificação. (auth: owner)
- [`GET /api/alertas/:id/compras`](/llms-full.txt?prefix=%2Fapi%2Falertas%2F%3Aid%2Fcompras): As compras que já casaram com o alerta — é o canal pull, e a prova do que foi entregue. (auth: owner)
- [`PATCH /api/alertas/:id`](/llms-full.txt?prefix=%2Fapi%2Falertas%2F%3Aid): Pausa, reativa ou muda termos, UF, filtros, canal e destino de um alerta. (auth: owner)
- [`DELETE /api/alertas/:id`](/llms-full.txt?prefix=%2Fapi%2Falertas%2F%3Aid): Apaga o alerta e o histórico de compras casadas. Sem volta. (auth: owner)
- [`POST /api/vigias`](/llms-full.txt?prefix=%2Fapi%2Fvigias): Vigia uma compra: fotografa agora e avisa quando mudar — documento novo, suspensão, prazo adiado, valor — e nos prazos. (auth: owner)
- [`GET /api/vigias`](/llms-full.txt?prefix=%2Fapi%2Fvigias): Lista as vigias deste dono, as mais novas primeiro. (auth: owner)
- [`GET /api/vigias/:id`](/llms-full.txt?prefix=%2Fapi%2Fvigias%2F%3Aid): Uma vigia do dono com a fotografia mais recente da compra. (auth: owner)
- [`GET /api/vigias/:id/eventos`](/llms-full.txt?prefix=%2Fapi%2Fvigias%2F%3Aid%2Feventos): O que mudou na compra vigiada, evento a evento — é a série temporal e o canal pull. (auth: owner)
- [`DELETE /api/vigias/:id`](/llms-full.txt?prefix=%2Fapi%2Fvigias%2F%3Aid): Apaga a vigia e seus eventos. Sem volta. (auth: owner)
- [`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)
- [`POST /api/visit`](/llms-full.txt?prefix=%2Fapi%2Fvisit): Ping da interface que incrementa a visita do dia no painel do operador. Agente não precisa chamar. (auth: none)
- [`POST /api/contact`](/llms-full.txt?prefix=%2Fapi%2Fcontact): Fale com quem faz o produto — de graça, para pessoa e agente. (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 dos últimos 7 dias para o painel do operador; com o token, inclui os pagamentos. (auth: none)
- [`GET /api/recibo/:id`](/llms-full.txt?prefix=%2Fapi%2Frecibo%2F%3Aid): Recibo de uma entrega — a prova de o que saiu, quanto custou e com qual hash. (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)