n8n - Ayrshare API Documentation

n8n est l’endroit où vous câblez vos outils entre eux. Ayrshare est l’API unique qui publie sur Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat et X en un seul appel. Connectez-les avec le MCP Server Ayrshare et votre agent IA n8n peut exécuter toute la boucle lui-même : rédiger une publication, la valider par rapport aux règles de chaque réseau, la publier ou la planifier, puis relire les statistiques.

Le workflow de démarrage n8n sur le canevas : un déclencheur de chat vers un AI Agent, avec un modèle de chat Anthropic et le nœud d'outil MCP Ayrshare attachés en dessous, ainsi que des sticky notes de configuration et d'utilisation.

Puisque le MCP Server est un endpoint Streamable HTTP hébergé, vous le connectez avec le nœud MCP Client Tool intégré à n8n. Il n’y a rien à héberger, aucun code personnalisé et aucun nœud communautaire à installer. Vous pointez un nœud vers une URL et votre agent obtient les 27 outils sociaux.

Télécharger le workflow de démarrage n8n

Le workflow présenté ci-dessus, prêt à être importé : Chat Trigger, AI Agent, un modèle de chat Anthropic et le nœud MCP Ayrshare précâblé avec le prompt système « validate-first ».

Pour l’utiliser : dans n8n, Workflows → Import from file, sélectionnez le JSON, puis créez les deux credentials qu’il attend (un credential Bearer Auth contenant votre clé Ayrshare, et un credential Anthropic API). Les deux badges d’avertissement disparaissent une fois les credentials attachés. Les instances auto-hébergées ont besoin d’un accès sortant vers api.ayrshare.com et vers votre fournisseur de modèle. Ce guide couvre le chemin MCP-first de bout en bout. Si vous préférez construire un workflow fixe et non-agent, il y a un court repli REST à la fin.

Pourquoi MCP plutôt qu’écrire des appels d’API

Vous pouvez appeler l’API REST Ayrshare directement depuis un nœud HTTP Request, ce qui convient aux workflows fixes et prévisibles. Le MCP Server prend tout son sens lorsqu’un LLM est dans la boucle :

L’agent choisit l’outil. Décrivez l’objectif (« publie ceci sur nos canaux professionnels et planifie le suivi pour mardi ») et l’agent choisit lui-même validate_post, create_post et les bons paramètres.
Validation avant toute mise en ligne. validate_post teste à blanc votre contenu par rapport aux règles de longueur, de format et de médias de chaque plateforme, de sorte que l’agent ne publie pas une publication qu’un réseau va rejeter.
Un appel, plusieurs réseaux. Un seul create_post se diffuse vers chaque plateforme associée.
Les changements de plateforme sont le problème d’Ayrshare. Lorsqu’un réseau modifie son API, Ayrshare maintient l’intégration et votre workflow continue de fonctionner.
Mêmes règles que l’API REST. Chaque appel d’outil MCP s’exécute en interne via la même chaîne d’API Ayrshare : mêmes auth, limites de débit, quota et validation. Il n’y a pas de comportement distinct à apprendre.

Comment il se connecte

Le nœud AI Agent est le cerveau. Le sous-nœud MCP Client Tool s’attache à lui, se connecte au MCP Server Ayrshare à https://api.ayrshare.com/mcp, découvre les outils disponibles et les expose à l’agent. Lorsque l’agent agit, le nœud distribue l’appel à Ayrshare, qui publie sur les réseaux.

Trigger  ->  AI Agent (+ Chat Model)  ->  MCP Client Tool  ->  Ayrshare MCP Server  ->  13 networks

Pour les détails d’endpoint, de transport et d’authentification, consultez Connect & Setup. Pour la liste complète des outils, consultez le Catalogue des outils.

Prérequis

Une instance n8n (Cloud ou auto-hébergée) sur une version récente avec les nœuds AI Agent et MCP Client Tool. Le nœud MCP Client Tool est intégré. Vous n’avez pas besoin d’un nœud communautaire, car le serveur Ayrshare parle Streamable HTTP.
Un compte Ayrshare et une API Key (Dashboard → Settings → API Key), ou démarrez un essai gratuit.
Au moins un compte social associé dans Ayrshare. L’agent ne peut publier que là où vous êtes connecté.
Un credential de modèle de chat pour le nœud AI Agent (Anthropic, OpenAI, etc.).
(Optionnel) Un Business Plan ou Enterprise Plan si vous allez gérer plusieurs clients via des sous-profils.

