Publier un flux RSS ou Atom sur Bluesky
Prévisualisez les nouvelles entrées avant de publier. Ce tutoriel fournit un importateur RSS/Atom réutilisable, une file locale et des étapes explicites de publication et de reprise.
Par L’équipe Bluesky.bot
- Publié:
- Modifié:
- Revu:
Ce que vous allez construire
Transformez les nouveaux articles d’un flux RSS 2.0 ou Atom 1.0 en une petite file de publications Bluesky. Commencez par une prévisualisation, mémorisez les archives sans les publier, puis activez explicitement l’envoi. Il s’agit bien de RSS vers Bluesky, et non d’un fil personnalisé Bluesky ou d’un abonnement RSS à un compte.
Prévoyez Python 3.11 ou plus récent, un disque local persistant, un compte de bot sous votre contrôle et un flux dont vous pouvez redistribuer les liens. Le kit produit du texte et un lien d’article. Images, réponses, mentions, liens relatifs et titres HTML complexes demandent une autre implémentation. Bluesky.bot fournit le guide et les sources ; le programme tourne sur votre machine.
1. Télécharger et tester le kit réutilisable
Téléchargez les exemples sous licence MIT et décompressez-les dans un nouveau dossier. L’archive contient la file, l’importateur RSS, des exemples RSS/Atom et des tests hors ligne. Aucun identifiant ni workflow actif n’est fourni.
tar -xzf bluesky-bot-recipes.tar.gz
cd bluesky-bot-recipes
python3 -m unittest -v test_recipes.pyLes tests simulent les envois et les reprises. Ils ne prouvent pas qu’une publication authentifiée a réussi sur votre compte. La prévisualisation fonctionne sans installer le SDK Bluesky.
2. Initialiser le flux sans republier ses archives
Mémorisez le flux RSS d’exemple, puis prévisualisez le document Atom qui contient un nouvel élément :
python3 rss_to_queue.py sample-rss.xml --feed-id my-blog --db .state/rss.sqlite3 --baseline
python3 rss_to_queue.py sample-atom.xml --feed-id my-blog --db .state/rss.sqlite3La première commande mémorise deux identifiants RSS sans créer de publication. La seconde prépare un élément Atom et choisit son lien d’article, pas sa pièce jointe audio. Un GUID ou identifiant Atom est une identité opaque : ce n’est pas forcément une URL.
Pour votre vrai flux, récupérez son XML dans feed.xml puis initialisez une seule fois, dans une autre base. Donnez à --feed-id un nom stable. Réinitialiser à chaque relève masquerait les nouveaux éléments.
curl --fail --location --max-time 20 --max-filesize 5242880 "https://example.org/feed.xml" --output feed.xml
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3 --baselineRemplacez l’adresse par celle de votre flux. L’importateur lit un fichier local ; il ne se connecte pas à un compte. Limitez la taille du téléchargement et utilisez un flux de confiance.
3. Prévisualiser puis ajouter explicitement les nouveautés
Après modification du flux, téléchargez-le de nouveau et inspectez l’aperçu :
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3
python3 rss_to_queue.py feed.xml --feed-id my-blog --db .state/live.sqlite3 --enqueue
python3 posting_queue.py --db .state/live.sqlite3 run--enqueue inscrit un travail en attente et mémorise l’identité de l’article dans la même transaction. Cette étape ne publie rien. Réimporter le même élément conserve un seul travail. La commande run seule prévisualise les textes arrivés à échéance sans modifier leur état de livraison.
Commencez avec un élément par exécution. --limit 5 est un plafond, pas une fréquence conseillée. Pour un flux habituellement classé du plus récent au plus ancien, le lot commence par le plus ancien élément encore inconnu dans le document ; ce n’est pas une garantie générale d’ordre chronologique. Relevez le flux avant que ses articles n’en disparaissent.
Les titres ou liens manquants, liens non absolus HTTP(S) et textes dépassant le plafond prudent de 300 points de code sont ignorés avec un diagnostic. Raccourcissez un titre volontairement, jamais son URL. Le parseur limite le fichier à 5 Mio et refuse DTD, entités et octets NUL. Il ne récupère ni article complet ni image.
Les dates du flux (pubDate, published et updated) ne servent pas d’ordonnanceur dans ce kit. Les nouveautés valides sont mises en file à l’heure de leur observation. Pour un embargo ou une date future, préparez un travail explicitement daté avec le tutoriel de planification.
4. Connecter votre bot et vérifier un premier envoi
Suivez le guide des mots de passe d’application. Utilisez un identifiant dédié au programme, pas le mot de passe principal du compte. Un service qui connecte les comptes d’autres personnes doit utiliser OAuth.
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements.txtDéfinissez BLUESKY_HANDLE et BLUESKY_APP_PASSWORD dans l’environnement local ou un fichier protégé. Si le compte n’est pas hébergé sur bsky.social, renseignez son PDS HTTPS actuel dans BLUESKY_SERVICE. Gardez ces valeurs hors du flux, de la file JSON, de Git, des captures et de l’historique du terminal.
python3 posting_queue.py --db .state/live.sqlite3 run --publish
python3 posting_queue.py --db .state/live.sqlite3 status--publish ouvre une session et tente explicitement un travail dû. Une réponse confirmée passe le travail à sent et conserve son URI at://. Vérifiez la publication et le lien dans Bluesky avant de l’automatiser. La base est liée au DID du bot ; chaque bot utilise sa propre base.
5. Conserver l’état et examiner les envois incertains
Le tutoriel complet de planification détaille stockage persistant, cron, fuseaux horaires, annulation et redémarrage. Un espace CI neuf ne garde pas automatiquement l’état de l’exécution précédente.
La file enregistre publishing avant l’appel réseau. Un autre worker ne prend pas ce même travail. Une erreur ou réponse perdue devient review ; un arrêt brutal peut laisser publishing. Aucune reprise automatique n’est faite : le serveur a peut-être accepté le post avant l’expiration du délai. Le travail garde sa clé de record pour une éventuelle nouvelle tentative explicite.
python3 posting_queue.py --db .state/live.sqlite3 status
python3 posting_queue.py --db .state/live.sqlite3 cancel JOB_IDSeul un travail pending peut être annulé. Pour review ou publishing, arrêtez le worker et vérifiez le record public à la clé indiquée par status, avec l’explorateur de dépôt. Contrôlez le contenu avant de résoudre l’état. Si le résultat reste inconnu, conservez-le en révision. Le README décrit les commandes ; le kit ne garantit pas une livraison exactement une fois après perte de la base.
Dépannage et vérifications avant lancement
- Aucun travail : vérifiez l’initialisation unique, le nom du flux, la base conservée, le XML actualisé et les liens d’articles.
- Article répété : regardez si l’éditeur change son GUID à chaque correction. Des identifiants stables sont indispensables ; les modifier ou supprimer la base contourne le suivi.
- Article absent : consultez les diagnostics et vérifiez s’il avait déjà quitté le flux avant sa relève. Un flux n’est pas une archive exhaustive.
- Connexion refusée : vérifiez le compte, le mot de passe dédié et le PDS actuel. Le premier bot Python explique les bases du SDK.
- Limitation ou résultat incertain : arrêtez, inspectez l’état et respectez le délai du serveur avant reprise. N’enchaînez pas les connexions ni de nouveaux identifiants pour forcer un envoi.
Avant un fonctionnement autonome : initialisez les archives, prévisualisez une nouveauté, publiez un test délibéré, vérifiez son lien, sauvegardez l’état et simulez un redémarrage. Rendez l’automatisation identifiable et suivez les bonnes pratiques. Citez les auteurs d’origine ; un flux accessible n’autorise pas à recopier tous les articles.
Sources, fixtures et tests sont réutilisables sous MIT, sans lien retour obligatoire. Une citation volontaire est bienvenue ; publier une ressource ne garantit ni backlink, ni position, ni trafic.