publora/linkedin-analytics

LinkedIn Analytics (Análisis de LinkedIn)

Monitorea impresiones, interacción y crecimiento de seguidores para tus publicaciones y perfil de LinkedIn, e interactúa con publicaciones a través de reacciones, comentarios y compartidos. Las estadísticas provienen de la API REST; las reacciones, comentarios, compartidos y búsquedas de menciones son herramientas MCP.

Requisitos previos

Planes: Funciona con el plan Starter gratuito. Límites y precios actuales: publora.com/pricing

Primeros pasos

1. Crea una cuenta en publora.com/register (gratuita)
2. Conecta LinkedIn mediante OAuth en el Panel de Publora
3. Obtén una clave API en app.publora.com/dashboard/api
4. Conecta tu agente al servidor MCP en https://mcp.publora.com, autenticando con Authorization: Bearer sk_TU_CLAVE_API. En Claude Code:

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_TU_CLAVE_API"

Claude Desktop, Cursor, Codex, OpenClaw y el conector de claude.ai requieren un archivo de configuración o flujo diferente: consulta la guía de configuración para clientes para la ruta y el fragmento exactos.

Alternativa con API REST

Si el servidor MCP no está disponible o devuelve errores, usa la API REST directamente:

URL base: https://api.publora.com/api/v1

Autenticación: Usa el encabezado x-publora-key (NO Authorization: Bearer):

# Obtén tus plataformas conectadas
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_tu_clave_api"

# Obtén estadísticas de una publicación
curl -X POST "https://api.publora.com/api/v1/linkedin-post-statistics" \
  -H "x-publora-key: sk_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "postedId": "urn:li:share:7123456789012345678",
    "queryTypes": "ALL"
  }'

# Obtén estadísticas de la cuenta
curl -X POST "https://api.publora.com/api/v1/linkedin-account-statistics" \
  -H "x-publora-key: sk_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "queryTypes": "ALL"
  }'

Formato del ID de plataforma: linkedin-{id} donde {id} proviene de la respuesta de /platform-connections.

Ejemplos de ID: linkedin-Tz9W5i6ZYG, linkedin-abc123xyz

📖 Documentación completa de la API: docs.publora.com

Herramientas de Análisis (solo REST)

Las analíticas de LinkedIn no están expuestas como herramientas MCP. El servidor MCP proporciona herramientas para publicar, medios e interacción en LinkedIn; las estadísticas solo están disponibles en la API REST, por lo que debes llamar directamente a estos endpoints con el encabezado x-publora-key. Solicitar a un agente una herramienta MCP linkedin_post_stats fallará: no existe tal herramienta.

POST /linkedin-post-statistics

Métricas de interacción para una publicación.

Cuerpo:

• platformId: ID de conexión de plataforma (ej. linkedin-abc123), de list_connections
• postedId: URN de la publicación (urn:li:share:... o urn:li:ugcPost:...)
• queryTypes (opcional): IMPRESSION, MEMBERS_REACHED, RESHARE, REACTION, COMMENT o ALL

Devuelve: impresiones, impresiones únicas (miembros alcanzados), reacciones, comentarios, compartidos y un indicador cached que indica si los datos provienen de caché.

POST /linkedin-account-statistics

Estadísticas agregadas de la cuenta.

Cuerpo: platformId, queryTypes opcional, aggregation opcional (DAILY o TOTAL, por defecto TOTAL).

POST /linkedin-followers

Número de seguidores o crecimiento en el tiempo.

Cuerpo: platformId, period opcional (lifetime o daily), dateRange opcional ({start: {year, month, day}, end: {year, month, day}}).

POST /linkedin-profile-summary

Resumen combinado del perfil: seguidores más estadísticas.

Cuerpo: platformId, dateRange opcional.

curl -X POST "https://api.publora.com/api/v1/linkedin-post-statistics" \
  -H "x-publora-key: sk_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"platformId": "linkedin-abc123", "postedId": "urn:li:share:7123456789012345678", "queryTypes": "ALL"}'

Herramientas de Interacción

linkedin_create_reaction (crear_reacción)

Reaccionar a una publicación de LinkedIn.

Parámetros:

• postedId: URN de la publicación de LinkedIn
• platformId: ID de conexión de plataforma
• reactionType: Uno de los siguientes:

Tipo	Descripción
LIKE	Pulgar arriba estándar
PRAISE	Manos aplaudiendo / aplauso
EMPATHY	Corazón / amor
INTEREST	Bombilla / perspicaz
APPRECIATION	De apoyo
ENTERTAINMENT	Divertido / risa

linkedin_delete_reaction (eliminar_reacción)

Elimina tu reacción de una publicación.

Parámetros:

