Criando automações com a API do SereneReader

Por que automatizar sua leitura?

O RSS já reúne conteúdo de várias fontes em um só lugar. A API do SereneReader permite levar esse conteúdo para scripts, cron jobs e outras ferramentas.

A autenticação usa uma única chave de API: crie uma, envie-a em cada requisição HTTP e receba JSON de volta. A API é somente leitura e não possui webhooks, então os scripts a consultam periodicamente conforme uma agenda.

Primeiros passos

O acesso à API está incluído nos planos Pro (US$ 5/mês na versão web) e Team.

Criar uma chave de API

No SereneReader, abra as Configurações e escolha a aba API. Crie uma chave, dê a ela um nome que você reconheça depois, e copie-a em um lugar seguro; ela é exibida apenas uma vez. Contas Pro podem ter até 5 chaves e contas Team, até 10.

Autenticação

Toda requisição precisa da sua chave como token Bearer no cabeçalho Authorization. Não há IDs de cliente, tokens de atualização ou escopos. A aba API nas Configurações lista a URL base, os endpoints e exemplos de requisições.

Limites de taxa

A API permite 30 requisições por minuto por conta, compartilhadas entre todas as suas chaves, o que é mais do que suficiente para scripts executados em uma agenda. Cada resposta inclui um cabeçalho X-RateLimit-Remaining. Se você ultrapassar o limite, a API retorna 429 com um cabeçalho Retry-After; aguarde esse número de segundos antes de tentar novamente.

O que você pode fazer

A API oferece acesso de leitura aos seus artigos e assinaturas:

• GET /api/v1/articles retorna artigos dos seus feeds, do mais recente ao mais antigo. É possível filtrar por feed, pasta ou data de publicação, e navegar pelos resultados (50 por requisição por padrão, até 200). Cada artigo inclui título, URL, nome do feed, autor, data de publicação, um trecho e se você já o leu ou marcou com estrela.
• GET /api/v1/feeds lista suas assinaturas com a contagem de não lidos e as pastas.
• GET /api/v1/usage mostra quantas requisições a chave em uso fez na última hora, nas últimas 8 horas e nas últimas 24 horas.

A aba API nas Configurações tem a lista completa de parâmetros e campos de resposta.

Casos de uso

E-mail de digesto diário

Escreva um script que rode toda manhã às 7h, busque os artigos do dia anterior e envie um e-mail de resumo para você. Filtre por data, processe o JSON com jq para extrair títulos e URLs e envie o resultado com qualquer ferramenta de e-mail ou notificação que preferir.

Verificação de feeds silenciosos

Feeds quebram: domínios expiram, caminhos mudam, servidores ficam fora do ar. A API não reporta erros de busca nem quando um feed publicou pela última vez, mas um script semanal ainda consegue identificar feeds que ficaram silenciosos. Liste seus feeds, solicite artigos recentes de cada um com os parâmetros feedId e since, e sinalize qualquer feed sem publicações nas últimas semanas. Se você tiver muitos feeds, distribua as requisições para não ultrapassar o limite de taxa.

Um feed silencioso nem sempre está quebrado, mas a lista indica quais blogs vale a pena verificar.

Exportar para outras ferramentas

Leve artigos para um banco de dados local, uma página do Notion, um cofre do Obsidian ou uma planilha. A API retorna JSON estruturado, então a transformação geralmente exige apenas algumas linhas de jq ou um script curto em Python.

Combinar com agentes de IA

A API funciona com ferramentas de IA que conseguem fazer requisições HTTP. Se você usa um assistente como o OpenClaw, pode apontá-lo para o SereneReader e fazer com que ele processe seus feeds. Escrevemos um post separado sobre isso: Como conectar seus feeds RSS a agentes de IA.

Mais ideias

Algumas outras coisas que você pode construir em poucas linhas: um cron job que envia por e-mail os artigos do dia de uma pasta específica, um alias de shell que soma as contagens de não lidos de /api/v1/feeds, ou um script de polling que publica novos artigos de um feed em um canal do Slack.

Você não precisa de um framework para nada disso. curl e jq cobrem a maioria dos casos, e qualquer linguagem com um cliente HTTP resolve o restante.

Crie sua chave nas Configurações, na aba API.