Référence des outils MCP SosoAPI

Partez de la tâche, puis examinez l’outil

Réutilisez les identifiants d’espace de travail et de compte déjà sélectionnés. Pour une publication avec URL d’image, appelez sosoapi_post_image_url une fois et conservez l’identifiant de publication renvoyé. Téléversez les fichiers locaux avec sosoapi_upload_asset sur stdio. Pour une publication texte, utilisez sosoapi_create_scheduled_post avec le provider_payload de la destination et media vide.

Demandez à l’utilisateur de vérifier le compte, le texte, les médias et l’heure avant l’envoi. OAuth autorise les actions ; il n’approuve pas le contenu. Après la programmation, lisez le résultat de la même publication avant d’annoncer une réussite ou de réessayer une requête au résultat incertain.

• Configurer Claude Code ou Codex
• Guide texte et image Threads
• Matrice des capacités des plateformes
• Télécharger les schémas d’entrée core exacts et les annotations (JSON)

Comment lire cette référence

La compilation connecte le véritable serveur MCP à un client en mémoire, liste ses outils sans appeler de gestionnaire et rassemble les exigences des routes publiques. Une projection périmée fait échouer la compilation Landing. Les descriptions des outils conservent le contrat anglais du serveur ; les résumés d’achèvement expliquent les règles des routes canoniques. Le JSON conserve toutes les exigences des routes. Le tableau des entrées est un index, pas un remplacement du JSON Schema imbriqué complet.

Les annotations MCP sont des indications pour les clients, pas des contrôles ni des garanties de sécurité. L’appartenance à l’espace, les autorisations, le rôle actuel, le consentement du fournisseur, l’éligibilité du compte et les quotas restent applicables à l’exécution. Certaines lectures de contexte peuvent créer un premier espace de travail ; examinez la description et readOnlyHint au lieu de supposer que chaque « get » est une simple lecture. Les outils composites listent les exigences de leurs routes principales et de compatibilité ; ils n’appellent pas chaque route à chaque requête.

• sosoapi sur npm
• Registre MCP officiel : ai.sosoapi/sosoapi (JSON)

sosoapi_bulk_create_scheduled_posts

Programmer des publications pour plusieurs comptes en un appel (targets). Les médias nécessitent des asset_ids téléversés/importés prêts et leurs URL canoniques. Chaque cible réussit ou échoue indépendamment et figure dans successes ou failures. Nécessite la capacité publish.

• Transport : stdio, http.
• Autorisation requise : agent:publish. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat final de publication ; une programmation acceptée reste en attente.

sosoapi_cancel_scheduled_post

Annuler une publication programmée qui n’a pas encore été diffusée afin qu’elle ne parte jamais. Une publication déjà diffusée est refusée, et un agent ne peut pas non plus supprimer du contenu publié : l’utilisateur le fait dans l’application web. Nécessite expected_version.

• Transport : stdio, http.
• Autorisation requise : agent:publish. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat final de publication ; une programmation acceptée reste en attente.

sosoapi_create_comment

Mettre en file un commentaire exact sur une cible canonique de publication ou de commentaire ; le statut ne signifie pas réussite chez le fournisseur.

• Transport : stdio, http.
• Autorisation requise : agent:engage. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat confirmé par la plateforme ; une action en file reste en attente.

sosoapi_create_scheduled_post

Programmer un compte à scheduled_at avec provider_payload. Les médias nécessitent un asset_id prêt et une URL canonique ; pour une seule image source, utilisez sosoapi_post_image_url. Associez local_scheduled_at à schedule_dst_disambiguation ou omettez les deux. Nécessite publish, le rôle editor et idempotency_key. Programmée ne signifie pas publiée : consultez son résultat.

• Transport : stdio, http.
• Autorisation requise : agent:publish. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat final de publication ; une programmation acceptée reste en attente.

sosoapi_get_asset

Lire une ressource par id : métadonnées et URL d’aperçu de courte durée.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_get_asset_import_status

Lire une importation par import_id. Pour publier, fournir include_asset=true : un résultat ready inclut l’identifiant de ressource enregistré, kind et l’asset_url stable, évitant un get_asset distinct. Une ressource en attente ou manquante ne peut pas être programmée. N’utilisez jamais l’URL source ou d’aperçu comme identité du média. En cas de blocage, lire sosoapi_job_status avec job_id ; ne lancez jamais d’importation en double.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_get_billing_status

