Pular para o conteúdo
INTEGRAÇÃO COM AGENTES

Conecte O Fôlego ao seu agente

As três formas (MCP, RSS, API) leem os mesmos dados: seleção, Em alta e as notas diárias, a edição semanal e o balanço mensal. Escolha a que combina com a sua ferramenta. Tudo é anônimo e só leitura, sem cadastro e sem API Key.

Serviço normalVersão 1.0.0Anônimo, só leitura · sem key
MCPUm endereço e 7 ferramentas a maisRSSCopie o endereço e assine no seu leitorREST APIGET anônimo para buscar os dados no seu código
REST API · 1.0.0

GET anônimo, pronto para usar

Sem token; dá para chamar direto do navegador (CORS), do curl e do cliente HTTP padrão de qualquer linguagem. O caminho é /api/v1; campos e códigos de erro seguem o OpenAPI.

Primeira requisição
curl --compressed 'https://ofolego.com/api/v1/items?mode=selected&window=24h&limit=20'

Mais leve e mais rápido

  1. 01
    Ative a compressão

    No curl use --compressed; em outros clientes, ative gzip ou br. Comprimido, o JSON fica com 1/4 a 1/8 do tamanho.

  2. 02
    Envie o ETag

    Guarde o ETag da resposta e envie-o depois em If-None-Match; se nada mudou, a resposta é 304, sem corpo.

  3. 03
    Respeite o ritmo

    Notícias e Em alta: no máximo uma vez por minuto; as notas diárias, uma vez depois das 07:00; semanal e mensal, uma vez depois que saem. Ao voltar páginas, pare quando chegar a um item que você já tem.

Com que frequência o conteúdo muda: notícias novas chegam ao longo do dia, a seleção muda de algumas a dezenas de vezes por dia, e há notas diárias todos os dias às 07:00, a edição semanal toda segunda-feira às 07:00 e o balanço mensal todo dia 1º às 07:30 (horário de Brasília).

Endpoints

CaminhoPara que serveFrequência
Notícias
/api/v1/itemsSeleção ou todas as notícias dos últimos 7 dias, com filtro por categoria, janela de tempo e palavra-chaveNo máximo 1 vez por minuto
Em alta e eventos
/api/v1/hot-topicsTop 10 de Em alta agoraNo máximo 1 vez por minuto
/api/v1/stories/{publicId}Linha do tempo das notícias de um evento, panorama gerado por IA e eventos relacionadosQuando precisar
Notas diárias
/api/v1/dailies/latestEdição mais recente das notas diáriasUma vez, depois da publicação (todos os dias às 07:00)
/api/v1/dailies/{date}Notas diárias de uma data; itens retirados saem das citaçõesRevalide o ETag quando o cache expirar
/api/v1/dailiesÍndice de datas das notas diáriasUma vez por dia
Edições semanal e mensal
/api/v1/weeklies/latestEdição mais recente do semanal: manchete, panorama e destaques da semana por seçãoUma vez, depois da publicação (toda segunda-feira às 07:00)
/api/v1/weeklies/{week}Uma semana, em semana ISO como 2026-W39; itens retirados saem das citaçõesRevalide o ETag quando o cache expirar
/api/v1/weekliesÍndice da edição semanalUma vez por semana
/api/v1/monthlies/latestEdição mais recente do mensalUma vez, depois da publicação (todo dia 1º às 07:30)
/api/v1/monthlies/{month}Um mês, como 2026-09Revalide o ETag quando o cache expirar
/api/v1/monthliesÍndice do balanço mensalUma vez por mês
Para assistentes de IA
/api/v1/agentGuia de uso para agentes; os endereços listados devolvem Markdown em português pronto para usoQuando precisar
Sincronização completa da seleção
/api/v1/selected/snapshotToda a seleção atual, baixada uma vez por paginaçãoSó na primeira vez
/api/v1/selected/changesInclusões, alterações e retiradas desde entãoA cada poucos minutos

Usos comuns

bash
# Primeira vez: guarde o ETag do cabeçalho da resposta
curl --compressed -i 'https://ofolego.com/api/v1/items?mode=selected&window=24h&limit=20'
# Depois, no máximo uma vez por minuto, com o ETag; 304 significa que nada mudou
curl --compressed -i -H 'If-None-Match: <ETag anterior>' 'https://ofolego.com/api/v1/items?mode=selected&window=24h&limit=20'

Para voltar páginas, envie page.nextCursor como cursor e pare ao chegar a um item que você já tem; não releia os 7 dias inteiros a cada vez.

Deu erro?

400
Parâmetro inválido: corrija conforme o OpenAPI e o code devolvido, sem trocar automaticamente por uma consulta mais ampla. Cursor inválido ou fora da janela devolve invalid_cursor; recomece pela primeira página.
409
snapshot_required: não é seguro continuar de forma incremental; baixe o snapshot completo de novo.
429
Requisições demais: aguarde o Retry-After e não repita em paralelo.
5xx
Use espera exponencial e, enquanto isso, o último resultado bem-sucedido; o serviço público não tem SLA.

Poder chamar sem cadastro não significa que todo uso esteja autorizado; veja os Termos de uso.