Criando automações com a API do SereneReader

Por que automatizar a sua leitura?

O RSS já resolve a parte difícil: reunir conteúdo de centenas de fontes em um único lugar. A API do SereneReader permite que você acesse esse conteúdo via scripts, cron jobs e outras ferramentas de forma programática.

Sem webhooks para configurar. Sem fluxo OAuth. Gere uma chave de API, faça requisições HTTP e receba JSON de volta.

Primeiros passos

O acesso à API está incluído no plano Pro por $5/mês — sem necessidade de um plano enterprise. A maioria dos leitores RSS concorrentes restringe o acesso à API a planos mais caros ou de nível superior.

Crie uma chave de API

Acesse a página de configurações do SereneReader e role até a seção de API. Crie uma nova chave, dê a ela um nome que você reconhecerá depois e guarde-a em um lugar seguro. A chave é exibida apenas uma vez.

Autenticação

Cada requisição precisa de um token Bearer no cabeçalho Authorization. Só isso. Sem client IDs, sem refresh tokens, sem escopos. A página de configurações da API contém a URL base, a documentação dos endpoints e exemplos de requisições.

Limites de requisições

A API permite 30 requisições por minuto por conta. Mais do que suficiente para scripts que rodam em agendamento. Se você atingir o limite, aguarde alguns segundos antes de tentar novamente.

O que você pode fazer

A API oferece acesso de leitura aos seus artigos e assinaturas. Filtre artigos por feed, pasta ou data de publicação. Liste suas assinaturas com as contagens de não lidos. Todas as respostas são JSON com títulos, URLs, datas de publicação, trechos e metadados do feed.

A lista completa de endpoints, parâmetros e estruturas de resposta está na seção de documentação da API na sua página de configurações.

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 a você um e-mail com o resumo. Filtre por data, processe o JSON com jq para extrair títulos e URLs, e envie o resultado para o sistema de notificação de sua preferência.

Os dados estão disponíveis em um formato limpo, prontos para serem moldados da forma que você quiser.

Monitor de saúde de feeds

Feeds param de funcionar. Domínios expiram, caminhos mudam, servidores ficam fora do ar. Um script semanal pode listar suas assinaturas e verificar quais não publicam há algum tempo.

Quando um feed ficar silencioso, você saberá disso antes de começar a se perguntar por que aquele blog parou de aparecer.

Exportar para outras ferramentas

Importe artigos para um banco de dados local, uma página do Notion, um vault do Obsidian ou uma planilha. A API fornece dados estruturados, então a etapa de transformação geralmente é apenas algumas linhas de jq ou um pequeno script Python.

Combinar com agentes de IA

A API se integra bem com ferramentas de IA que fazem requisições HTTP. Se você estiver usando um framework de agentes como o OpenClaw, pode apontá-lo para o SereneReader e deixá-lo processar seus feeds de forma autônoma. Escrevemos um post separado sobre isso: Como conectar seus feeds RSS a agentes de IA.

Mantenha a simplicidade

As melhores automações são scripts curtos que fazem uma coisa só. Um cron job que roda uma vez por dia. Um alias de shell que exibe sua contagem de não lidos. Um relay de webhook que encaminha artigos para um canal do Slack.

Você não precisa de um framework para isso. curl e jq cobrem a maioria dos casos. Se precisar de algo mais estruturado, qualquer linguagem com um cliente HTTP funcionará.

As chaves de API e a documentação dos endpoints estão nas configurações do SereneReader.