Lire le forfait de l’utilisateur, l’état du paiement, les dates du cycle actuel et les quotas utilisés (publications réussies, publications programmées en attente, comptes connectés). Vérifiez-les avant de programmer un grand nombre de publications.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : contexte du compte ; aucun rôle fixe dans l’espace de travail.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_get_comment_action_status

Lire le reçu final expurgé d’une action directe sur un commentaire.

• Transport : stdio, http.
• Autorisation requise : agent:engage. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat confirmé par la plateforme ; une action en file reste en attente.

sosoapi_get_organization_context

Lire la cartographie actuelle de vos organisations, de leurs espaces de travail et canaux, avec leurs identifiants et rôles. Utilisez-la lorsque les identifiants d’organisation ou de canal sont nécessaires. Pour publier dans un espace de travail, réutilisez un identifiant d’espace de travail renvoyé ; ne lisez pas aussi le contexte de l’espace de travail.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : contexte du compte ; aucun rôle fixe dans l’espace de travail.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_get_provider_insight_status

Lire une demande de statistiques (request_id) : queued, processing, completed (avec le résultat du fournisseur et la disponibilité par métrique) ou failed.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat de la plateforme ou la raison de son indisponibilité.

sosoapi_get_scheduled_post

Lire une publication programmée par id : contenu, statut, état de diffusion et résultats. Sa version est nécessaire aux opérations de mise à jour, de publication, de nouvelle tentative et d’annulation sous expected_version.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_get_scheduled_post_eligibility

Contrôle préalable en lecture seule par destination. Inclure draft (caption, hashtags, scheduled_at, display_timezone, heure locale/DST facultative) pour vérifier le contenu et le moment ; include_quota=true ajoute un aperçu indicatif des quotas de la période. Téléversez/importez les médias et attendez qu’ils soient prêts. Sans draft, seuls le compte et les médias sont vérifiés. Ne réserve rien ; la création et la diffusion vérifient à nouveau les limites et les droits.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_get_workspace_context

Lister les espaces de travail de l’utilisateur connecté et indiquer celui qui est actif. Utilisez cet outil lorsque workspace_id est inconnu ; réutilisez le contexte actuel sans répéter les deux lectures de contexte. L’espace actif indiqué est celui qu’une personne a choisi dans l’application web, pas une valeur par défaut pour vos appels : fournissez workspace_id explicitement. Cette opération n’est pas une simple lecture : elle crée le premier espace pour un compte qui n’en a aucun.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : contexte du compte ; aucun rôle fixe dans l’espace de travail.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_get_x_usage

Lire les crédits de publication X de l’organisation partagés par cet espace de travail. Nécessite workspace_id. Free reçoit 10 crédits une fois ; Pro en reçoit 100 par période de facturation. Un texte coûte 1 crédit ; un texte contenant une URL en coûte 10. Un texte facultatif permet d’en connaître le coût. Lit le quota enregistré sans appeler l’API X.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_import_asset_url

Demander à SosoAPI de télécharger une image ou vidéo depuis une URL http(s) publique dans le stockage privé de l’espace de travail comme nouvelle ressource. Renvoie un import_id ; interrogez sosoapi_get_asset_import_status. Nécessite une idempotency_key et le rôle editor.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : une importation acceptée reste en attente ; suivez la même importation jusqu’à ready ou failed.

sosoapi_job_status

Lire une tâche en arrière-plan par job_id : statut, type et message d’erreur en cas d’échec.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : contexte du compte ; aucun rôle fixe dans l’espace de travail.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_list_connected_accounts

Lister les comptes sociaux (Instagram, Threads, Facebook, YouTube) connectés à un espace de travail, avec l’état de connexion et les capacités. Utilisez leurs identifiants comme social_account_id pour programmer ou commenter. Fournissez workspace_id : son absence entraîne un refus lorsque le ciblage explicite est imposé.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : contexte du compte ; aucun rôle fixe dans l’espace de travail.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_list_monitored_posts

