Costruire automazioni con le API di SereneReader

Perché automatizzare la lettura?

RSS risolve già la parte difficile: raccogliere contenuti da centinaia di fonti in un unico posto. Le API di SereneReader ti permettono di portare quei contenuti in script, cron job e altri strumenti in modo programmatico.

Nessun webhook da configurare. Nessun processo OAuth complicato. Genera una chiave API, fai richieste HTTP, ricevi JSON in risposta.

Per iniziare

L'accesso alle API è incluso nel piano Pro a 5$/mese — nessun piano enterprise richiesto. La maggior parte degli altri lettori RSS rende le API disponibili solo nei piani più costosi o di livello superiore.

Crea una chiave API

Vai alla pagina delle impostazioni di SereneReader e scorri fino alla sezione API. Crea una nuova chiave, assegnale un nome che ricorderai in seguito, e copiala in un posto sicuro. La chiave viene mostrata una volta sola.

Autenticazione

Ogni richiesta richiede un token Bearer nell'intestazione Authorization. Nient'altro. Nessun client ID, nessun refresh token, nessun scope. La pagina delle impostazioni API contiene l'URL base, la documentazione degli endpoint e richieste di esempio.

Limiti di frequenza

Le API consentono 30 richieste al minuto per account. Più che sufficiente per script che girano su schedule. Se raggiungi il limite, aspetta qualche secondo prima di riprovare.

Cosa puoi fare

Le API ti danno accesso in lettura ai tuoi articoli e alle tue iscrizioni. Filtra gli articoli per feed, cartella o data di pubblicazione. Elenca le tue iscrizioni con i conteggi dei non letti. Tutte le risposte sono in JSON con titoli, URL, date di pubblicazione, estratti e metadati del feed.

L'elenco completo degli endpoint, dei parametri e delle strutture delle risposte si trova nella sezione documenti API della pagina delle impostazioni.

Casi d'uso

Email con digest giornaliero

Scrivi uno script che gira ogni mattina alle 7, recupera gli articoli del giorno precedente e ti invia un'email di riepilogo. Filtra per data, passa il JSON attraverso jq per estrarre titoli e URL, e invia il risultato a qualsiasi sistema di notifica tu preferisca.

I dati sono disponibili in un formato pulito, pronti per essere modellati come vuoi.

Monitor della salute dei feed

I feed si rompono. I domini scadono, i percorsi cambiano, i server vanno offline. Uno script settimanale può elencare le tue iscrizioni e controllare quali non pubblicano da un po'.

Quando un feed diventa silenzioso, lo saprai prima di cominciare a chiederti perché quel blog ha smesso di apparire.

Esporta verso altri strumenti

Importa gli articoli in un database locale, una pagina Notion, un vault Obsidian o un foglio di calcolo. Le API ti forniscono dati strutturati, quindi il passaggio di trasformazione di solito richiede solo poche righe di jq o un breve script Python.

Combina con agenti AI

Le API si abbinano bene agli strumenti AI che possono fare richieste HTTP. Se stai usando un framework di agenti come OpenClaw, puoi puntarlo su SereneReader e lasciare che elabori i tuoi feed in autonomia. Abbiamo scritto un articolo separato su questo: Come collegare i tuoi feed RSS ad agenti AI.

Mantieni la semplicità

Le migliori automazioni sono script brevi che fanno una cosa sola. Un cron job che gira una volta al giorno. Un alias shell che mostra il conteggio dei non letti. Un relay webhook che inoltra gli articoli a un canale Slack.

Non hai bisogno di un framework per questo. curl e jq coprono la maggior parte dei casi. Se hai bisogno di qualcosa di più strutturato, qualsiasi linguaggio con un client HTTP andrà bene.

Le chiavi API e la documentazione degli endpoint si trovano nelle impostazioni di SereneReader.