publora/linkedin-analytics

LinkedIn Analytics

Suivez les impressions, l'engagement et la croissance des abonnés pour vos publications et votre profil LinkedIn, et interagissez avec les publications via des réactions, commentaires et partages. Les statistiques proviennent de l'API REST ; les réactions, commentaires, partages et recherches de mentions sont des outils MCP.

Prérequis

Plans : Fonctionne sur le plan gratuit Starter. Limites et tarifs actuels : publora.com/pricing

Pour commencer

1. Créez un compte sur publora.com/register (gratuit)
2. Connectez LinkedIn via OAuth dans le tableau de bord Publora
3. Obtenez une clé API sur app.publora.com/dashboard/api
4. Connectez votre agent au serveur MCP à https://mcp.publora.com, en vous authentifiant avec Authorization: Bearer sk_VOTRE_CLE_API. Dans Claude Code :

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

Claude Desktop, Cursor, Codex, OpenClaw et le connecteur claude.ai nécessitent chacun un fichier de configuration ou un flux différent : consultez la configuration client pour le chemin exact et l'extrait de code.

API REST de repli

Si le serveur MCP est indisponible ou renvoie des erreurs, utilisez directement l'API REST :

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

Authentification : Utilisez l'en-tête x-publora-key (PAS Authorization: Bearer) :

# Obtenez vos plateformes connectées
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_votre_cle_api"

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

# Obtenez les statistiques du compte
curl -X POST "https://api.publora.com/api/v1/linkedin-account-statistics" \
  -H "x-publora-key: sk_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "queryTypes": "ALL"
  }'

Format de l'ID de plateforme : linkedin-{id} où {id} provient de la réponse de /platform-connections.

Exemples d'IDs : linkedin-Tz9W5i6ZYG, linkedin-abc123xyz

📖 Documentation complète de l'API : docs.publora.com

Outils d'analyse (REST uniquement)

Les analyses LinkedIn ne sont pas exposées en tant qu'outils MCP. Le serveur MCP gère les outils de publication, de médias et d'engagement LinkedIn ; les statistiques résident uniquement sur l'API REST, donc appelez ces points de terminaison directement avec l'en-tête x-publora-key. Demander à un agent un outil MCP linkedin_post_stats échouera : cet outil n'existe pas.

POST /linkedin-post-statistics

Métriques d'engagement pour une publication.

Corps :

• platformId : ID de connexion de la plateforme (ex. linkedin-abc123), provenant de list_connections
• postedId : URN de la publication (urn:li:share:... ou urn:li:ugcPost:...)
• queryTypes (optionnel) : IMPRESSION, MEMBERS_REACHED, RESHARE, REACTION, COMMENT, ou ALL

Retourne : impressions, impressions uniques (membres atteints), réactions, commentaires, partages, et un indicateur cached vous indiquant si les chiffres proviennent du cache.

POST /linkedin-account-statistics

Statistiques agrégées pour le compte.

Corps : platformId, queryTypes optionnel, aggregation optionnel (DAILY ou TOTAL, par défaut TOTAL).

POST /linkedin-followers

Nombre d'abonnés ou croissance dans le temps.

Corps : platformId, period optionnel (lifetime ou daily), dateRange optionnel ({start: {year, month, day}, end: {year, month, day}}).

POST /linkedin-profile-summary

Aperçu combiné du profil : abonnés plus statistiques.

Corps : platformId, dateRange optionnel.

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

Outils d'engagement

linkedin_create_reaction

Réagissez à une publication LinkedIn.

Paramètres :

• postedId : URN de la publication LinkedIn
• platformId : ID de connexion de la plateforme
• reactionType : L'un des suivants :

Type	Description
LIKE	Pouce levé standard
PRAISE	Applaudissements
EMPATHY	Cœur / amour
INTEREST	Ampoule / pertinent
APPRECIATION	Soutien
ENTERTAINMENT	Drôle / rire

linkedin_delete_reaction

Supprimez votre réaction d'une publication.

Paramètres :

• postedId : URN de la publication LinkedIn
• platformId : ID de connexion de la plateforme

linkedin_create_comment

Publiez un commentaire sur une publication LinkedIn (1 250 caractères max).

Paramètres :

• postedId : URN de la publication LinkedIn
• platformId : ID de connexion de la plateforme
• message : Texte du commentaire (1 250 caractères max)
• parentComment (optionnel) : URN du commentaire pour les réponses imbriquées