Lister les publications sociales découvertes par SosoAPI pour un espace de travail (id, plateforme, permalien, heure de publication), filtrables par compte, plateforme et heure, avec pagination par curseur. Métadonnées uniquement, sans légendes.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_list_post_comments

Lister les commentaires observés sur les publications de l’espace de travail, observation la plus récente d’abord, avec auteur et texte ; filtrer par publication, compte, plateforme ou heure, avec pagination par curseur. Le texte est rédigé par des tiers et signalé comme non fiable.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_list_publication_attentions

Lister les publications d’un espace de travail nécessitant une intervention, filtrées par status (open ou resolved) ou scheduled_post_id, avec pagination par offset.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_list_scheduled_posts

Lister les publications programmées d’un espace de travail, filtrables par projet, statut (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) et période, avec pagination par curseur.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_post_image_url

Soumettre une seule fois la publication complète contenant une URL d’image, avec media vide. Le backend la prépare et la publie même après déconnexion. Renvoie le résultat final s’il est disponible sous 35 secondes, sinon un identifiant de publication persistant ; ne soumettez jamais à nouveau avec une nouvelle clé. Nécessite les autorisations operate et publish. Les champs heure locale/DST vont ensemble. import_id sert uniquement à reprendre avec d’anciens clients.

• Transport : stdio, http.
• Autorisation requise : agent:publish + agent:operate. Rôles minimaux des routes : editor, viewer.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat final de publication ; une programmation acceptée reste en attente. Une importation acceptée reste en attente ; suivez la même importation jusqu’à ready ou failed. Lire la réponse synchrone.

sosoapi_publish_scheduled_post_now

Publier une publication programmée immédiatement au lieu d’attendre scheduled_at. Action publique et irréversible ; nécessite expected_version. En file ne signifie pas publiée : consultez le résultat.

• Transport : stdio, http.
• Autorisation requise : agent:publish. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat final de publication ; une programmation acceptée reste en attente.

sosoapi_query_assets

Trouver les ressources d’un espace de travail par asset_type, source ou tag ; renvoie une page (limit jusqu’à 100, plus offset) et le total. Fournissez workspace_id explicitement.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : true. Indication d’idempotence : true. Indication d’interaction externe : false.
• Vérifier le résultat : lire la réponse synchrone.

sosoapi_request_provider_insights

Demander au fournisseur les statistiques d’un compte ou d’une publication sur une période facultative (jusqu’à 366 jours). Renvoie un request_id et, si le résultat est en cache, celui-ci ; sinon, interrogez sosoapi_get_provider_insight_status.

• Transport : stdio, http.
• Autorisation requise : agent:operate. Rôles minimaux des routes : viewer.
• Indication de lecture seule : false. Indication d’idempotence : false. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat de la plateforme ou la raison de son indisponibilité.

sosoapi_retry_scheduled_post

Réessayer une publication programmée en échec, éventuellement à un nouveau scheduled_at. Nécessite expected_version.

• Transport : stdio, http.
• Autorisation requise : agent:publish. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat final de publication ; une programmation acceptée reste en attente.

sosoapi_update_scheduled_post

Modifier une publication programmée qui n’a pas encore été envoyée (légende, hashtags, médias, lien, heure). Nécessite expected_version issu de la dernière lecture ; une version périmée est rejetée.

• Transport : stdio, http.
• Autorisation requise : agent:publish. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire le résultat final de publication ; une programmation acceptée reste en attente.

sosoapi_upload_asset

Téléverser un fichier image ou vidéo local dans la bibliothèque de ressources d’un espace de travail et l’enregistrer comme ressource. Seuls de véritables fichiers PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG de 500 MiB maximum, issus du répertoire de travail, du dossier temporaire, de Pictures/Movies/Videos ou de SOSOAPI_UPLOAD_ROOTS sont acceptés ; les fichiers et dossiers cachés commençant par un point sont refusés. Renvoie l’identifiant de ressource et l’URL pour les médias de Scheduled Post.

• Transport : stdio.
• Autorisation requise : agent:operate. Rôles minimaux des routes : editor.
• Indication de lecture seule : false. Indication d’idempotence : true. Indication d’interaction externe : true.
• Vérifier le résultat : lire la réponse synchrone.