Le MCP Server Ayrshare expose 27 outils, regroupés ci-dessous par domaine. Chaque outil est distribué en interne via la véritable chaîne d’API Ayrshare.
Portée
Chaque outil est de portée Profile ou Account :
- Profile — l’outil accepte un argument
profileKey pour cibler un sous-profil. - Account — l’outil ne prend pas de
profileKey ; il opère au niveau du compte.
Les six outils qui ne prennent aucun argument profileKey sont : create_profile, list_profiles, explain_error, validate_media, generate_post et recommend_hashtags. Tous les autres outils acceptent un profileKey ; generate_jwt_social_linking_url en requiert un. Remarque : recommend_hashtags ne prend aucun argument profileKey, mais lit tout de même l’en-tête Profile-Key de la connexion pour choisir le compte TikTok associé sur lequel s’appuyer, de sorte que ses résultats sont spécifiques au profil.
Lorsque à la fois un argument profileKey par appel et un en-tête Profile-Key sont présents, l’argument l’emporte. Consultez Connect & Setup pour les règles de priorité.
Publications
| Outil | Portée | Objectif |
|---|
create_post | Profile | Publier sur une ou plusieurs plateformes associées. |
validate_post | Profile | Validation à blanc, avec la même entrée que create_post. |
get_post | Profile | Récupérer une publication par Ayrshare Post ID. |
update_post | Profile | Mettre à jour une publication planifiée ou en attente d’approbation. |
retry_post | Profile | Renvoyer une publication qui a échoué. |
Historique
| Outil | Portée | Objectif |
|---|
get_post_history | Profile | Publications envoyées via Ayrshare. |
get_platform_history | Profile | Publications et statistiques directement depuis le réseau, y compris les publications non-Ayrshare. Pour une recherche X/Twitter par userId/userName, utilisez uniquement l’API Key du compte ; un argument profileKey ou un en-tête Profile-Key renvoie l’erreur 400. |
Statistiques
| Outil | Portée | Objectif |
|---|
get_post_analytics | Profile | Métriques par publication, par Ayrshare Post ID. |
get_post_analytics_by_social_id | Profile | Métriques par publication, par Social Post ID natif. |
get_social_network_analytics | Profile | Statistiques et données démographiques à l’échelle du compte pour un compte social connecté. Pour une recherche X/Twitter par userId/userName, utilisez uniquement l’API Key du compte ; un argument profileKey ou un en-tête Profile-Key renvoie l’erreur 400. |
| Outil | Portée | Objectif |
|---|
get_comments | Profile | Lire les commentaires sur une publication. |
add_comment | Profile | Commentaire de premier niveau. |
reply_comment | Profile | Répondre à un commentaire. |
Messages / DM
| Outil | Portée | Objectif |
|---|
get_messages | Profile | Récupérer les DM pour une plateforme. |
send_message | Profile | Envoyer un DM. |
get_auto_response | Profile | Lire les paramètres de réponse automatique aux DM. |
set_auto_response | Profile | Configurer la réponse automatique aux DM. |
Profils
| Outil | Portée | Objectif |
|---|
list_profiles | Account | Lister les sous-profils. |
create_profile | Account | Créer un sous-profil. |
generate_jwt_social_linking_url | Profile | Générer une URL d’association sociale JWT (nécessite profileKey). |
Médias
| Outil | Portée | Objectif |
|---|
validate_media | Account | Vérifier via HEAD qu’une URL de média est accessible ; renvoie contentType. |
Génération
| Outil | Portée | Objectif |
|---|
generate_post | Account | Rédiger un brouillon de publication par IA. |
recommend_hashtags | Account | Suggestions de hashtags à partir des données de nombre de vues TikTok. Utilise le compte TikTok associé au profil défini par l’en-tête Profile-Key ; ne prend aucun profileKey par appel. |
Webhooks
| Outil | Portée | Objectif |
|---|
register_webhook | Profile | Enregistrer un webhook. |
unregister_webhook | Profile | Désenregistrer un webhook. |
list_webhooks | Profile | Lister les webhooks enregistrés. |
Erreurs
| Outil | Portée | Objectif |
|---|
explain_error | Account | Décoder un code d’erreur Ayrshare en cause, classification et correctif. |
Ce catalogue est vérifié par rapport au tools/list du serveur en direct. D’autres outils sont prévus (par exemple des outils Links). En cas de doute, interrogez tools/list pour obtenir l’ensemble faisant autorité. Le catalogue est maintenu par l’équipe MCP Server.