Configurer le nœud MCP Client Tool

Ajouter un nœud AI Agent

Ouvrez ou créez un workflow et ajoutez un nœud AI Agent (sous les nœuds Advanced AI).

Attacher le nœud MCP Client Tool

Sur le nœud AI Agent, cliquez sur le connecteur Tool et ajoutez un nœud MCP Client Tool. Configurez-le :

Champ	Valeur
Endpoint	`https://api.ayrshare.com/mcp`
Server Transport	`HTTP Streamable`
Authentication	`Bearer Auth`
Tools to Include	`All` (ou `Selected` pour exposer uniquement des outils spécifiques)

Ajouter votre clé Ayrshare en tant que credential Bearer

Pour Credential, créez un nouveau credential Bearer Auth et collez votre API Key Ayrshare comme jeton. n8n l’envoie sous forme d’Authorization: Bearer YOUR_API_KEY. Lorsque vous enregistrez, n8n se connecte et liste les 27 outils.

Câbler le modèle de chat et le prompt système

Attachez un sous-nœud Chat Model et sélectionnez votre credential de modèle. Donnez à l’agent un prompt système qui fixe les règles, par exemple :

Vous êtes un assistant réseaux sociaux ayant accès aux outils Ayrshare. Avant de publier quoi que ce soit, appelez toujours validate_post en premier et signalez tout problème. N’appelez create_post qu’après validation réussie. Utilisez par défaut les plateformes que l’utilisateur nomme ; si aucune n’est nommée, demandez. N’inventez jamais d’URL de médias ; utilisez uniquement les URL fournies par l’utilisateur, et confirmez-les avec validate_media en cas de doute.

Ajouter un déclencheur

Pour les tests, le Manual Trigger ou le Chat Trigger est le plus simple. Pour la production, utilisez ce qui déclenche le workflow (planification, webhook, formulaire, nouvelle ligne dans une feuille).

Utilisez HTTP Streamable, pas SSE. Le MCP Server Ayrshare utilise le transport moderne Streamable HTTP et est sans état. L’option SSE de n8n est obsolète, et le serveur rejette le flux SSE. Choisissez toujours HTTP Streamable.

La surface d’outils

Votre agent voit les 27 outils via l’unique nœud MCP. Vous les appelez rarement par leur nom ; vous décrivez l’intention et l’agent sélectionne. Les domaines sont Publications, Historique, Statistiques, Commentaires, Messages, Profils, Médias, Génération, Webhooks et Erreurs. Pour la liste complète avec l’objectif et la portée de chaque outil, consultez le Catalogue des outils. Deux se distinguent pour la sécurité : validate_post teste à blanc une publication avec la même entrée que create_post mais ne publie rien, et explain_error transforme n’importe quel code d’erreur Ayrshare en une cause et un correctif en langage clair, afin que l’agent puisse s’auto-diagnostiquer.

Exemple 1 : rédiger, valider et publier depuis un message de chat

Le « hello world » de cette intégration. Déclenchez le workflow avec un message de chat ou un formulaire, et laissez l’agent faire le reste.

Déclencheur : Chat Trigger (ou un Form Trigger avec un champ « que devons-nous publier ? »).
Prompt à l’agent : « Rédige une annonce de lancement conviviale pour notre nouveau tableau de bord de statistiques et publie-la sur LinkedIn, Facebook et Instagram. Valide d’abord. »

Ce que l’agent fait tout seul : il appelle validate_post avec votre texte et les trois plateformes ; si Instagram signale une image manquante, il vous le dit au lieu d’échouer silencieusement ; une fois la validation réussie, il appelle create_post et renvoie les URL des publications en direct. Parce que la validation est exécutée en premier, vous êtes informé d’un problème avant que quoi que ce soit ne soit public.

Exemple 2 : publier automatiquement du nouveau contenu sur vos canaux

Transformez une source de contenu en publications multi-réseaux sans y toucher.

Déclencheur : un nœud RSS Read sur le flux de votre blog, un webhook depuis votre CMS ou une nouvelle ligne dans Google Sheets ou Airtable.
Étape AI Agent : « Résume cet article en une courte publication sociale avec 2 à 3 hashtags pertinents, puis valide et publie sur LinkedIn, Facebook et Threads. »
Ajoutez éventuellement une approbation humain dans la boucle avant l’étape create_post afin qu’une personne valide.