• postedId: URN de la publicación de LinkedIn
• platformId: ID de conexión de plataforma

linkedin_create_comment (crear_comentario)

Publica un comentario en una publicación de LinkedIn (máx. 1,250 caracteres).

Parámetros:

• postedId: URN de la publicación de LinkedIn
• platformId: ID de conexión de plataforma
• message: Texto del comentario (máx. 1,250 caracteres)
• parentComment (opcional): URN del comentario para respuestas anidadas

linkedin_delete_comment (eliminar_comentario)

Elimina un comentario que hayas hecho.

Parámetros:

• postedId: URN de la publicación de LinkedIn
• commentId: URN del comentario o ID numérico
• platformId: ID de conexión de plataforma

linkedin_create_reshare (crear_compartido)

Comparte una publicación existente, con comentario opcional.

Parámetros:

• platformId: ID de conexión de plataforma
• parent: la publicación a compartir, como una URN de compartido (urn:li:share:... o urn:li:ugcPost:...). Nota el nombre: esta herramienta usa parent, no postedId como las herramientas de reacción y comentario.
• commentary (opcional): tu texto sobre el compartido, hasta 3,000 caracteres
• visibility (opcional): PUBLIC o CONNECTIONS, por defecto PUBLIC. CONNECTIONS es para cuentas personales.

Nota: una URL de feed de LinkedIn lleva un ID de activity, que no siempre es el mismo que el ID de compartido. Usa el postedId devuelto por get_post, no un ID de actividad convertido manualmente.

linkedin_list_mentionables (listar_mencionables)

Resuelve nombres a las URN que necesitan las @menciones, para que nunca tengas que escribir manualmente un ID de miembro.

Parámetros:

• q (opcional): el nombre a buscar
• limit (opcional): cuántos resultados devolver

Ambos son opcionales, y esta herramienta no necesita platformId: busca en toda la cuenta en lugar de en una conexión.

Ejemplos de Prompts

Revisión de rendimiento semanal

Analiza mi rendimiento en LinkedIn de los últimos 7 días.
Muéstrame:
1. Qué publicaciones tuvieron mejor rendimiento
2. Mis tendencias de tasa de interacción
3. Crecimiento de seguidores
4. Recomendaciones para mejorar

Análisis de publicaciones

Obtén estadísticas detalladas de mis últimas 5 publicaciones de LinkedIn e identifica patrones en el contenido que resuena con mi audiencia.

Campaña de interacción

Reacciona con PRAISE a la publicación de mi colega sobre su ascenso (urn:li:share:123456) y añade un comentario de felicitación.

Seguimiento de seguidores

Muestra mi crecimiento de seguidores en LinkedIn de los últimos 30 días. ¿Cuántos seguidores nuevos gané cada semana?

Referencia de Métricas

Métrica	Descripción
IMPRESSION	Veces totales que el contenido apareció en feeds
MEMBERS_REACHED	Miembros únicos de LinkedIn que vieron la publicación
RESHARE	Número de reposteos/compartidos
REACTION	Reacciones totales (todos los tipos combinados)
COMMENT	Número de comentarios

Puntos de Referencia de Tasa de Interacción

Tasas de interacción promedio en LinkedIn por número de seguidores:

Seguidores	Buena Tasa de Interacción
< 5K	3-5%
5K-50K	2-3%
50K+	1-2%

Las publicaciones con buen rendimiento típicamente tienen:

• 2x tus impresiones promedio
• Relación comentario-reacción superior al 10%
• Tasa de interacción por encima de tu línea base

Notas Importantes

1. Retraso en analíticas: Las analíticas de LinkedIn pueden tardar hasta 24 horas en poblarse completamente. Consultar inmediatamente después de publicar devuelve datos parciales.

2. Formatos de URN: Las URL de LinkedIn usan urn:li:activity:xxx pero la API requiere urn:li:share:xxx o urn:li:ugcPost:xxx. Usa el postedId de la respuesta de get_post de Publora para URNs precisos.

3. Caché: Las respuestas de analíticas pueden estar en caché. La respuesta incluye un campo cached que indica si los datos provienen de caché.

4. Límites de tasa: LinkedIn tiene aproximadamente 200+ llamadas API por hora. Implementa retroceso en errores 429.

Solución de problemas

Error	Causa	Solución
"Platform ID not found"	ID de conexión inválido	Ejecuta list_connections para obtener IDs válidos
"Post not found"	Formato de URN incorrecto	Usa formato urn:li:share: o urn:li:ugcPost:
429 Too Many Requests	Límite de tasa excedido	Espera y reintenta con retroceso exponencial
"message cannot exceed 1250 characters"	Comentario demasiado largo	Acorta el comentario a menos de 1,250 caracteres