API Tutorial
Cómo publicar en Facebook por API
Para publicar en Facebook por API, conecta la cuenta de Facebook 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 Facebook y devuelve el ID de la publicación.
La propia API de Facebook 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 Facebook (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 Facebook
En el panel, haz clic en Conectar y elige Facebook. 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 Facebook. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a posts_create para publicar en Facebook
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 Facebook (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 Facebook 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 Facebook
Empieza gratisPreguntas frecuentes
¿Necesito una app de desarrollador de Facebook para publicar por API?
No. Modiva posee la app de Facebook 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 Facebook 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 Facebook en cuanto añadas tu clave MCP de Modiva.