Creación de automatizaciones con la API de SereneReader

¿Por qué automatizar tu lectura?

RSS ya reúne contenido de muchas fuentes en un solo lugar. La API de SereneReader te permite incorporar ese contenido a scripts, cron jobs y otras herramientas.

La autenticación se reduce a una sola clave de API: créala, envíala con cada solicitud HTTP y recibirás JSON como respuesta. La API es de solo lectura y no dispone de webhooks, por lo que los scripts la consultan según un calendario definido.

Primeros pasos

El acceso a la API está incluido en los planes Pro (5 $/mes en la web) y Team.

Crear una clave de API

En SereneReader, abre Ajustes y selecciona la pestaña API. Crea una clave, asígnale un nombre que puedas reconocer más adelante y guárdala en un lugar seguro; solo se muestra una vez. Las cuentas Pro pueden tener hasta 5 claves y las cuentas Team hasta 10.

Autenticación

Cada solicitud necesita tu clave como token Bearer en la cabecera Authorization. No hay IDs de cliente, tokens de actualización ni ámbitos de acceso. La pestaña API en Ajustes muestra la URL base, los endpoints y ejemplos de solicitudes.

Límites de uso

La API permite 30 solicitudes por minuto por cuenta, compartidas entre todas tus claves, lo cual es más que suficiente para scripts que se ejecutan según un calendario. Cada respuesta incluye una cabecera X-RateLimit-Remaining. Si superas el límite, la API devuelve 429 con una cabecera Retry-After; espera esa cantidad de segundos antes de volver a intentarlo.

Qué puedes hacer

La API te da acceso de lectura a tus artículos y suscripciones:

• GET /api/v1/articles devuelve los artículos de tus feeds, del más reciente al más antiguo. Puedes filtrar por feed, carpeta o fecha de publicación, y paginar los resultados (50 por solicitud por defecto, hasta 200). Cada artículo incluye su título, URL, nombre del feed, autor, fecha de publicación, un fragmento y si lo has leído o marcado con estrella.
• GET /api/v1/feeds lista tus suscripciones con sus contadores de no leídos y sus carpetas.
• GET /api/v1/usage muestra cuántas solicitudes ha realizado la clave que estás usando en la última hora, las últimas 8 horas y las últimas 24 horas.

La pestaña API en Ajustes contiene la lista completa de parámetros y campos de respuesta.

Casos de uso

Resumen diario por correo

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

Comprobación de feeds silenciosos

Los feeds se rompen: los dominios caducan, las rutas cambian, los servidores caen. La API no informa de errores de obtención ni de cuándo publicó por última vez un feed, pero un script semanal puede detectar feeds que han dejado de publicar. Lista tus feeds, solicita artículos recientes de cada uno con los parámetros feedId y since, y marca cualquier feed que no haya publicado nada en las últimas semanas. Si tienes muchos feeds, distribuye las solicitudes para mantenerte por debajo del límite de uso.

Un feed silencioso no siempre es un feed roto, pero la lista te indica qué blogs conviene revisar.

Exportar a otras herramientas

Lleva los 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 devuelve JSON estructurado, por lo que la transformación suele requerir unas pocas líneas de jq o un script corto de Python.

Combinación con agentes de IA

La API funciona con herramientas de IA capaces de hacer solicitudes HTTP. Si usas un asistente como OpenClaw, puedes apuntarlo a SereneReader y hacer que procese tus feeds. Escribimos un artículo aparte sobre esto: Cómo conectar tus feeds RSS a agentes de IA.

Más ideas

Otras cosas que puedes construir en pocas líneas: un cron job que te envíe por correo los artículos del día desde una carpeta concreta, un alias de shell que sume los contadores de no leídos de /api/v1/feeds, o un script de sondeo que publique los nuevos artículos de un feed en un canal de Slack.

No necesitas ningún framework para nada de esto. curl y jq cubren la mayoría de los casos, y cualquier lenguaje con un cliente HTTP se encarga del resto.

Crea tu clave en Ajustes, en la pestaña API.