publora/bluesky-post

Publication Bluesky

Créez et programmez des publications sur Bluesky en utilisant le serveur MCP Publora. Prend en charge les publications textuelles avec hashtags et URLs détectés automatiquement, les images et les vidéos.

Prérequis

Forfaits : Fonctionne sur le plan Starter gratuit. Limites et tarifs actuels : publora.com/pricing.

Pour commencer

1. Créez un compte sur publora.com/register (gratuit)
2. Générez un mot de passe d'application dans Paramètres Bluesky > Mots de passe d'application (PAS votre mot de passe principal)
3. Connectez Bluesky dans le Tableau de bord Publora en utilisant votre identifiant + mot de passe d'application
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 : voir configuration client pour le chemin exact et l'extrait.

API REST de secours

Si le serveur MCP est indisponible ou renvoie des erreurs, utilisez l'API REST directement :

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

Authentification : Utilisez l'en-tête x-publora-key (PAS Authorization: Bearer) :

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

# Créez 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": ["bluesky-did:plc:abc123xyz"],
    "content": "Le contenu de votre publication ici",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Format de l'ID de plateforme : bluesky-{did} où {did} provient de la réponse /platform-connections.

Exemples d'IDs : bluesky-did:plc:abc123xyz, bluesky-did:plc:def456uvw

📖 Documentation complète de l'API : docs.publora.com

Limites de la plateforme

Fonctionnalité	Limite
Caractères	300
Images	Jusqu'à 4 par publication
Taille des images	Exactement 2 000 000 octets (décimal, pas 2 Mio)
Durée vidéo	3 minutes
Taille vidéo	50-100 Mo (selon la durée)
Vidéos par jour	25
Texte alternatif	2 000 caractères sur Bluesky lui-même, mais non définissable via cette API (voir ci-dessous)

Niveaux de taille vidéo

Durée	Taille max
Moins de 60 s	50 Mo
60 s - 3 min	100 Mo

Facettes de texte enrichi

Bluesky utilise un système de texte enrichi unique. Publora gère la complexité automatiquement :

• Hashtags : #hashtag détecté automatiquement et rendu cliquable
• URLs : Toute URL détectée automatiquement et rendue cliquable
• Décalages d'octets : Calculés correctement pour les caractères multi-octets (emojis, CJK)

Aucun formatage spécial nécessaire - écrivez simplement naturellement.

Outils disponibles

create_post

Créez une nouvelle publication Bluesky.

Paramètres :

