n8n-nodes-metricool-connector

n8n-nodes-metricool

Un nœud communautaire n8n pour intégrer l'API Metricool, avec un focus spécial sur Instagram (posts, stories, reels, commentaires et analyses).

Table des matières

• Installation
• Configuration
• Fonctionnalités
• Opérations Instagram
• Exemples d'utilisation
• Support des endpoints
• Contribution
• Licence

Installation

Via n8n Community Nodes

• Ouvrez votre interface n8n
• Allez dans Settings → Community Nodes
• Installez le package: n8n-nodes-metricool

Via npm/pnpm

# Si vous utilisez pnpm (recommandé)
pnpm install n8n-nodes-metricool

# Si vous utilisez npm
npm install n8n-nodes-metricool

Installation manuelle

• Clonez ce dépôt
• Construisez le projet
• Liez le package à votre installation n8n

git clone https://github.com/fabienbibe/n8n-nodes-metricool.git
cd n8n-nodes-metricool
pnpm install
pnpm build
pnpm link --global

Configuration

Obtenir les credentials Metricool

Pour utiliser cette intégration, vous avez besoin de trois informations de votre compte Metricool :

• User Token : Jeton d'authentification unique

  • Trouvé dans les paramètres de votre compte Metricool
  • Utilisé dans l'en-tête X-Mc-Auth

• User ID : Identifiant de votre utilisateur

  • Visible dans l'URL de votre tableau de bord Metricool

• Blog ID : Identifiant de votre marque/brand

  • Visible dans l'URL lorsque vous sélectionnez une marque
  • Correspond à l'ID de la marque que vous voulez analyser

Configuration dans n8n

• Ajoutez un nœud Metricool à votre workflow
• Créez une nouvelle credential Metricool API
• Renseignez les trois champs requis :
  • User Token
  • User ID
  • Blog ID
• Testez la connexion

Fonctionnalités

🔧 Ressources supportées

• Instagram : Analyse complète des posts, stories, reels et hashtags
• Brand : Gestion des marques associées au compte
• Scheduler : Planification et gestion des publications
• Analytics : Métriques temporelles et analyses avancées

📊 Opérations Instagram

Posts Instagram

• Récupération des posts avec métriques détaillées
• ✅ NOUVEAU : Détection de nouveaux commentaires en temps quasi-réel
• Analyse des commentaires et engagement
• Support des hashtags et leur performance
• Métriques : likes, commentaires, partages, impressions, portée

Stories Instagram

• Récupération des stories avec métriques
• ✅ NOUVEAU : Surveillance des nouvelles réponses aux stories
• Analyse des interactions (taps, exits, replies)
• Métriques d'impressions et de portée
• Support des stories payantes

Reels Instagram

• Analyse complète des reels
• Métriques de vues vidéo et engagement
• Portée et impressions détaillées
• Performance des reels payants

Hashtags Performance

• Analyse de la performance des hashtags utilisés
• Tendances et efficacité par période
• Optimisation du contenu basée sur les données

⚡ Triggers en temps réel

• Détection de commentaires : Alerte dès qu'un nouveau commentaire apparaît
• Surveillance d'engagement : Notification si l'engagement dépasse un seuil
• Réponses aux stories : Détection des nouvelles réponses
• Filtrage intelligent : Par mots-clés, sentiment, ou niveau d'engagement

Exemples d'utilisation

1. Analyser les posts Instagram de la semaine

{
  "resource": "instagram",
  "operation": "getPosts",
  "startDate": "2024-09-20T00:00:00",
  "endDate": "2024-09-27T23:59:59",
  "timezone": "Europe/Paris",
  "additionalFields": {
    "includeComments": true,
    "includeHashtags": true,
    "limit": 50
  }
}

2. Récupérer les stories avec métriques

{
  "resource": "instagram",
  "operation": "getStories", 
  "startDate": "2024-09-25T00:00:00",
  "endDate": "2024-09-27T23:59:59",
  "timezone": "Europe/Paris"
}

3. Planifier une publication multi-plateformes

{
  "resource": "scheduler",
  "operation": "createPost",
  "postText": "Nouvelle publication depuis n8n! 🚀 #automation #metricool",
  "publicationDate": "2024-09-28T14:30:00",
  "providers": ["instagram", "facebook", "twitter"],
  "mediaUrl": "https://example.com/image.jpg"
}

4. Obtenir les métriques d'évolution des followers

{
  "resource": "analytics",
  "operation": "getTimelineMetrics",
  "metric": "igFollowers",
  "startDate": "2024-09-01T00:00:00",
  "endDate": "2024-09-27T23:59:59"
}

5. Analyser la performance des hashtags

{
  "resource": "instagram",
  "operation": "getHashtagsPerformance",
  "startDate": "2024-09-01T00:00:00",
  "endDate": "2024-09-27T23:59:59",
  "timezone": "Europe/Paris"
}

Support des endpoints

Endpoints Instagram implementés

Endpoint	Operation	Description
GET /v2/analytics/posts/instagram	getPosts	Posts Instagram avec métriques
GET /v2/analytics/stories/instagram	getStories	Stories Instagram avec métriques
GET /v2/analytics/reels/instagram	getReels	Reels Instagram avec métriques
GET /v2/analytics/posts/instagram/hashtags	getHashtagsPerformance	Performance des hashtags

