publora/tiktok-post

Publication TikTok

Publiez et planifiez des vidéos sur TikTok à l'aide du serveur MCP Publora. Prend en charge les contrôles de confidentialité, les paramètres d'interaction (commentaires, duo, couture) et la divulgation du contenu commercial.

Prérequis

Plans : Fonctionne avec le plan Starter gratuit. Limites et tarifs actuels : publora.com/pricing.

Pour commencer

1. Créez un compte sur publora.com/register (gratuit)
2. Connectez TikTok via OAuth dans le Tableau de bord Publora
3. Obtenez une clé API sur app.publora.com/dashboard/api
4. Connectez votre agent au serveur MCP à l'adresse https://mcp.publora.com, en vous authentifiant avec Authorization: Bearer sk_VOTRE_CLE_API. Dans Claude Code :

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

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

Repli API REST

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

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_votre_cle_api"

# Créez un post
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["tiktok-99887766"],
    "content": "Légende de la vidéo ici #hashtag",
    "scheduledTime": "2026-03-25T10:00:00Z",
    "platformSettings": {
      "tiktok": {
        "viewerSetting": "PUBLIC_TO_EVERYONE",
        "allowComments": true
      }
    }
  }'

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

Exemples d'IDs : tiktok-99887766, tiktok-123456789

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

Limites de la plateforme (API vs Application native)

Limites critiques de l'API qui diffèrent de l'application TikTok native :

Exigences vidéo

Spécification	Limite API	Application native
Durée max	10 minutes	60 minutes
Durée min	3 secondes	3 secondes
Taille fichier max	4 Go	4 Go
Taux d'images min	23 FPS	23 FPS
Formats	MP4, MOV, WebM	MP4, MOV, WebM

Limites des légendes

Élément	Limite API	Application native
Longueur légende	2 200 caractères	4 000 caractères
Hashtags	Inclus dans le nombre de caractères	Inclus dans le nombre de caractères

Limites de taux

Limite	Valeur
Posts par jour	15-20
Vidéos par minute	Max 2

Outils disponibles

create_post

Créer une nouvelle publication TikTok.

Paramètres :

