API Tutorial
Cómo obtener analíticas de Facebook por API
Para obtener analíticas de Facebook por API, conecta Facebook a través de Modiva y luego llama a `analytics_unified` — devuelve alcance, impresiones, engagement y métricas de seguidores en una forma normalizada que puedes visualizar o analizar.
Cada plataforma reporta las métricas de forma distinta, así que el reporting entre plataformas suele implicar una capa de mapeo por red. La herramienta `analytics_unified` de Modiva devuelve las métricas de Facebook en el mismo esquema que cualquier otra plataforma, de modo que una sola consulta impulsa un panel entero.
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 analytics_unified para las métricas de Facebook
Llama a `analytics_unified` con el ID de conexión, las métricas que quieres y un rango de fechas. Modiva las obtiene de Facebook, normaliza los nombres de los campos y devuelve una forma JSON consistente, lista para visualizar.
Agrupa todas las plataformas en un solo informe
Pasa varios ID de conexión para combinar Facebook con el resto de tu stack en una sola respuesta. A través de MCP, un agente puede recuperar las cifras y redactar el informe semanal por ti, y luego llamar a `analytics_best_time_to_post` para programar el siguiente.
Solicitud de ejemplo
Llama a la herramienta analytics_unified 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": "analytics_unified",
"connectionId": "conn_…",
"args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
}'Pruébalo con Facebook
Empieza gratisPreguntas frecuentes
¿Son las métricas de Facebook comparables con las de otras plataformas?
Sí — Modiva normaliza las analíticas de Facebook en un esquema común, de modo que el alcance y el engagement encajan a través de cualquier red conectada.
¿Puede un agente de IA elaborar el informe?
Sí. Expón `analytics_unified` a través de MCP y un agente podrá recuperar las cifras de Facebook y redactar el resumen por su cuenta.