Créer des automatisations avec l'API SereneReader

Pourquoi automatiser votre lecture ?

RSS résout déjà la partie difficile : regrouper le contenu de centaines de 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 de façon programmatique.

Pas de webhooks à configurer. Pas de processus OAuth. Générez une clé API, effectuez des requêtes HTTP, obtenez du JSON en retour.

Premiers pas

L'accès à l'API est inclus dans l'offre Pro à 5 $/mois — aucun abonnement entreprise requis. La plupart des lecteurs RSS concurrents réservent l'accès à l'API à leurs formules les plus chères ou à leur niveau supérieur.

Créer une clé API

Rendez-vous sur votre page de paramètres dans SereneReader et faites défiler jusqu'à la section API. Créez une nouvelle clé, donnez-lui un nom que vous reconnaîtrez plus tard, et copiez-la dans un endroit sûr. La clé n'est affichée qu'une seule fois.

Authentification

Chaque requête nécessite un token Bearer dans l'en-tête Authorization. C'est tout. Pas d'identifiants client, pas de tokens de rafraîchissement, pas de scopes. Votre page de paramètres API contient l'URL de base, la documentation des endpoints et des exemples de requêtes.

Limites de taux

L'API autorise 30 requêtes par minute et par compte. C'est largement suffisant pour des scripts qui s'exécutent selon un calendrier. Si vous atteignez la limite, attendez quelques secondes avant de réessayer.

Ce que vous pouvez faire

L'API vous donne un accès en lecture à vos articles et à vos abonnements. Filtrez les articles par flux, dossier ou date de publication. Listez vos abonnements avec le nombre d'articles non lus. Toutes les réponses sont en JSON et contiennent les titres, les URL, les dates de publication, les extraits et les métadonnées des flux.

La liste complète des endpoints, des paramètres et des formats de réponse se trouve dans la section documentation API de votre page de paramètres.

Cas d'usage

Digest quotidien par e-mail

Écrivez un script qui s'exécute chaque matin à 7h, récupère les articles de la veille et vous envoie un e-mail récapitulatif. Filtrez par date, passez le JSON dans jq pour en extraire les titres et les URL, puis envoyez le résultat au système de notification de votre choix.

Les données sont disponibles dans un format structuré, prêtes à être transformées comme vous le souhaitez.

Surveillance de la santé des flux

Les flux se cassent. Les domaines expirent, les chemins changent, les serveurs tombent. Un script hebdomadaire peut lister vos abonnements et vérifier lesquels n'ont rien publié depuis un moment.

Lorsqu'un flux se tait, vous le saurez avant de commencer à vous demander pourquoi ce blog a cessé d'apparaître.

Export vers d'autres outils

Extrayez des articles vers une base de données locale, une page Notion, un coffre Obsidian ou une feuille de calcul. L'API vous fournit des données structurées, de sorte que l'étape de transformation se résume généralement à quelques lignes de jq ou à un court script Python.

Combiner avec des agents IA

L'API s'associe bien aux outils IA capables d'effectuer des requêtes HTTP. Si vous utilisez un framework d'agents comme OpenClaw, vous pouvez le diriger vers SereneReader et le laisser traiter vos flux de façon autonome. Nous avons rédigé un article séparé à ce sujet : Comment connecter vos flux RSS à des agents IA.

Restez simple

Les meilleures automatisations sont de courts scripts qui font une seule chose. Une tâche cron qui s'exécute une fois par jour. Un alias shell qui affiche votre nombre d'articles non lus. Un relais webhook qui transfère des articles vers un canal Slack.

Vous n'avez pas besoin d'un framework pour cela. curl et jq couvrent la plupart des cas. Si vous avez besoin de quelque chose de plus structuré, n'importe quel langage disposant d'un client HTTP fera l'affaire.

Les clés API et la documentation des endpoints se trouvent dans vos paramètres SereneReader.