Créer des automatisations avec l'API SereneReader

Pourquoi automatiser votre lecture ?

RSS rassemble déjà le contenu de nombreuses sources en un seul endroit. L'API SereneReader vous permet d'intégrer ce contenu dans des scripts, des tâches cron et d'autres outils.

L'authentification repose sur une seule clé API : créez-en une, envoyez-la avec chaque requête HTTP, et recevez du JSON en retour. L'API est en lecture seule et ne propose pas de webhooks, donc les scripts l'interrogent selon un planning défini.

Premiers pas

L'accès à l'API est inclus avec les abonnements Pro (5 $/mois sur le web) et Team.

Créer une clé API

Dans SereneReader, ouvrez les Paramètres et choisissez l'onglet API. Créez une clé, donnez-lui un nom que vous reconnaîtrez plus tard, et copiez-la dans un endroit sûr ; elle n'est affichée qu'une seule fois. Les comptes Pro peuvent avoir jusqu'à 5 clés, et les comptes Team jusqu'à 10.

Authentification

Chaque requête nécessite votre clé sous forme de jeton Bearer dans l'en-tête Authorization. Il n'y a pas d'identifiants client, de jetons de rafraîchissement ni de portées. L'onglet API dans les Paramètres répertorie l'URL de base, les endpoints et des exemples de requêtes.

Limites de débit

L'API autorise 30 requêtes par minute et par compte, partagées entre toutes vos clés, ce qui est largement suffisant pour des scripts qui s'exécutent selon un planning. Chaque réponse inclut un en-tête X-RateLimit-Remaining. Si vous dépassez la limite, l'API retourne 429 avec un en-tête Retry-After ; attendez le nombre de secondes indiqué avant de réessayer.

Ce que vous pouvez faire

L'API vous donne un accès en lecture à vos articles et abonnements :

• GET /api/v1/articles retourne les articles de vos flux, du plus récent au plus ancien. Vous pouvez filtrer par flux, dossier ou date de publication, et parcourir les résultats par pages (50 par requête par défaut, jusqu'à 200). Chaque article inclut son titre, son URL, le nom du flux, l'auteur, la date de publication, un extrait, ainsi que l'indication si vous l'avez lu ou mis en favori.
• GET /api/v1/feeds liste vos abonnements avec leur nombre d'articles non lus et leurs dossiers.
• GET /api/v1/usage indique le nombre de requêtes effectuées par la clé utilisée au cours de la dernière heure, des 8 dernières heures et des 24 dernières heures.

L'onglet API dans les Paramètres présente la liste complète des paramètres et des champs de réponse.

Cas d'usage

Digest quotidien par e-mail

Écrivez un script qui s'exécute chaque matin à 7h, récupère les articles du jour précédent et vous envoie un e-mail récapitulatif. Filtrez par date, faites passer le JSON dans jq pour extraire les titres et les URL, puis envoyez le résultat avec l'outil d'e-mail ou de notification de votre choix.

Vérification des flux silencieux

Les flux se cassent : les domaines expirent, les chemins changent, les serveurs tombent en panne. L'API ne signale pas les erreurs de récupération ni la date de dernière publication d'un flux, mais un script hebdomadaire peut tout de même détecter les flux devenus silencieux. Listez vos flux, demandez les articles récents de chacun avec les paramètres feedId et since, et signalez tout flux n'ayant rien publié depuis les dernières semaines. Si vous avez beaucoup de flux, espacez les requêtes pour rester sous la limite de débit.

Un flux silencieux n'est pas toujours un flux cassé, mais la liste vous indique quels blogs vérifier.

Export vers d'autres outils

Importez des articles dans une base de données locale, une page Notion, un coffre Obsidian ou une feuille de calcul. L'API retourne du JSON structuré, donc la transformation ne demande généralement que quelques lignes de jq ou un court script Python.

Combinaison avec des agents IA

L'API fonctionne avec les outils IA capables d'effectuer des requêtes HTTP. Si vous utilisez un assistant tel qu'OpenClaw, vous pouvez le connecter à SereneReader pour qu'il traite vos flux. Nous avons rédigé un article séparé à ce sujet : Comment connecter vos flux RSS à des agents IA.

D'autres idées

Quelques autres choses que vous pouvez construire en quelques lignes : une tâche cron qui vous envoie par e-mail les articles du jour provenant d'un dossier, un alias shell qui additionne les nombres d'articles non lus depuis /api/v1/feeds, ou un script de polling qui publie les nouveaux articles d'un flux dans un canal Slack.

Vous n'avez besoin d'aucun framework pour tout cela. curl et jq couvrent la plupart des cas, et n'importe quel langage disposant d'un client HTTP convient pour le reste.

Créez votre clé dans les Paramètres, dans l'onglet API.