• platforms : Tableau avec votre ID de connexion Bluesky (ex. ["bluesky-did:plc:abc123xyz"])
• content : Texte de la publication (jusqu'à 300 caractères)
• scheduledTime : Date/heure ISO 8601 UTC. Optionnel : omettez-le et la publication est créée en tant que brouillon. Envoyez une heure future pour programmer. Une heure de cinq minutes ou plus dans le passé est rejetée avec SCHEDULED_TIME_IN_PAST, donc pour une publication immédiate, utilisez l'heure actuelle plus une minute.
• mediaUrls : Jusqu'à 10 URLs https publiques d'images ou de vidéos. Publora les télécharge côté serveur et les attache avant la validation, donc les médias et la programmation se font en un seul appel. C'est l'alternative en un seul coup au flux brouillon puis get_upload_url puis complete_media. L'ingestion est limitée à 60 URLs par heure.

get_upload_url

Obtenez une URL pré-signée pour les téléchargements de médias.

Paramètres :

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

complete_media

Finalisez un fichier téléchargé via get_upload_url, après la réussite du PUT pré-signé. Optionnel, car la programmation finalise également les médias en attente, mais l'appeler tôt révèle les erreurs de format et de sondage 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

Listez vos comptes connectés avec leurs IDs de plateforme. Appelez ceci en premier et copiez les IDs textuellement ; ils ne sont jamais devinables.

post_stats

Compteurs d'engagement pour une publication Bluesky publiée : réactions, commentaires, republications, citations et favoris. En direct au moment de la demande, mis en cache pendant environ deux heures.

Paramètres :

• platform : bluesky
• platformId : votre ID de connexion Bluesky
• postedIds : les IDs des publications publiées à rechercher

profile_stats

Nombre d'abonnés, d'abonnements et de publications pour le compte connecté.

Paramètres :

• platform : bluesky
• platformId : votre ID de connexion Bluesky

list_posts / get_post / update_post / delete_post

Gérez les publications programmées et les brouillons. update_post modifie également content et platforms sur un brouillon ou une publication programmée, donc corriger une faute de frappe ou recibler ne signifie plus supprimer et recréer. delete_media et prune_media_reference nettoient les fichiers téléchargés.

Exemples

Publication simple avec hashtags

Publiez ceci sur Bluesky :
"Nous venons de lancer notre nouvelle documentation API ! Consultez-la sur https://docs.example.com #devtools #api"

Les hashtags et URLs sont automatiquement rendus cliquables.

Publication avec image

Publiez ceci sur Bluesky avec une capture d'écran du tableau de bord :
"Notre nouvelle vue analytique est en ligne ! #buildinpublic"

Images multiples

Créez une publication Bluesky avec des images de comparaison avant/après :
"Rénovation du bureau terminée ! Quelle transformation."

Remarque : Jusqu'à 4 images autorisées par publication.

Publication vidéo

Publiez cette vidéo de démonstration de 60 secondes sur Bluesky :
"Visite rapide des nouvelles fonctionnalités de notre application mobile"

Publication programmée

Programmez ceci pour demain à 10h :
"Bonjour ! Voici votre astuce de productivité quotidienne..."

Restrictions importantes

0. Le texte alternatif ne peut pas être défini via l'API. L'éditeur Bluesky lit une propriété alt sur les médias, mais rien ne la persiste : ni le flux de téléchargement pré-signé ni mediaUrls ne la stocke, et une valeur altTexts envoyée à create-post est silencieusement ignorée. platformSettings n'aide pas non plus, puisque Bluesky y est rejeté avec 400 PLATFORM_SETTING_UNKNOWN. Publiez l'image, puis ajoutez le texte alternatif dans l'application Bluesky. Ne dites pas à l'utilisateur que son texte alternatif a été publié.

1. Mot de passe d'application requis : Vous devez utiliser un mot de passe d'application Bluesky, PAS votre mot de passe principal. Générez-en un dans Paramètres > Mots de passe d'application.

2. Toutes les images converties en JPEG : Quel que soit le format d'entrée (PNG, WebP, GIF), toutes les images sont converties en JPEG avant le téléchargement.

3. Limite stricte de 2 000 000 octets pour les images : le protocole AT impose un plafond exact en octets décimaux, pas un 2 Mio arrondi. Compressez à une qualité JPEG de 80-85 % et vérifiez le nombre d'octets.

4. ID de plateforme basé sur DID : Contrairement à d'autres plateformes utilisant des IDs numériques, Bluesky utilise le format did:plc:xxx.

5. Vérification des e-mails pour les vidéos : Vous devez vérifier votre e-mail dans Bluesky avant de télécharger des vidéos.

6. Limite quotidienne de 25 vidéos : Maximum 25 vidéos OU 10 Go par jour.

Bonnes pratiques

Contenu

1. Publications concises : 300 caractères, c'est plus court que Twitter - soyez percutant
2. Hashtags naturels : 1-2 hashtags pertinents fonctionnent bien
3. Texte alternatif : ça vaut la peine d'être ajouté, mais vous devez le faire dans l'application Bluesky après la publication ; l'API ne peut pas le transporter
4. Les URLs fonctionnent : Les liens sont cliquables (contrairement à certaines plateformes)

Calendrier

• Plateforme en croissance : Moins fréquentée que X, plus facile de se faire remarquer
• Audience férue de technologie : Beaucoup de développeurs et d'adopteurs précoces
• Fréquence : 1 à 3 publications par jour

Engagement

• Bluesky favorise la conversation authentique
• Répondez aux commentaires pour construire une communauté
• Suivez les utilisateurs pertinents pour développer votre réseau

Dépannage

Erreur	Cause	Solution
"Identifiants invalides"	Mauvais type de mot de passe	Utilisez un mot de passe d'application, pas le mot de passe principal
"Image trop volumineuse"	Plus de 2 000 000 octets	Compressez à une qualité JPEG de 80-85 %
"Contenu trop long"	Plus de 300 caractères	Raccourcissez le contenu (pas de publication automatique en fil)
"Limite quotidienne de vidéos"	25 vidéos atteintes	Attendez 24 heures
"E-mail non vérifié"	Tentative de téléchargement de vidéo	Vérifiez votre e-mail dans les paramètres Bluesky