publora/x-post

Publication X/Twitter

Créez et planifiez des publications sur X (Twitter) en utilisant le serveur MCP Publora. Prend en charge les publications textuelles, les images (jusqu'à 4), les vidéos et le découpage automatique en fils de discussion pour les contenus longs.

Prérequis

Plans : Nécessite un plan payant (les coûts de l'API X sont répercutés). Limites et tarifs actuels : publora.com/pricing

Important : X/Twitter n'est PAS disponible sur le plan Starter gratuit en raison des coûts de l'API Twitter.

Pour commencer

1. Créez un compte sur publora.com/register
2. Choisissez un plan Pro ou Premium (X/Twitter nécessite un plan payant)
3. Connectez X/Twitter via OAuth dans le Tableau de bord Publora
4. Obtenez une clé API sur app.publora.com/dashboard/api
5. Connectez votre agent au serveur MCP à l'adresse https://mcp.publora.com, en vous authentifiant avec Authorization: Bearer sk_YOUR_API_KEY. Dans Claude Code :

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop, Cursor, Codex, OpenClaw et le connecteur claude.ai nécessitent chacun un fichier de configuration ou un flux différent : consultez client setup pour le chemin exact et l'extrait de code.

Repli via l'API REST

Si MCP n'est pas disponible, utilisez directement l'API REST :

URL de base : https://api.publora.com/api/v1

Authentification : en-tête x-publora-key

# Récupérer les plateformes connectées
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Créer une publication
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["twitter-123456789"],
    "content": "Votre tweet",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Format de l'ID de plateforme : twitter-{id} (ex. twitter-123456789)

📖 Documentation : docs.publora.com

Limites de la plateforme

Fonctionnalité	Limite de l'API	Remarques
Caractères	280	Les emojis comptent pour 2 caractères
Images	Jusqu'à 4	Conversion automatique en PNG (largeur max 1000 px)
Durée de la vidéo	2 min 20 s (140 s)	Publora valide les vidéos X à 140 s
Taille de la vidéo	512 Mo	Formats MP4, MOV
Fil de discussion	Automatique	Contenu de plus de 280 caractères coupé avec des marqueurs (1/N)

Comptage des caractères

X applique des règles de comptage spécifiques que Publora gère automatiquement :

• Caractères standards = 1
• Emojis = 2 caractères
• URL comptées selon leur longueur littérale
• Les marqueurs de fil réservent 10 caractères par tweet

Découpage automatique en fil

Lorsque le contenu dépasse 280 caractères, Publora crée automatiquement un fil de discussion connecté :

1. Le contenu est coupé d'abord aux sauts de paragraphe, puis aux limites de phrase, puis aux limites de mot
2. Chaque partie est numérotée avec le format (1/N), (2/N)
3. Les tweets sont connectés via le paramètre reply_to_id de X

Sauts de fil manuels

Utilisez --- sur une ligne séparée pour forcer un saut de fil :

Ceci est mon premier tweet dans le fil.

---

Ceci est mon second tweet dans le fil.

---

Et ceci est mon troisième tweet !

Outils disponibles

create_post

Crée une nouvelle publication X/Twitter ou un fil de discussion.

Paramètres :

• platforms : Tableau avec votre ID de connexion X (ex. ["twitter-12345678"])
• content : Texte de la publication (découpage automatique en fil si plus de 280 caractères)
• scheduledTime : Date/heure ISO 8601 UTC. Optionnel : omettez-le pour créer la publication en tant que brouillon. Envoyez une heure future pour planifier. Une heure de cinq minutes ou plus dans le passé est rejetée avec l'erreur SCHEDULED_TIME_IN_PAST ; pour une publication immédiate, utilisez l'heure actuelle plus une minute.
• mediaUrls : Jusqu'à 10 URL https publiques d'images ou de vidéos. Publora les télécharge côté serveur et les attache avant la validation : le média et la planification se font en un seul appel. C'est l'alternative en un coup au flux brouillon puis get_upload_url puis complete_media. L'ingestion est limitée à 60 URL par heure.

get_upload_url

Obtient une URL pré-signée pour les téléversements de médias.

Paramètres :

• postGroupId : ID de la publication à laquelle attacher le média
• fileName : Nom du fichier (ex. "image.png", "video.mp4")
• contentType : image/png, image/jpeg, video/mp4
• type : "image" ou "video"

complete_media

Finalise un fichier téléversé via get_upload_url, après la réussite du PUT pré-signé. Optionnel, car la planification finalise également les médias en attente, mais l'appeler tôt permet de remonter les erreurs de format et de sonde avant la publication. Non nécessaire pour les médias attachés avec mediaUrls.

Paramètres :

• mediaId : l'ID retourné par get_upload_url

list_connections

Liste vos comptes connectés avec leurs IDs de plateforme. Appelez d'abord cette méthode et copiez les IDs exactement ; ils ne sont jamais devinables.

list_posts / get_post / update_post / delete_post

Gérez les publications planifiées et les brouillons. update_post modifie également content et platforms sur un brouillon ou une publication planifiée, afin que corriger une faute de frappe ou changer de cible ne nécessite plus de supprimer et recréer. delete_media et prune_media_reference nettoient les fichiers téléversés.

Exemples

Tweet simple

Publie ceci sur X :
"Nous venons de publier notre nouvelle documentation API. Allez y jeter un œil !"

Tweet avec images

Publie ceci sur Twitter avec des captures d'écran du nouveau tableau de bord :
"Avant et après notre refonte. Qu'en pensez-vous ?"

Remarque : Jusqu'à 4 images autorisées. Toutes les images sont converties automatiquement en PNG.

Fil de discussion long

Crée un fil Twitter :
"Fil : 5 leçons de la création de notre startup

---

1. Lancez tôt, itérez vite. Nous avons lancé un MVP buggé et l'avons amélioré grâce aux retours réels.

---

2. Parlez aux utilisateurs chaque jour. Nos meilleures fonctionnalités sont issues de conversations clients.

---

3. La concentration vaut mieux que les fonctionnalités. Nous avons arrêté 3 produits pour nous concentrer sur celui qui fonctionnait."

Tweet programmé

Planifie ceci pour demain à 9h :
"Motivation du lundi : Commencez avant d'être prêt."

Restrictions importantes

1. Plan Pro requis : X/Twitter est exclu du plan Starter gratuit en raison des coûts de l'API Twitter.

2. Limite vidéo de 140 secondes : Publora valide les vidéos X à 2 minutes 20 secondes (140 secondes). Les vidéos plus longues échouent à la validation.

3. Conversion automatique des images : Toutes les images sont converties en PNG (largeur max 1000 px) avant le téléversement. Les GIFs animés perdent leur animation.

4. Pas de mélange image+vidéo : Un tweet peut contenir des images OU une vidéo, pas les deux.

5. Médias sur le premier tweet uniquement : Dans les fils de discussion, les images/vidéos sont attachées au premier tweet uniquement.

Bonnes pratiques

Contenu

1. Accroche dans la première ligne : La plupart de l'engagement a lieu sur le premier tweet
2. Longueur optimale du fil : 3 à 7 tweets pour un meilleur engagement
3. Attention aux emojis : Rappelez-vous que les emojis comptent pour 2 caractères

Timing

• Meilleurs créneaux : 8h-10h, 12h-13h, 17h-18h dans le fuseau horaire cible
• Fréquence : 3 à 5 tweets par jour pour la croissance
• Fils de discussion : Publiez le matin pour une visibilité maximale

Engagement

• Répondez aux commentaires dans la première heure
• Citez vos propres fils de discussion pour plus de visibilité
• Utilisez des hashtags pertinents (1 à 2 par tweet)

Dépannage

Erreur	Cause	Solution
"X/Twitter nécessite le plan Pro"	Utilisation du plan Starter	Passez au plan Pro sur publora.com/settings
"Contenu trop long"	Plus de 280 caractères et échec du découpage en fil	Ajoutez des sauts --- manuels
"Vidéo trop longue"	Plus de 140 secondes	Rognage de la vidéo à moins de 2 min 20 s
"Trop d'images"	Plus de 4 images	Réduisez à 4 ou moins
"Limite de débit dépassée"	Limite de l'API X atteinte	Attendez et réessayez