Vous pouvez vous appuyer sur recommend_hashtags pour des tags basés sur les données et sur generate_post si vous voulez qu’Ayrshare rédige le texte plutôt que votre modèle de chat.

Exemple 3 : synthèse hebdomadaire des statistiques

Exécutez la boucle à l’envers : lisez les performances et rendez-en compte.

Déclencheur : nœud Schedule, par exemple chaque lundi à 8 h.
Étape AI Agent : « Récupère les statistiques du compte de la semaine dernière pour LinkedIn, Instagram et Facebook, et résume les 3 meilleures publications par engagement. »
L’agent utilise get_social_network_analytics pour les chiffres au niveau du compte et get_post_analytics pour les publications individuelles, puis vous acheminez son résumé vers un nœud Slack, Gmail ou Notion.

Une note sur la cadence : la plupart des publications reçoivent l’essentiel de leur engagement dans les 24 premières heures, et les métriques ne se mettent pas à jour à la seconde. Une planification quotidienne ou hebdomadaire est amplement suffisante. N’interrogez pas les statistiques toutes les quelques minutes, sinon vous atteindrez les limites de débit pour aucune nouvelle donnée.

Agir au nom des clients (multi-tenant)

Si vous gérez les réseaux sociaux pour plusieurs clients, les profils Ayrshare permettent à un seul compte de publier vers de nombreux ensembles distincts de comptes associés. Sur un Business Plan ou Enterprise Plan, vous avez deux façons de cibler un client depuis n8n :

Par connexion : ajoutez un en-tête Profile-Key au nœud MCP Client Tool (utilisez l’auth Multiple Headers pour pouvoir envoyer à la fois Authorization et Profile-Key). Chaque appel sur ce nœud agit alors en tant que ce client. Bien lorsqu’un workflow sert un seul client.
Par appel : de nombreux outils acceptent un argument profileKey, que l’agent peut définir par action. Lorsque les deux sont présents, l’argument par appel l’emporte. Bien lorsqu’un workflow route vers plusieurs clients.

Pour intégrer un nouveau client, l’agent peut appeler create_profile puis generate_jwt_social_linking_url pour générer une page hébergée où le client associe ses propres comptes. Aucun identifiant ne transite par votre workflow.

Publier sur X/Twitter

Dans n8n, basculez l’Authentication du nœud MCP Client Tool sur Multiple Headers et ajoutez les deux en-têtes X-Twitter-OAuth1-* aux côtés de Authorization. Il s’agit d’une configuration ponctuelle par compte Ayrshare, et la même paire de clés s’applique à chaque profil. Pour tout le reste (Facebook, Instagram, LinkedIn, YouTube, TikTok, et les autres), aucun en-tête supplémentaire n’est nécessaire. Consultez Connect & Setup → Identifiants X/Twitter BYO.

Gardez un humain dans la boucle

Les outils MCP rendent la publication triviale pour un agent, ce qui est précisément pourquoi vous devriez la contrôler. Deux garde-fous peu coûteux :

Toujours valider en premier. Intégrez « appeler validate_post avant create_post » dans le prompt système. La validation ne publie rien et détecte les violations des règles de la plateforme en amont.
Ajouter une étape d’approbation. Insérez le nœud Send and Wait for Response de n8n (Slack ou e-mail) entre le brouillon et l’action de publication afin qu’une personne approuve avant toute mise en ligne. Pour le contenu planifié, l’agent peut utiliser update_post pour réviser une publication en attente d’approbation.

Repli REST (sans agent)

Si vous voulez un workflow fixe et déterministe sans LLM, contournez MCP et appelez l’API REST avec un nœud HTTP Request :

Méthode : POST
URL : https://api.ayrshare.com/api/post
Authentication : Header Auth, Authorization: Bearer YOUR_API_KEY

{
  "post": "Excited to announce our new feature!",
  "platforms": ["facebook", "linkedin", "instagram"],
  "mediaUrls": ["https://example.com/image.jpg"],
  "scheduleDate": "2026-07-01T10:00:00Z"
}

