Creare automazioni con le API di SereneReader

Perché automatizzare la lettura?

RSS raccoglie già i contenuti da molte fonti in un unico posto. Le API di SereneReader ti permettono di portare quei contenuti in script, cron job e altri strumenti.

L'autenticazione si basa su una singola chiave API: creane una, inviala con ogni richiesta HTTP e ricevi JSON in risposta. Le API sono in sola lettura e non supportano webhook, quindi gli script le interrogano a intervalli regolari.

Per iniziare

L'accesso alle API è incluso nei piani Pro ($5/mese sul web) e Team.

Crea una chiave API

In SereneReader, apri Impostazioni e scegli la scheda API. Crea una chiave, assegnale un nome che riconoscerai in seguito, e copiala in un posto sicuro; viene mostrata una sola volta. Gli account Pro possono avere fino a 5 chiavi, gli account Team fino a 10.

Autenticazione

Ogni richiesta richiede la tua chiave come token Bearer nell'intestazione Authorization. Non ci sono client ID, refresh token o scope. La scheda API in Impostazioni elenca l'URL base, gli endpoint e alcuni esempi di richiesta.

Limiti di frequenza

Le API consentono 30 richieste al minuto per account, condivise tra tutte le tue chiavi, il che è più che sufficiente per script eseguiti a intervalli regolari. Ogni risposta include un'intestazione X-RateLimit-Remaining. Se superi il limite, le API restituiscono 429 con un'intestazione Retry-After; attendi il numero di secondi indicato prima di riprovare.

Cosa puoi fare

Le API ti danno accesso in lettura ai tuoi articoli e alle tue iscrizioni:

• GET /api/v1/articles restituisce gli articoli dei tuoi feed, dal più recente. Puoi filtrare per feed, cartella o data di pubblicazione, e sfogliare i risultati (50 per richiesta per impostazione predefinita, fino a 200). Ogni articolo include il titolo, l'URL, il nome del feed, l'autore, la data di pubblicazione, un estratto e se l'hai letto o salvato con la stella.
• GET /api/v1/feeds elenca le tue iscrizioni con il conteggio dei non letti e le cartelle.
• GET /api/v1/usage mostra quante richieste ha effettuato la chiave in uso nell'ultima ora, nelle ultime 8 ore e nelle ultime 24 ore.

La scheda API in Impostazioni contiene l'elenco completo dei parametri e dei campi di risposta.

Casi d'uso

Email con digest giornaliero

Scrivi uno script che si esegue ogni mattina alle 7, recupera gli articoli del giorno precedente e ti invia un'email di riepilogo. Filtra per data, elabora il JSON con jq per estrarre titoli e URL, e invia il risultato con lo strumento email o di notifica che preferisci.

Controllo su feed silenziosi

I feed si rompono: i domini scadono, i percorsi cambiano, i server vanno offline. Le API non segnalano errori di recupero né quando un feed ha pubblicato per l'ultima volta, ma uno script settimanale può comunque individuare i feed che si sono fermati. Elenca i tuoi feed, richiedi gli articoli recenti per ciascuno usando i parametri feedId e since, e segnala tutti i feed che non hanno pubblicato nulla nelle ultime settimane. Se hai molti feed, distribuisci le richieste per restare entro il limite di frequenza.

Un feed silenzioso non è sempre un feed rotto, ma l'elenco ti dice quali blog vale la pena controllare.

Esportazione verso altri strumenti

Importa gli articoli in un database locale, una pagina Notion, un vault Obsidian o un foglio di calcolo. Le API restituiscono JSON strutturato, quindi la trasformazione richiede di solito poche righe di jq o un breve script Python.

Integrazione con agenti AI

Le API funzionano con strumenti AI in grado di effettuare richieste HTTP. Se usi un assistente come OpenClaw, puoi puntarlo su SereneReader e fargli elaborare i tuoi feed. Abbiamo scritto un post separato su questo: Come connettere i tuoi feed RSS ad agenti AI.

Altre idee

Alcune cose che puoi costruire in poche righe: un cron job che ti invia per email gli articoli del giorno da una cartella, un alias di shell che somma i conteggi dei non letti da /api/v1/feeds, o uno script di polling che pubblica i nuovi articoli di un feed in un canale Slack.

Non serve un framework per nulla di tutto questo. curl e jq coprono la maggior parte dei casi, e qualsiasi linguaggio con un client HTTP gestisce il resto.

Crea la tua chiave in Impostazioni, nella scheda API.