• platforms : Tableau avec votre ID de connexion TikTok (ex. ["tiktok-99887766"])
• content : Légende de la vidéo (jusqu'à 2 200 caractères)
• scheduledTime : Date/heure UTC au format ISO 8601. Optionnel : omettez-le et le post est créé en tant que brouillon. Envoyez une heure future pour planifier. Une heure datant 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 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 URLs par heure.

get_upload_url

Obtenir une URL pré-signée pour le téléversement vidéo.

Paramètres :

• postGroupId : ID du post auquel attacher la vidéo
• fileName : Nom du fichier vidéo (ex. "video.mp4")
• contentType : video/mp4, video/quicktime ou video/webm
• type : "video"

complete_media

Finaliser 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 révèle 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

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

list_posts / get_post / update_post / delete_post

Gérer 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 nécessite plus de supprimer et recréer. delete_media et prune_media_reference nettoient les fichiers téléversés.

Paramètres de la plateforme (via l'API REST)

TikTok dispose de 7 paramètres spécifiques à la plateforme contrôlés via platformSettings :

{
  "platformSettings": {
    "tiktok": {
      "viewerSetting": "PUBLIC_TO_EVERYONE",
      "allowComments": true,
      "allowDuet": false,
      "allowStitch": false,
      "commercialContent": false,
      "brandOrganic": false,
      "brandedContent": false
    }
  }
}

Paramètres de visualisation (Obligatoire)

Valeur	Description
PUBLIC_TO_EVERYONE	Tout le monde peut voir (par défaut)
MUTUAL_FOLLOW_FRIENDS	Uniquement les abonnés mutuels
FOLLOWER_OF_CREATOR	Uniquement vos abonnés
SELF_ONLY	Uniquement vous (semblable à un brouillon)

Paramètres d'interaction

Paramètre	Par défaut	Description
allowComments	true	Si les spectateurs peuvent commenter
allowDuet	false	Si les spectateurs peuvent créer des Duos
allowStitch	false	Si les spectateurs peuvent faire des Coutures

Paramètres de contenu commercial

Paramètre	Par défaut	Description
commercialContent	false	S'agit-il d'un contenu commercial ?
brandOrganic	false	Promotion organique de marque
brandedContent	false	Partenariat rémunéré/sponsorisé

Remarque : Si commercialContent est true, au moins un des brandOrganic ou brandedContent doit également être true.

Remarque : platformSettings est accepté par les outils MCP create_post et update_post ainsi que par l'API REST. Le schéma est strict : une plateforme ou une clé mal typée est rejetée avec une erreur de validation plutôt que d'être ignorée silencieusement.

Restrictions critiques

1. Applications non auditées = PRIVÉ Uniquement

CRITIQUE : Si votre application TikTok n'a pas passé le processus de révision de TikTok, vous ne pouvez SEULEMENT publier des vidéos PRIVÉES (SELF_ONLY). Toutes les autres valeurs de viewerSetting seront remplacées par SELF_ONLY.

Pour publier des vidéos publiques, votre application doit être auditée par TikTok.

2. Média requis, vidéo ou carrousel d'images

TikTok ne prend PAS en charge les posts textuels uniquement : chaque publication a besoin d'un média.

Il accepte les carrousels d'images : jusqu'à 35 images, JPEG, PNG ou WebP, 20 Mo chacune. Un post est soit un carrousel, soit une vidéo unique, jamais les deux.

3. Minimum 23 FPS

Les vidéos en dessous de 23 images par seconde seront rejetées par TikTok.

Exemples

Publication vidéo de base

Publier cette vidéo sur TikTok :
"Comment nous avons construit notre startup en 60 secondes #startup #tech #codage"

Brouillon privé (Test)

Téléverser cette vidéo en tant que brouillon privé sur TikTok (moi seul peux la voir) :
"Test du nouveau format de contenu"

Utilisez viewerSetting: "SELF_ONLY" pour les tests avant de rendre public.

Contenu de marque

Publier cette vidéo sponsorisée sur TikTok avec la divulgation appropriée :
"J'adore ce nouveau produit de @marque ! #pub #sponsorisé"

Définissez commercialContent: true et brandedContent: true pour les partenariats rémunérés.

Publication programmée

Planifier cette vidéo TikTok pour demain à 18h :
"Ambiance du week-end à venir ! #weekend #fun"

Formats vidéo pris en charge

Format	Recommandé	Notes
MP4	Oui	Le plus fiable
MOV	Oui	Format Apple
WebM	Oui	Format Web
AVI	Accepté par Publora	Peut être rejeté par TikTok
MKV	Accepté par Publora	Peut être rejeté par TikTok

Recommandation : Utilisez le MP4 pour une meilleure compatibilité.

Meilleures pratiques

Contenu

1. Accroche dans les 3 premières secondes : Captez l'attention immédiatement
2. Durée optimale : 15 à 60 secondes pour un meilleur engagement
3. Sons tendance : Utilisez l'audio tendance lorsque possible
4. Stratégie de hashtags : 3 à 5 hashtags pertinents

Technique

1. Vidéo verticale : Le rapport hauteur/largeur 9:16 donne les meilleurs résultats
2. Haute qualité : Au moins une résolution 720p
3. 23+ FPS : Assurez une lecture fluide
4. Format MP4 : Le format le plus fiable

Calendrier

• Meilleures heures : 7-9h, 12-15h, 19-23h dans le fuseau horaire cible
• Fréquence : 1 à 3 publications par jour pour la croissance
• Régularité : Un calendrier de publication régulier aide l'algorithme

Dépannage

Erreur	Cause	Solution
unaudited_client_can_only_post_to_private_accounts	Application non approuvée	Soumettez l'application à la révision TikTok ou utilisez SELF_ONLY
spam_risk_too_many_posts	Limite quotidienne atteinte	Attendez 24 heures
duration_check_failed	Vidéo trop longue/courte	Assurez-vous de 3 secondes à 10 minutes
file_format_check_failed	Mauvais format vidéo	Utilisez MP4, MOV ou WebM
"23 FPS requis"	Faible taux d'images	Re-encodez la vidéo à 23+ FPS
"TikTok requires selecting who can view"	viewerSetting manquant	Incluez toujours viewerSetting dans platformSettings