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