Utilisez l’hôte API api.ayrshare.com, et non l’hôte du tableau de bord app.ayrshare.com. (app.ayrshare.com acceptera les appels d’API, mais ce n’est pas l’endpoint documenté et peut renvoyer des erreurs de passerelle 502/504 intermittentes, alors utilisez toujours api.ayrshare.com.) Le même schéma fonctionne pour les autres endpoints REST. C’est le bon outil lorsque le workflow est entièrement prévisible et que vous n’avez pas besoin qu’un agent décide de quoi que ce soit.

Dépannage

Symptôme	Cause probable	Correctif
L’appel d’outil renvoie `403` / code `102`, « API Key not valid »	API Key incorrecte ou manquante	Vérifiez que le credential Bearer Auth contient exactement votre clé Ayrshare. Réenregistrez le nœud après modification.
n8n ne parvient pas à se connecter au serveur MCP	Transport ou endpoint incorrect	L’endpoint doit être `https://api.ayrshare.com/mcp` ; le transport doit être HTTP Streamable, pas SSE.
La publication X/Twitter échoue avec l’erreur `419`	Identifiants X BYO manquants	Ajoutez les deux en-têtes `X-Twitter-OAuth1-*` via l’auth Multiple Headers.
La publication échoue pour une seule plateforme	Ce réseau n’est pas associé, ou un champ requis est manquant	Associez-le dans le tableau de bord ; ajoutez `title` pour YouTube, `title` + `subreddit` pour Reddit, `mediaUrls` pour Instagram.
Publication Instagram rejetée	Aucun média	Instagram nécessite `mediaUrls` pour la plupart des types de publication. Faites confirmer par l’agent avec `validate_media`.
Un média joint sous forme de fichier ou binaire n’apparaît pas	MCP est en JSON uniquement	Référencez le média par une URL `mediaUrls` publique ; le chemin MCP n’accepte pas les téléversements de fichiers. Confirmez l’URL avec `validate_media`.
Les appels fonctionnent, mais agissent sur le mauvais client	Ciblage de profil	Définissez un en-tête `Profile-Key` (par connexion) ou un argument `profileKey` (par appel) ; l’argument l’emporte si les deux sont définis.
`429 Too Many Requests`	Interrogation trop fréquente	Réduisez la fréquence d’interrogation des statistiques et des commentaires ; les métriques ne se mettent pas à jour à la seconde.
Le changement de configuration n’a pas pris effet	La connexion MCP s’initialise au démarrage de la session	Réenregistrez le nœud ou redémarrez le workflow après avoir modifié la clé ou les en-têtes.

Vous pouvez également exposer l’outil explain_error à l’agent afin qu’il décode lui-même n’importe quel code d’erreur Ayrshare en une cause et un correctif.

Étapes suivantes

Connect & Setup

Endpoint, transport, authentification, ciblage de profil et identifiants BYO.

Tool Catalog

Les 27 outils regroupés par domaine, avec leur portée et leur objectif.

MCP Server

Ce qu’est le MCP Server et comment il correspond à l’API Ayrshare.

Claude Code Plugin

Le même serveur, empaqueté pour Claude Code.

Télécharger le workflow de démarrage n8n

​Pourquoi MCP plutôt qu’écrire des appels d’API

​Comment il se connecte

​Prérequis

​Configurer le nœud MCP Client Tool

​La surface d’outils

​Exemple 1 : rédiger, valider et publier depuis un message de chat

​Exemple 2 : publier automatiquement du nouveau contenu sur vos canaux

​Exemple 3 : synthèse hebdomadaire des statistiques

​Agir au nom des clients (multi-tenant)

​Publier sur X/Twitter

​Gardez un humain dans la boucle

​Repli REST (sans agent)

​Dépannage

​Étapes suivantes

Connect & Setup

Tool Catalog

MCP Server

Claude Code Plugin

Pourquoi MCP plutôt qu’écrire des appels d’API

Comment il se connecte

Prérequis

Configurer le nœud MCP Client Tool

La surface d’outils

Exemple 1 : rédiger, valider et publier depuis un message de chat

Exemple 2 : publier automatiquement du nouveau contenu sur vos canaux

Exemple 3 : synthèse hebdomadaire des statistiques

Agir au nom des clients (multi-tenant)

Publier sur X/Twitter

Gardez un humain dans la boucle

Repli REST (sans agent)

Dépannage

Étapes suivantes