API Tutorial
Cómo obtener analíticas de Google Business por API
Para obtener analíticas de Google Business por API, conecta Google Business 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 Google Business 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 Google Business
En el panel, haz clic en Conectar y elige Google Business. 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 Google Business. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Llama a analytics_unified para las métricas de Google Business
Llama a `analytics_unified` con el ID de conexión, las métricas que quieres y un rango de fechas. Modiva las obtiene de Google Business, 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 Google Business 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 Google Business
Empieza gratisPreguntas frecuentes
¿Son las métricas de Google Business comparables con las de otras plataformas?
Sí — Modiva normaliza las analíticas de Google Business 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 Google Business y redactar el resumen por su cuenta.