Programar publicaciones en Mastodon sin herramientas externas

Actualmente, solo es posible programar una publicación en Mastodon para que se publique en un determinado momento usando herramientas de terceros como Buffer o Tusky.

Buffer es un servicio que permite programar publicaciones en distintas redes sociales (Mastodon, Bluesky, X, Instagram…) que se almacenan en los servidores de Buffer hasta que es hora de que se publiquen y entonces se envían a las redes sociales para las que se programaron.

El funcionamiento para programar publicaciones con aplicaciones como Tusky dedicadas a Mastodon es algo distinto. En general, no existen servidores de Tusky ni otras aplicaciones, sino que todos los datos que maneja la aplicación, se guardan localmente en el dispositivo en el que están instaladas (tu móvil). Pero incluso aunque el dispositivo esté apagado, las publicaciones programadas se publican igual. ¿Qué brujería está ocurriendo aquí?

Lo que ocurre es que Mastodon tiene soporte para programar publicaciones desde 2019. Así que cuando se programa una publicación desde Tusky o alguna aplicación similar, la aplicación le envía la publicación inmediatamente al servidor de Mastodon y su trabajo ahí ha concluido. Después es el servidor de Mastodon el que almacena la publicación programada y se encarga de publicarla cuando le llega su momento.

Sin embargo, aunque hace casi siete años que la API de Mastodon permite programar publicaciones, esta funcionalidad todavía no se implementó en la web o las aplicaciones móviles. Por eso, cuando aplicaciones como Tusky muestran la función de poder programar publicaciones, parece una característica adicional de esa aplicación. Pero no, es una función soportada nativamente por Mastodon, aunque no implementada en sus aplicaciones oficiales.

Así que vamos a ver cómo podemos hacer uso de esta API de Mastodon para poder programar publicaciones fácilmente sin usar herramientas externas. ¿Y por qué vamos a querer hacerlo así teniendo disponibles herramientas de terceros que ya lo hacen? Pues, en mi caso, porque no hago un uso tan exhaustivo de Mastodon como para necesitar herramientas adicionales, porque no conozco herramientas que permitan hacerlo desde el portátil (sin tener que abrir una cuenta en otro servicio más como Buffer) y porque ya tengo suficientes aplicaciones en el móvil como para instalar una más.

Para hacer esto, lo primero que necesitamos es la información de autenticación con nuestra instancia de Mastodon, el bearer.

La forma más fácil de obtener el bearer es la siguiente:

• Abrir las herramientas de desarrollo del navegador (normalmente, pulsando F12)
• Visitar alguna página de nuestra instancia de Mastodon que requiera llamadas a la API mientras estamos autenticados. Por ejemplo, la cronología principal.
• Cambiamos a la pestaña de Red en las herramientas de desarrollo.
• En el listado de peticiones de red, usamos el cuadro de texto de filtrado para mostrar solo las que sean peticiones a la API (es decir, las que contengan /api/ como parte de la URL).
• Seleccionamos una de las peticiones a la API del listado y en la pestaña de Cabeceras buscamos las cabeceras de la petición.
• Buscamos la cabecera Authorization y copiamos su valor.

Como podemos ver, el valor de la cabecera Authorization empieza con la palabra Bearer, y esa es la información de autenticación necesaria para poder programar una publicación fácilmente.

Y eso es todo lo que necesitamos para poder programar publicaciones de Mastodon manualmente.

Así, con esa información de autenticación, podemos:

• Programar nuevas publicaciones enviando una petición POST a /api/v1/statuses.
• Obtener la lista de publicaciones pendientes de ser publicadas enviando una petición GET a /api/v1/scheduled_statuses.
• Borrar una publicación programada enviando una petición DELETE a /api/v1/scheduled_statuses/*<id>*.

Y más acciones que se pueden ver en la documentación de la API de Mastodon sobre publicaciones programadas.

Así, por ejemplo, si nuestra instancia de Mastodon es mastodon.social y nuestro bearer es LoXgf4hiWnxMLsBuJidg2I0yZXKKgYBf0FFRSFgWjo0, podríamos programar una publicación con el texto “Feliz 2026” para el 1 de enero de 2026 a las 0:00 GMT con curl de la siguiente manera:

curl -X POST -H "Authorization: Bearer LoXgf4hiWnxMLsBuJidg2I0yZXKKgYBf0FFRSFgWjo0" -d "status=Feliz 2026&visibility=public&language=es&scheduled_at=2026-01-01T00:00:00Z" https://mastodon.social/api/v1/statuses

En esta, ocasión, además, estamos explícitamente estableciendo la visibilidad de la publicación como pública y el lenguaje como castellano, sobrescribiendo cualquier otra preferencia que tengamos para estos valores por defecto.

La lista de parámetros que se pueden usar al crear una nueva publicación, como advertencias de contenido, citar o responder a otras publicaciones, etc., está disponible en la documentación.

Luego podríamos obtener la lista de publicaciones programadas con:

curl -X GET -H "Authorization: Bearer LoXgf4hiWnxMLsBuJidg2I0yZXKKgYBf0FFRSFgWjo0" https://mastodon.social/api/v1/scheduled_statuses

Donde veríamos la publicación que acabamos de crear y podríamos eliminarla o editarla usando las APIs correspondientes.

Recuerda que necesitarás cambiar mastodon.social en esos ejemplos con el nombre del servidor de tu instancia. Y, obviamente, el bearer también.