compras_healthcheck
Probe real upstream routes of Compras.gov.br to detect silent API breakages. Returns per-module status (ok/degraded/fora) in ~30 seconds, preventing surprises during demonstrations or process execution.
Instructions
Diz, em ~30 segundos, o que está de pé neste servidor agora.
Estende compras_versao: além de versão e configuração, dispara um
probe paralelo (timeout curto) contra as rotas upstream reais e
devolve a situação por módulo funcional.
Por que existe: em 04/08/2026 a tool de pesquisa de preço de material estava quebrada havia semanas e ninguém sabia — a SEGES trocou a assinatura da rota sem versionar. A descoberta veio de um analista tentando usar a ferramenta. Antes de uma demonstração ou de instruir processo, rode isto: o objetivo é que a descoberta aconteça aqui, não no palco.
Args:
profundidade: basico responde só versão/config (instantâneo);
rotas (padrão) executa o probe upstream.
modulo: restringe o probe a um módulo (ex.: pesquisa_preco,
atas, pncp). Sem isso, testa todos.
Situação por módulo:
- ok: todas as rotas responderam com os campos esperados.
- degradado: alguma rota caiu, ou respondeu 200 sem os campos
do contrato (ex.: rota de preço sem precoUnitario) — o modo de
falha silencioso que só o contrato de campos pega.
- fora: todas as rotas testáveis do módulo falharam.
- pulado: faltou credencial (ex.: TRANSPARENCIA_API_KEY).
Rota que estoura o relógio é reexecutada em série antes de virar
fora: com dezenas de rotas em paralelo, uma rota apenas lenta seria
reportada como quebrada. Quando passa na segunda tentativa, o campo
problemas do módulo registra "lenta sob carga" em vez de escondê-lo.
O campo pronto_para_uso é o resumo honesto: False quando existe
qualquer módulo fora ou degradado.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| modulo | No | Restringe o probe a um módulo funcional: 'pesquisa_preco', 'catalogo', 'organizacoes', 'atas', 'contratacoes', 'contratos', 'fornecedores', 'indicadores', 'legado', 'planejamento', 'pncp', 'sancoes', 'comprasnet', 'enriquecimento'. Sem valor, testa todos. | |
| profundidade | No | 'rotas' (padrão) testa as rotas upstream reais em paralelo e devolve situação por módulo (ok/degradado/fora) em ~30s. 'basico' devolve só versão e configuração, sem tocar a rede. | rotas |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||