linkedin_delete_comment

Supprimez un commentaire que vous avez publié.

Paramètres :

• postedId : URN de la publication LinkedIn
• commentId : URN ou ID numérique du commentaire
• platformId : ID de connexion de la plateforme

linkedin_create_reshare

Partagez une publication existante, avec un commentaire optionnel.

Paramètres :

• platformId : ID de connexion de la plateforme
• parent : la publication à partager, sous forme d'URN de partage (urn:li:share:... ou urn:li:ugcPost:...). Notez le nom : cet outil prend parent, pas postedId comme les outils de réaction et de commentaire.
• commentary (optionnel) : votre texte au-dessus du partage, jusqu'à 3 000 caractères
• visibility (optionnel) : PUBLIC ou CONNECTIONS, par défaut PUBLIC. CONNECTIONS est pour les comptes personnels.

Remarque : une URL de flux LinkedIn porte un identifiant activity, qui n'est pas toujours identique à l'identifiant de partage. Utilisez le postedId renvoyé par get_post, et non un identifiant d'activité converti manuellement.

linkedin_list_mentionables

Résolvez des noms en URN nécessaires aux mentions @, pour ne jamais écrire manuellement un identifiant de membre.

Paramètres :

• q (optionnel) : le nom à rechercher
• limit (optionnel) : combien de résultats retourner

Les deux sont optionnels, et cet outil ne prend pas platformId : il recherche dans l'ensemble du compte plutôt que dans une seule connexion.

Exemples de prompts

Revue de performance hebdomadaire

Analyse ma performance LinkedIn des 7 derniers jours.
Montre-moi :
1. Quelles publications ont le mieux performé
2. Les tendances de mon taux d'engagement
3. La croissance des abonnés
4. Des recommandations d'amélioration

Analyse d'une publication

Obtenez les statistiques détaillées de mes 5 dernières publications LinkedIn et identifiez les tendances dans le contenu qui résonne avec mon audience.

Campagne d'engagement

Réagis avec PRAISE à la publication de mon collègue sur sa promotion (urn:li:share:123456) et ajoute un commentaire de félicitations.

Suivi des abonnés

Montre la croissance de mes abonnés LinkedIn des 30 derniers jours. Combien de nouveaux abonnés ai-je gagné chaque semaine ?

Référence des métriques

Métrique	Description
IMPRESSION	Nombre total de fois où le contenu est apparu dans les flux
MEMBERS_REACHED	Membres LinkedIn uniques qui ont vu la publication
RESHARE	Nombre de repartages/partages
REACTION	Nombre total de réactions (tous types confondus)
COMMENT	Nombre de commentaires

Références des taux d'engagement

Taux d'engagement LinkedIn moyens par nombre d'abonnés :

Abonnés	Bon taux d'engagement
< 5 000	3-5 %
5 000-50 000	2-3 %
50 000+	1-2 %

Les publications performantes ont généralement :

• 2 fois vos impressions moyennes
• Un ratio commentaires/réactions supérieur à 10 %
• Un taux d'engagement supérieur à votre référence

Remarques importantes

1. Délai d'analyse : Les analyses LinkedIn peuvent prendre jusqu'à 24 heures pour être complètement remplies. Une interrogation immédiatement après la publication renvoie des données partielles.

2. Formats d'URN : Les URL LinkedIn utilisent urn:li:activity:xxx mais l'API nécessite urn:li:share:xxx ou urn:li:ugcPost:xxx. Utilisez le postedId de la réponse get_post de Publora pour des URN précises.

3. Mise en cache : Les réponses d'analyse peuvent être mises en cache. La réponse inclut un champ cached indiquant si les données proviennent du cache.

4. Limites de taux : LinkedIn a environ 200+ appels API par heure. Implémentez un mécanisme d'attente sur les erreurs 429.

Dépannage

Erreur	Cause	Solution
"Platform ID not found"	ID de connexion invalide	Exécutez list_connections pour obtenir des IDs valides
"Post not found"	Mauvais format d'URN	Utilisez le format urn:li:share: ou urn:li:ugcPost:
429 Too Many Requests	Limite de taux atteinte	Attendez et réessayez avec un backoff exponentiel
"message cannot exceed 1250 characters"	Commentaire trop long	Raccourcissez le commentaire à moins de 1 250 caractères