Automatisierungen mit der SereneReader API erstellen

Warum das Lesen automatisieren?

RSS bringt bereits Inhalte aus vielen Quellen an einem Ort zusammen. Die SereneReader API ermöglicht es Ihnen, diese Inhalte in Skripte, Cron-Jobs und andere Tools zu übertragen.

Die Authentifizierung erfolgt über einen einzigen API-Schlüssel: Erstellen Sie einen, senden Sie ihn mit jeder HTTP-Anfrage, und erhalten Sie JSON zurück. Die API ist schreibgeschützt und hat keine Webhooks, daher fragen Skripte sie nach einem Zeitplan ab.

Erste Schritte

API-Zugang ist in Pro (5 $/Monat auf der Website) und Team enthalten.

Einen API-Schlüssel erstellen

Öffnen Sie in SereneReader die Einstellungen und wählen Sie den Tab „API". Erstellen Sie einen Schlüssel, geben Sie ihm einen Namen, den Sie später wiedererkennen, und kopieren Sie ihn an einen sicheren Ort; er wird nur einmal angezeigt. Pro-Konten können bis zu 5 Schlüssel haben, Team-Konten bis zu 10.

Authentifizierung

Jede Anfrage benötigt Ihren Schlüssel als Bearer-Token im Authorization-Header. Es gibt keine Client-IDs, Refresh-Tokens oder Scopes. Der API-Tab in den Einstellungen listet die Basis-URL, die Endpunkte und Beispielanfragen auf.

Rate-Limits

Die API erlaubt 30 Anfragen pro Minute pro Konto, geteilt über alle Ihre Schlüssel – das ist reichlich für Skripte, die nach einem Zeitplan laufen. Jede Antwort enthält einen X-RateLimit-Remaining-Header. Wenn Sie das Limit überschreiten, gibt die API 429 mit einem Retry-After-Header zurück; warten Sie die angegebene Anzahl an Sekunden, bevor Sie es erneut versuchen.

Was Sie tun können

Die API gibt Ihnen Lesezugriff auf Ihre Artikel und Abonnements:

• GET /api/v1/articles gibt Artikel aus Ihren Feeds zurück, neueste zuerst. Sie können nach Feed, Ordner oder Veröffentlichungsdatum filtern und durch die Ergebnisse blättern (standardmäßig 50 pro Anfrage, bis zu 200). Jeder Artikel enthält Titel, URL, Feed-Name, Autor, Veröffentlichungsdatum, einen Ausschnitt sowie die Information, ob Sie ihn gelesen oder mit Stern markiert haben.
• GET /api/v1/feeds listet Ihre Abonnements mit ihren ungelesenen Zählständen und Ordnern auf.
• GET /api/v1/usage zeigt, wie viele Anfragen der verwendete Schlüssel in den letzten einer Stunde, 8 Stunden und 24 Stunden gestellt hat.

Der API-Tab in den Einstellungen enthält die vollständige Liste der Parameter und Antwortfelder.

Anwendungsfälle

Tägliche Digest-E-Mail

Schreiben Sie ein Skript, das jeden Morgen um 7 Uhr läuft, die Artikel des Vortages abruft und Ihnen eine Zusammenfassungs-E-Mail sendet. Filtern Sie nach Datum, leiten Sie das JSON durch jq, um Titel und URLs herauszufiltern, und senden Sie das Ergebnis mit dem E-Mail- oder Benachrichtigungstool Ihrer Wahl.

Stille-Feed-Prüfung

Feeds können kaputtgehen: Domains laufen ab, Pfade ändern sich, Server gehen offline. Die API meldet keine Abruffehler oder den letzten Veröffentlichungszeitpunkt eines Feeds, aber ein wöchentliches Skript kann dennoch Feeds erkennen, die still geworden sind. Listen Sie Ihre Feeds auf, rufen Sie aktuelle Artikel für jeden mit den Parametern feedId und since ab, und markieren Sie jeden Feed, der in den letzten Wochen nichts veröffentlicht hat. Wenn Sie viele Feeds haben, verteilen Sie die Anfragen, um das Rate-Limit einzuhalten.

Ein stiller Feed ist nicht immer ein defekter, aber die Liste zeigt Ihnen, welche Blogs Sie überprüfen sollten.

Export in andere Tools

Übertragen Sie Artikel in eine lokale Datenbank, eine Notion-Seite, ein Obsidian-Vault oder eine Tabellenkalkulation. Die API gibt strukturiertes JSON zurück, sodass die Umwandlung meist nur wenige Zeilen jq oder ein kurzes Python-Skript erfordert.

Mit KI-Agenten kombinieren

Die API funktioniert mit KI-Tools, die HTTP-Anfragen stellen können. Wenn Sie einen Assistenten wie OpenClaw verwenden, können Sie ihn auf SereneReader verweisen und Ihre Feeds verarbeiten lassen. Dazu haben wir einen separaten Beitrag verfasst: So verbinden Sie Ihre RSS-Feeds mit KI-Agenten.

Weitere Ideen

Einige weitere Dinge, die Sie in wenigen Zeilen erstellen können: ein Cron-Job, der Ihnen die Artikel des Tages aus einem Ordner per E-Mail sendet, ein Shell-Alias, der die ungelesenen Zählstände aus /api/v1/feeds zusammenaddiert, oder ein Polling-Skript, das neue Artikel aus einem Feed in einen Slack-Kanal postet.

Für nichts davon brauchen Sie ein Framework. curl und jq decken die meisten Fälle ab, und jede Sprache mit einem HTTP-Client reicht für den Rest.

Erstellen Sie Ihren Schlüssel in den Einstellungen, im Tab „API".