← Back to blog

Creación de automatizaciones con la API de SereneReader

¿Por qué automatizar tu lectura?

RSS ya resuelve la parte difícil: reunir contenido de cientos de fuentes en un solo lugar. La API de SereneReader te permite llevar ese contenido a scripts, tareas cron y otras herramientas de forma programática.

Sin webhooks que configurar. Sin el proceso de OAuth. Genera una clave de API, haz solicitudes HTTP y recibe JSON como respuesta.

Primeros pasos

El acceso a la API está incluido en el plan Pro a 5 $/mes — no se requiere un nivel empresarial. La mayoría de los lectores RSS de la competencia restringen el acceso a la API a planes de mayor precio o de nivel superior.

Crea una clave de API

Ve a tu página de ajustes en SereneReader y desplázate hasta la sección de API. Crea una nueva clave, dale un nombre que reconozcas más adelante y cópiala en un lugar seguro. La clave solo se muestra una vez.

Autenticación

Cada solicitud necesita un token Bearer en el encabezado Authorization. Nada más. Sin identificadores de cliente, sin tokens de actualización, sin ámbitos. Tu página de ajustes de API tiene la URL base, la documentación de endpoints y ejemplos de solicitudes.

Límites de uso

La API permite 30 solicitudes por minuto por cuenta. Más que suficiente para scripts que se ejecutan con regularidad. Si alcanzas el límite, espera unos segundos antes de volver a intentarlo.

Qué puedes hacer

La API te da acceso de lectura a tus artículos y suscripciones. Filtra artículos por fuente, carpeta o fecha de publicación. Lista tus suscripciones con el recuento de no leídos. Todas las respuestas son JSON con títulos, URLs, fechas de publicación, fragmentos y metadatos de la fuente.

La lista completa de endpoints, parámetros y estructuras de respuesta está en la sección de documentación de la API dentro de tu página de ajustes.

Casos de uso

Resumen diario por correo electrónico

Escribe un script que se ejecute cada mañana a las 7 a. m., obtenga los artículos del día anterior y te envíe un correo con el resumen. Filtra por fecha, procesa el JSON con jq para extraer títulos y URLs, y envía el resultado al sistema de notificaciones que prefieras.

Los datos están disponibles en un formato limpio, listos para darles la forma que quieras.

Monitor de salud de fuentes

Las fuentes se rompen. Los dominios caducan, las rutas cambian, los servidores caen. Un script semanal puede listar tus suscripciones y comprobar cuáles llevan un tiempo sin publicar.

Cuando una fuente deja de emitir contenido, lo sabrás antes de empezar a preguntarte por qué ese blog dejó de aparecer.

Exportar a otras herramientas

Lleva artículos a una base de datos local, una página de Notion, un vault de Obsidian o una hoja de cálculo. La API te proporciona datos estructurados, así que el paso de transformación suele ser solo unas pocas líneas de jq o un breve script de Python.

Combinar con agentes de IA

La API funciona bien junto con herramientas de IA que pueden hacer solicitudes HTTP. Si usas un framework de agentes como OpenClaw, puedes apuntarlo a SereneReader y dejar que procese tus fuentes por su cuenta. Escribimos una entrada aparte sobre eso: Cómo conectar tus fuentes RSS a agentes de IA.

Mantén la simplicidad

Las mejores automatizaciones son scripts cortos que hacen una sola cosa. Una tarea cron que se ejecuta una vez al día. Un alias de shell que muestra tu recuento de no leídos. Un relay de webhook que reenvía artículos a un canal de Slack.

No necesitas un framework para esto. curl y jq cubren la mayoría de los casos. Si necesitas algo más estructurado, cualquier lenguaje con un cliente HTTP funcionará.

Las claves de API y la documentación de endpoints están en tu configuración de SereneReader.