API Tutorial
Cómo programar publicaciones de X por API
Para programar publicaciones de X por API, conecta X a través de Modiva y luego llama a `posts_schedule` con tu contenido y una marca de tiempo `publish_at` — Modiva lo pone en cola y lo publica automáticamente en X a esa hora.
Programar significa guardar una publicación y publicarla más tarde de forma fiable — algo que la API de X deja enteramente en tus manos. Modiva opera la cola, reintenta ante errores transitorios de X y expone una única herramienta `posts_schedule` que funciona igual en cualquier plataforma.
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 X
En el panel, haz clic en Conectar y elige X. 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 X. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a posts_schedule con una hora publish_at
Llama a `posts_schedule` con el ID de conexión, tu contenido y una marca de tiempo `publish_at` en formato ISO. Modiva guarda el trabajo y publica en X a esa hora, encargándose de la renovación de tokens y los reintentos sin que tengas tu propio cron.
Encuentra el mejor momento y agrupa un calendario
Llama a `analytics_best_time_to_post` para elegir una franja horaria y luego programa una semana entera en un bucle. A través de MCP, un agente de IA puede planificar y poner en cola un calendario de contenido completo de X a partir de un solo prompt.
Solicitud de ejemplo
Llama a la herramienta posts_schedule 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_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Pruébalo con X
Empieza gratisPreguntas frecuentes
¿El programador lo opera Modiva o yo?
Modiva. En cuanto llamas a `posts_schedule`, Modiva guarda el trabajo y publica en X a la hora deseada — no necesitas tu propia cola ni cron.
¿Puedo programar la misma publicación para varias plataformas?
Sí — pasa varios ID de conexión (o usa `posts_cross_post`) y Modiva programa la publicación para X y para cualquier otra plataforma, adaptada al formato de cada una.