Cómo guardar links de Reeder (macOS) a Raindrop.io

Ahora que recién le agregué la funcionalidad para compartir links en mi sitio usando Raindrop.io, pues me surgió la necesidad de también poder compartir links interesantes que me encuentro cuando leo los RSS feeds a los que estoy suscrito.

Para consumir RSS uso Reeder Classic para macOS (que por cierto, recomiendo ampliamente) y se me ocurrió que me serviría bastante conectar Reeder con Raindrop.io (para de esa manera también compartir links en mi sitio).

Entonces puse manos a la obra y me puse a hacer un Apple Shortcut que hiciera exactamente eso. A continuación quiero compartir el proceso por si sirve de inspiración para alguien de lograr algo similar.

Paso 1: Crear un API token en Raindrop.io

Para ello hay que ir a Settings > Integrations dentro de Raindrop.io. Ahí hay que hacer clic en el botón “Create new app” y luego hay que llenar los campos requeridos:

Yo aquí creé un Test token y luego lo copié al clipboard (más adelante lo usé para configurar el shortcut).

Paso 2: Crear el Apple Shortcut

2.1: Nombrar el shortcut

En mi caso simplemente le puse “Share link to Raindrop.io” y luego le asigné el ícono de enlace para dar a entender que estamos lidiando con un link.

2.2: Activar la opción “Show in Share Sheet”

Del lado derecho dentro del panel “Details” busqué la opción “Show in Share Sheet”. Esto es para que el shortcut esté disponible dentro del menú compartir a nivel sistema operativo.

2.3: Al hacer lo anterior se agregará automáticamente una acción Receive _ input from Share Sheet a nuestro shortcut para recibir un input desde el exterior

Entonces aquí lo que hice fue hacer clic después de donde dice “Receive” (dentro de la acción) y desactivé todas las opciones a excepción de “URLs” (ya que queremos el que shortcut solamente procese un URL desde el exterior):

2.4: Agregar la acción Set variable inmediatamente después para guardar el URL recibido desde el exterior en una variable

A esa variable la nombré simplemente como SharedURL:

2.5 Obtener el título del link y guardarlo también en una variable

Lo que sigue es obtener el título del link y guardarlo en una nueva variable usando la acción Get Name. Solo hay que agregarla y luego agregar la variable SharedURL dentro de la acción (asegurándonos de que la opción “Get Web Page Title” esté activada). Luego almacenamos el título en una nueva variable, yo le puse PageTitle:

2.6 Agregamos el endpoint del API de Raindrop.io al shortcut y hacemos POST de nuestro link

Aquí hay que agregar la acción URL (así es el nombre de la acción) y pegamos ahí el endpoint https://api.raindrop.io/rest/v1/raindrop que es el que servirá para agregar el link a la cuenta de Raindrop.

2.7 Guardamos el link en la cuenta de Raindrop.io usando la acción Get Contents of URL

Al agregar la acción Get Contents of URL podremos autenticarnos en la cuenta de Raindrop.io usando el Test token que creamos en el paso 1:

2.7.1 Hay que autentificarnos en Raindrop.io agregando el Test token

Hay que asegurarnos que el “Method” seleccionado sea POST y luego agregamos los Headers:

Agregamos un elemento dentro de Headers con los siguientes elementos:

• Key: Authorization
• Value: Bearer Test token 👈 Aquí solamente hay que pegar el valor del Test token que obtienes de Raindrop.io, justo después de la palabra “Bearer” (separados por un espacio solamente)

2.7.2 Mapeamos nuestro link conforme a la API de Raindrop.io

Luego hay que pasar los valores que recolectamos al inicio del shortcut (SharedURL y PageTitle) en un objeto JSON. Para ello hay que asegurarnos que Request Body esté como JSON.

Luego agregamos los valores al objeto JSON, los cuales son:

Yo en lo personal agregué el Key “tags” y le especifiqué la palabra “Reeder” solamente para identificar qué links guardé desde Reeder dentro de Raindrop.io, este Key es completamente opcional.

También el Key “collection” también es completamente opcional. Este lo agregué para agregar el link a una colección llamada “Links” dentro de Raindrop.io. Para ello tuve que obtener el $id de la lista haciendo una llamada GET al endpoint https://api.raindrop.io/rest/v1/raindrop y buscar el $id en la respuesta que me dio ese endpoint.

2.8 Error handling

Ya por último solamente agregué un bloque If para comprobar si el link se agregó satisfactoriamente o no a Raindrop.io.

Se puede descargar este shortcut en el siguiente botón (para que puedas adaptarlo a tus propias necesidades):

Espero que esto le sea de utilidad a alguien más, ¡feliz año nuevo! 🫶