API e MCP para agentes
O acervo pode ser pesquisado, lido e citado por programas e agentes de IA. Tudo é público, sem autenticação e somente leitura, com as mesmas regras de publicação das páginas do site.
Regras de leitura
- Investigação não é acusação; ser réu não é condenação; "cabe recurso" indica condenação ainda não definitiva; notícia não é prova.
- Cada registro traz
status_editorialeem_revisao. Registros em revisão podem conter erros. - Cite a
urlcanônica do registro e as fontes (/sources). - Preferências de uso (Content Signals):
search=yes, ai-input=yes, ai-train=no.
API HTTP
Descrição OpenAPI 3.1: /api/v1/openapi.json. Catálogo (RFC 9727): /.well-known/api-catalog.
GET /api/v1/search?q=&type=&lang=&sort=&page=&per_page=- Busca. Todas as palavras precisam aparecer.
type: pessoa, processo, noticia, dossie, fonte.lang: 64 idiomas (padrão pt).sort: relevance ou date.per_page: até 50. GET /api/v1/records/{tipo}/{id}?lang=- Registro completo pelo identificador estável. 404 se inexistente ou não publicado.
GET /api/v1/records/{tipo}/{id}/sources- Fontes citadas pelo registro, com URL, veículo, datas e limitações.
GET /api/v1/categories- Tipos de registro (com totais), temas e idiomas.
GET /api/v1/health- Situação da API.
Exemplo:
curl "https://bolsonaros.com/api/v1/search?q=Banco+Master&type=noticia"
curl "https://bolsonaros.com/api/v1/records/pessoa/jair-bolsonaro?lang=en"
curl "https://bolsonaros.com/api/v1/records/pessoa/jair-bolsonaro/sources"Erros vêm em JSON: {"erro":{"codigo":"…","mensagem":"…"}} (400 parâmetro inválido, 404 não encontrado, 429 limite de requisições com Retry-After). Respostas podem ficar em cache por até 5 minutos.
Servidor MCP
Endereço: https://bolsonaros.com/mcp (Streamable HTTP, sem sessão, respostas JSON, sem autenticação). Server Card: /.well-known/mcp/server-card.json.
Ferramentas (todas somente leitura): search_public_content, get_public_record, get_public_sources, list_public_categories.
Markdown
Qualquer página responde em Markdown quando o pedido traz Accept: text/markdown:
curl -H "Accept: text/markdown" https://bolsonaros.com/jair-bolsonaro/Descoberta
- /llms.txt — índice do site para modelos de linguagem.
- /.well-known/agent-skills/index.json — instruções para agentes (Agent Skills).
- /.well-known/ai-catalog.json — catálogo ARD.
- /auth.md — autenticação (nenhuma é necessária).
- /robots.txt e /sitemap.xml.