API Tutorial
Cómo programar publicaciones de YouTube por API
Para programar publicaciones de YouTube por API, conecta YouTube 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 YouTube a esa hora.
Programar significa guardar una publicación y publicarla más tarde de forma fiable — algo que la API de YouTube deja enteramente en tus manos. Modiva opera la cola, reintenta ante errores transitorios de YouTube 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 YouTube
En el panel, haz clic en Conectar y elige YouTube. 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 YouTube. 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 YouTube 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 YouTube 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 YouTube
Empieza gratisPreguntas frecuentes
¿El programador lo opera Modiva o yo?
Modiva. En cuanto llamas a `posts_schedule`, Modiva guarda el trabajo y publica en YouTube 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 YouTube y para cualquier otra plataforma, adaptada al formato de cada una.