MCP para agentes de IA

ER y guardados

ER = 100 × (likes + comments) / views, redondeado a dos decimales. Usa las últimas observaciones completas de vistas, Me gusta y comentarios. Los totales usan las sumas de contadores, no la media de porcentajes por publicación. ER es null con cero vistas o sin observación completa. Los guardados y las republicaciones no entran en la fórmula.

Las listas, detalles, analítica, publicaciones y creadores de campaña devuelven engagement con scope: accepted_video. Solo incluye vídeos aceptados; la fila de publicación cubre ese vídeo y la de creador, su cuenta. Usa engagement.views como denominador: el totalViews existente puede incluir otros estados o reflejar vistas pagadas.

Las fábricas exponen el ER canónico en metrics.er (totals.er en el resumen) y guardados en metrics.saves. Los puntos del historial y snapshotBaseline contienen los mismos campos. El er anterior de nivel superior conserva su semántica; los clientes nuevos usan el campo anidado. La ausencia de campos nuevos en una respuesta antigua no demuestra una medición.

saves es un contador independiente con el último valor conocido. Las fuentes automáticas son collectCount de TikTok y bookmarkCount de X, solo cuando el proveedor devuelve un valor válido. Las otras plataformas no tienen valor sin una medición real. 0 significa cero medido; null, no disponible. No sustituyas null por cero. El historial antiguo de campaña no demuestra las vistas originales: el nuevo ER estará disponible tras un escaneo normal, sin un reescaneo masivo de pago.

erCoverage y savesCoverage contienen measuredPosts / totalPosts de toda la selección antes de paginar. Una cobertura parcial significa un total parcial. updatedAt y savesUpdatedAt son las fechas más antiguas de las mediciones incluidas; null indica frescura desconocida. Arrastrar un contador anterior a una nueva instantánea no actualiza su fecha. ER y guardados en gráficos son valores absolutos, sin modo de incremento.

hiddenFields de un informe acepta saves: el servidor elimina el contador, su cobertura y fecha. Ocultar views, likes, comments o er elimina también el ER derivado; posts oculta la cobertura y lastScanned las fechas de medición. Se aplica a resúmenes, filas, historial y valores de referencia.

{
  "engagement": {
    "scope": "accepted_video",
    "views": 100,
    "likes": 0,
    "comments": 0,
    "er": 0,
    "saves": null,
    "erCoverage": { "measuredPosts": 1, "totalPosts": 2 },
    "savesCoverage": { "measuredPosts": 0, "totalPosts": 2 },
    "updatedAt": "2026-10-09T08:00:00.000Z",
    "savesUpdatedAt": null
  }
}