1forh/sendcove

Utiliser Sendcove

Sendcove est un planificateur de réseaux sociaux. Son serveur MCP vous offre des outils pour gérer les publications, médias, analyses et la boîte de réception de l'utilisateur. Si aucun outil Sendcove n'est disponible, dites à l'utilisateur de connecter Sendcove (guides de configuration : https://www.sendcove.app/features/mcp).

Commencez par les comptes

1. Appelez list_accounts avant de créer ou modifier une publication. Transmettez les id retournés comme accountIds ; Sendcove détermine les plateformes à partir de ceux-ci.
2. Si l'utilisateur a plusieurs comptes et n'a pas précisé lequel utiliser, demandez-lui. Ne publiez pas sur tous les comptes par défaut.
3. Un compte avec needsReconnect: true échouera lors de la publication. Dites à l'utilisateur de le reconnecter dans Sendcove.

Créer des publications

• create_post crée un brouillon sauf si vous définissez status. Les brouillons sont la valeur par défaut sûre : créez-en un, montrez à l'utilisateur ce que vous avez fait, puis laissez-le le planifier ou le publier.
• content est le texte par défaut pour chaque plateforme. Utilisez platformContent pour donner un texte spécifique à une plateforme, par exemple une version de 280 caractères pour twitter et une légende plus longue pour instagram. Clés : twitter, instagram, tiktok, threads, bluesky, facebook, linkedin (chaînes) et youtube ({ title, description }).
• Les options par plateforme (type de publication Instagram, type et visibilité de la vidéo YouTube, confidentialité TikTok, paramètres de réponse Bluesky, communauté X, etc.) vont dans platformSettings. Prenez les champs autorisés et les valeurs du schéma d'entrée de l'outil et de ses descriptions au lieu de deviner. Avant de définir platformSettings.tiktok, appelez get_tiktok_creator_info pour les niveaux de confidentialité et les interactions que ce compte autorise.
• Les limites de caractères sont vérifiées lors de la publication : X 280, Bluesky 300, Threads 500, Instagram et TikTok 2200, LinkedIn 3000, YouTube titre 100 et description 5000. Gardez le texte de chaque plateforme dans sa limite (utilisez platformContent) pour que la publication ne plante pas plus tard.
• Les publications Instagram et TikTok nécessitent des médias ; YouTube nécessite une vidéo.
• Threads : transmettez les publications de suivi comme threadItems (chacun { content, mediaUrls? }). Elles sont publiées sous forme de fil sur X, Bluesky et Threads (Pro et Max) ; les autres plateformes ne reçoivent que content. update_post avec threadItems: [] arrête le threading.
• Hashtags : list_hashtag_sets retourne les ensembles sauvegardés de l'utilisateur (stockés sans #).
• Passez un idempotencyKey (toute chaîne unique, de 8 à 200 caractères) à create_post, duplicate_post et reply_to_inbox_item. Si un appel expire ou que vous n'êtes pas sûr qu'il ait abouti, réessayez avec la même clé : vous obtenez le premier résultat au lieu d'une publication ou réponse en double.
• update_post ne modifie que les champs que vous passez, mais platformContent, platformSettings et threadItems remplacent chacun la valeur stockée entière. Appelez get_post d'abord et envoyez l'objet complet.

Médias

• Les médias doivent être dans la bibliothèque multimédia Sendcove de l'utilisateur avant de pouvoir être inclus dans mediaUrls. list_media montre ce qui est déjà présent.
• Une URL publique https : upload_media_from_url, puis utilisez l'URL retournée.
• Un fichier local : appelez create_media_upload_url et exécutez la commande curl retournée avec le chemin réel du fichier (par exemple curl -s -X POST '<uploadUrl>' -F 'file=@/path/to/photo.jpg'). La réponse JSON contient l'URL à utiliser. L'URL de téléchargement est valide 10 minutes et ne nécessite pas de clé API. Pour les fichiers de plus de 4 Mo, passez contentType et exécutez les deux commandes retournées (PUT vers le stockage, puis le POST final) dans cet ordre. Ajoutez -F convertForInstagram=true pour convertir une image en JPEG pour Instagram.
• Types autorisés : JPEG, PNG, GIF, WebP, MP4, MOV, AVI.

Planification et publication

Ne planifiez, publiez ou répondez que lorsque l'utilisateur l'a demandé dans cette conversation. Écrire une publication n'est pas une autorisation de la publier.

• Planification : status: "scheduled" avec scheduledFor au format ISO 8601 avec décalage (2026-11-20T15:00:00Z). Convertissez l'heure locale de l'utilisateur et confirmez le fuseau horaire s'il n'est pas clair. Ou passez nextOpenSlot: true pour utiliser le prochain créneau de publication libre défini par l'utilisateur pour ces comptes.
• Publier maintenant : status: "pending" sur create_post, ou publish_post pour une publication existante.
• Après la publication, appelez get_post : chaque compte a son propre status (published, failed, pending) et error. Une publication en échec signifie généralement qu'un compte a échoué. publish_post sur cette publication ne réessaie que les comptes en échec ; il ne republie jamais là où c'est déjà en ligne.
• delete_post est irréversible. Confirmez avant de supprimer.

Connexions brouillons uniquement (403)

La planification, la publication et la réponse nécessitent un forfait Pro ou Max et une connexion qui autorise la publication. Avec le forfait Basic, ou avec une clé API ou une application connectée configurée en mode brouillons uniquement, ces appels retournent 403 "Cette clé API ou application connectée ne peut créer que des brouillons".

Dans ce cas, ne réessayez pas et ne contournez pas le problème. Enregistrez la publication comme brouillon et dites à l'utilisateur :

J'ai enregistré ceci comme brouillon dans Sendcove. Cette connexion est en mode brouillons uniquement, donc je ne peux pas la planifier ou la publier. Pour me permettre de publier, vous avez besoin d'un forfait Pro ou Max, puis reconnectez Sendcove ici et choisissez "Autoriser la publication" (ou utilisez une clé API créée avec l'option "Autoriser la publication" activée, sous Compte > Clés API dans Sendcove). Vous pouvez également planifier le brouillon vous-même dans Sendcove.

Analyses et boîte de réception

• get_engagement : totaux, répartition par plateforme, meilleures publications, et les meilleures publications récentes de chaque compte par rapport à sa propre médiane (timesMedian indique combien une publication a mieux performé, pas pourquoi).
• get_post_analytics : les indicateurs d'une publication publiée par compte ; passez refresh: true pour des chiffres frais (mis en cache pendant une heure). Toutes les plateformes ne rapportent pas tous les indicateurs.
• get_best_times : meilleurs jours et heures pour publier, basés sur l'engagement propre de l'utilisateur.
• list_inbox / get_inbox_item : réponses, mentions et commentaires. reply_to_inbox_item publie une réponse publique, alors montrez le texte à l'utilisateur et obtenez un accord d'abord. update_inbox_item marque les éléments comme lus, non lus ou archivés.