API Tutorial
Cómo publicar en Bluesky por API
Para publicar en Bluesky por API, conecta la cuenta de Bluesky a través de Modiva (que se encarga de OAuth y los scopes) y luego llama a la herramienta `posts_create` con tu texto y tus medios — Modiva lo publica en Bluesky y devuelve el ID de la publicación.
La propia API de Bluesky exige revisión de la app, gestión de OAuth y los permisos de publicación correctos antes de que puedas publicar siquiera una actualización. Modiva se ocupa de todo eso por ti y expone una única herramienta `posts_create` que publica en Bluesky (y en cualquier otra plataforma conectada) de la misma manera.
Paso a paso
Crea una cuenta de Modiva y una clave MCP
Regístrate gratis y genera una clave MCP (`mk_live_…`) en el panel. La misma clave autentica tanto el servidor MCP alojado (para agentes de IA) como la API REST (para tu backend), así que solo gestionas una credencial.
Conecta tu cuenta de Bluesky
En el panel, haz clic en Conectar y elige Bluesky. Modiva ejecuta el flujo de OAuth y solicita los scopes adecuados por ti, luego guarda los tokens de acceso y de actualización en una bóveda cifrada y los mantiene al día — nunca manipulas las credenciales de API sin procesar de Bluesky. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a posts_create para publicar en Bluesky
Llama a la herramienta `posts_create` con el ID de conexión y tu contenido. Modiva valida el payload frente a las reglas de formato de Bluesky (longitud, tipos de medios, relaciones de aspecto) y publica al instante, devolviendo el ID y la URL de la publicación en vivo.
Haz más — programa, publica de forma cruzada, automatiza
La misma llamada impulsa a un agente de IA a través de MCP: apunta a Claude o Cursor a `https://mcp.modiva.ai/v1` y podrá publicar en Bluesky en tu nombre. Cambia `posts_create` por `posts_schedule` para ponerlo en cola, o `posts_cross_post` para difundir una publicación a todas las plataformas de una vez.
Solicitud de ejemplo
Llama a la herramienta posts_create a través de la API REST de Modiva. La misma herramienta está disponible para los agentes de IA en el servidor MCP en https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Pruébalo con Bluesky
Empieza gratisPreguntas frecuentes
¿Necesito una app de desarrollador de Bluesky para publicar por API?
No. Modiva posee la app de Bluesky ya revisada y se encarga de OAuth, así que te conectas con un clic y empiezas — sin revisión de la app, sin lidiar con scopes.
¿Puede un agente de IA publicar en Bluesky por mí?
Sí. La misma herramienta `posts_create` se expone a través del Model Context Protocol, de modo que cualquier cliente MCP (Claude, Cursor, etc.) puede publicar en Bluesky en cuanto añadas tu clave MCP de Modiva.