Publicar un canal RSS o Atom en Bluesky
Revisa las entradas nuevas antes de publicar. Este tutorial ofrece un importador RSS/Atom reutilizable y una cola local con pasos explícitos de envío y recuperación.
Por El equipo de Bluesky.bot
- Publicado:
- Actualizado:
- Revisado:
Qué vas a construir
Convierte los artículos nuevos de un canal RSS 2.0 o Atom 1.0 en una cola pequeña de publicaciones en Bluesky. Primero revisa la vista previa, recuerda el archivo existente sin publicarlo y después activa el envío expresamente. Es RSS hacia Bluesky, no un feed personalizado de Bluesky ni una forma de leer una cuenta en un lector RSS.
Necesitas Python 3.11 o posterior, un disco local persistente, una cuenta que controles y permiso para redistribuir los enlaces del canal. El ejemplo publica texto y un enlace. Imágenes, respuestas, menciones, enlaces relativos y títulos HTML complejos requieren otra implementación. Bluesky.bot ofrece la guía y los archivos; tú ejecutas el bot.
1. Descargar y probar el kit reutilizable
Descarga las recetas con licencia MIT y extrae el archivo en una carpeta nueva. Incluye cola, importador, documentos RSS/Atom de prueba y pruebas sin conexión. No incluye credenciales ni workflows activados.
tar -xzf bluesky-bot-recipes.tar.gz
cd bluesky-bot-recipes
python3 -m unittest -v test_recipes.pyLas pruebas simulan publicación y recuperación. No demuestran que un envío autenticado haya funcionado en tu cuenta. La vista previa no necesita instalar el SDK.
2. Recordar el archivo inicial sin volver a publicarlo
Inicializa el RSS de ejemplo y previsualiza el documento Atom que contiene una entrada nueva:
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.sqlite3El primer comando recuerda dos identidades sin crear publicaciones. El segundo prepara una entrada Atom y elige el enlace del artículo, no el archivo de audio adjunto. Un GUID o ID de Atom es opaco: no tiene por qué ser una URL.
Para tu canal real, descarga el XML en feed.xml e inicialízalo una sola vez, con otra base. Elige un --feed-id estable. Repetir la inicialización en cada consulta ocultaría las novedades.
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 --baselineSustituye la dirección por la de tu canal. El importador lee XML local, no inicia una sesión. Limita las descargas y utiliza un canal de confianza.
3. Revisar las novedades y añadirlas a la cola
Tras un cambio, descarga de nuevo el XML e inspecciona la vista previa:
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 guarda una tarea pendiente y la identidad de la entrada en la misma transacción. Todavía no publica nada. Importar otra vez la misma entrada mantiene una sola tarea. run sin opciones muestra el texto vencido sin cambiar su estado de entrega.
Empieza con una entrada por ejecución. --limit 5 es un máximo, no una frecuencia recomendada. En un canal ordenado normalmente de más reciente a más antiguo, el lote comienza con la entrada desconocida más antigua que sigue en el documento; no garantiza un orden cronológico universal. Consulta el canal antes de que desaparezcan artículos.
Se omiten títulos o enlaces ausentes, enlaces que no sean HTTP(S) absolutos y textos que superen el límite conservador de 300 puntos de código. Corrige el título de forma deliberada, sin cortar la URL. El parser limita la entrada a 5 MiB y rechaza DTD, entidades y bytes NUL. No descarga artículos completos ni crea imágenes.
Las fechas del canal (pubDate, published y updated) no programan el envío en este kit. Las novedades válidas se añaden con la hora de observación. Para un embargo o fecha futura, prepara una tarea con fecha explícita mediante el tutorial de programación.
4. Conectar tu bot y comprobar una publicación
Sigue la guía de contraseñas de aplicación. Crea una credencial específica para el bot; no uses la contraseña principal. Un servicio que conecta cuentas de otras personas debe utilizar OAuth.
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements.txtConfigura BLUESKY_HANDLE y BLUESKY_APP_PASSWORD en el entorno local o en un archivo protegido. Si la cuenta no está alojada en bsky.social, indica su PDS HTTPS actual en BLUESKY_SERVICE. No guardes secretos en el canal, la cola JSON, Git, capturas ni historial del terminal.
python3 posting_queue.py --db .state/live.sqlite3 run --publish
python3 posting_queue.py --db .state/live.sqlite3 status--publish abre una sesión e intenta enviar una tarea vencida. Una respuesta confirmada se guarda como sent con su URI at://. Comprueba el post y su enlace en Bluesky antes de automatizar. La base queda vinculada al DID del bot; utiliza una base por cuenta.
5. Conservar el estado y revisar envíos inciertos
El tutorial completo de programación explica disco persistente, cron, zonas horarias, cancelación y reinicio. Un entorno CI nuevo no conserva automáticamente lo ocurrido antes.
La cola confirma publishing antes de llamar a la red. Otro worker no toma esa misma tarea. Una excepción o respuesta perdida pasa a review; un cierre brusco puede dejar publishing. No se reintenta automáticamente: el servidor podría haber aceptado el post antes del timeout. La clave del record se conserva para un reintento explícito.
python3 posting_queue.py --db .state/live.sqlite3 status
python3 posting_queue.py --db .state/live.sqlite3 cancel JOB_IDSolo puedes cancelar una tarea pending. Para review o publishing, detén el worker y comprueba el record público con la clave de status en el explorador del repositorio. Verifica su contenido antes de resolver el estado. Si no conoces el resultado, déjalo en revisión. El README detalla las órdenes; no se garantiza una entrega exactamente una vez después de perder la base.
Diagnóstico y lista de comprobación
- No hay tareas: revisa inicialización única, ID del canal, base persistente, XML actualizado y enlaces de artículos.
- Artículo repetido: comprueba si el editor cambia el GUID en cada corrección. Cambiar IDs o borrar la base invalida el seguimiento.
- Falta un artículo: consulta los avisos y comprueba si salió del canal antes de la consulta. Un feed no es un archivo completo.
- Falla la conexión: revisa cuenta, credencial y PDS. El tutorial inicial de Python explica el SDK.
- Límite o resultado incierto: detén el proceso, inspecciona el estado y respeta las indicaciones del servidor. No fuerces reintentos con nuevos IDs o conexiones repetidas.
Antes de dejarlo funcionando: registra el archivo, revisa una novedad, publica una prueba deliberada, verifica el enlace, respalda el estado y simula un reinicio. Identifica la automatización y respeta las buenas prácticas. Cita a los autores originales; disponer de una URL RSS no autoriza copiar artículos enteros.
Puedes reutilizar código, ejemplos y pruebas bajo MIT sin backlink obligatorio. Las citas voluntarias son bienvenidas; una descarga no garantiza enlaces, posiciones ni tráfico.