Autres endpoints supportés

Endpoint	Operation	Description
GET /admin/simpleProfiles	getBrands	Liste des marques
POST /v2/scheduler/posts	createPost	Planifier une publication
GET /v2/scheduler/posts	getScheduledPosts	Publications planifiées
GET /v2/scheduler/besttimes/{provider}	getBestTimes	Meilleurs moments pour publier
GET /stats/timeling/{metric}	getTimelineMetrics	Évolution des métriques

Métriques Instagram disponibles

Métriques des posts

• likes : Nombre de likes
• comments : Nombre de commentaires
• shares : Nombre de partages
• saved : Nombre de sauvegardes
• impressions : Impressions
• reach : Portée
• engagement : Taux d'engagement
• interactions : Interactions totales

Métriques des stories

• impressions : Impressions
• reach : Portée
• replies : Réponses
• exits : Sorties
• tapsForward : Taps vers l'avant
• tapsBack : Taps vers l'arrière

Métriques des reels

• views : Vues
• videoViews : Vues vidéo
• likes : Likes
• comments : Commentaires
• shares : Partages
• saved : Sauvegardes
• engagement : Engagement
• impressions : Impressions
• reach : Portée

Workflows d'exemple

Analyse quotidienne automatisée

Créez un workflow qui :

• Se déclenche chaque jour à 9h00
• Récupère les métriques Instagram des dernières 24h
• Envoie un rapport par email ou Slack
• Stocke les données dans une base de données

Optimisation du contenu

Workflow pour :

• Analyser la performance des hashtags
• Identifier les meilleurs moments pour publier
• Planifier automatiquement le contenu aux heures optimales
• Suivre les métriques en temps réel

Gestion multi-comptes

Pour les agences gérant plusieurs clients :

• Boucle sur plusieurs credentials Metricool
• Collecte les métriques de tous les comptes
• Génère des rapports consolidés
• Alerte en cas de baisse d'engagement

🚨 NOUVEAUTÉ : Détection en temps réel !

Nœuds Trigger ajoutés :

Metricool Trigger

• ✅ Détection de nouveaux commentaires sur les posts Instagram
• ✅ Surveillance des réponses aux stories Instagram
• ✅ Alertes d'engagement élevé configurables
• ✅ Polling intelligent avec intervalle personnalisable (minimum 30s)

Metricool Webhook (si supporté par l'API)

• ✅ Réception de webhooks pour événements en temps réel
• ✅ Filtrage par mots-clés dans les commentaires
• ✅ Seuils d'engagement personnalisables
• ✅ Enrichissement automatique des données

Cas d'usage de détection :

• 🔔 Alertes de nouveaux commentaires - Notification instantanée
• 📈 Surveillance d'engagement - Détecter les pics d'activité
• 😊 Analyse de sentiment - Identifier les commentaires négatifs
• 🚨 Gestion de crise - Réaction rapide aux problèmes
• 📊 Métriques en temps réel - Suivi de performance live

Exemple de workflow de détection :

{
  "trigger": "MetricoolTrigger",
  "config": {
    "resource": "instagramComments", 
    "event": "newComment",
    "pollInterval": 60,
    "lookBackTime": 300
  },
  "actions": [
    "Analyser sentiment",
    "Envoyer alerte Slack",  
    "Email si urgent",
    "Logger dans CRM"
  ]
}

Limitations connues

• Commentaires détaillés : L'API Metricool ne fournit pas les détails individuels des commentaires, seulement le nombre total
• Messages privés : Pas d'endpoint direct pour les messages privés Instagram dans l'API actuelle (mais détection d'augmentation possible via polling)
• Rate Limiting : Respectez les limites de l'API Metricool (non documentées publiquement)
• Délai de détection : Le polling a un délai minimum de 30 secondes (pas de vraie temps réel)

Roadmap

Prochaines fonctionnalités

• Support des autres plateformes (TikTok, LinkedIn, YouTube)
• Endpoints de gestion des concurrents
• Analyses avancées et rapports personnalisés
• Webhooks pour les notifications en temps réel
• Support des campagnes publicitaires
• Intégration avec les boards Pinterest

Améliorations prévues

• Gestion d'erreur plus granulaire
• Cache des résultats pour optimiser les performances
• Support du pagination pour les grandes datasets
• Validation des paramètres d'entrée
• Tests unitaires et d'intégration

Contribution

Les contributions sont les bienvenues ! Voici comment contribuer :

• Forkez le projet
• Créez une branche pour votre fonctionnalité (git checkout -b feature/AmazingFeature)
• Committez vos changements (git commit -m 'Add some AmazingFeature')
• Poussez vers la branche (git push origin feature/AmazingFeature)
• Ouvrez une Pull Request

Développement local

# Cloner le projet
git clone https://github.com/fabienbibe/n8n-nodes-metricool.git
cd n8n-nodes-metricool

# Installer les dépendances
pnpm install

# Développement avec watch mode
pnpm dev

# Linter et formatter
pnpm lint
pnpm format

# Build
pnpm build

Support

• 📖 Documentation Metricool API
• 🐛 Signaler un bug
• 💬 Discussions
• 📧 Email: [e-mail]

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Développé avec ❤️ pour la communauté n8n

Mots-clés : n8n, metricool, instagram, analytics, social media, automation, marketing, workflows