Automatisez votre flux de travail de clips : L'API ClipMaster et le serveur MCP

Si vous découpez des vidéos chaque semaine, l'interface de l'app finit par devenir l'étape la plus lente. Vous savez déjà quel podcast sera découpé, sur quelle chaîne partiront les clips et à peu près quand ils doivent être publiés — vous ne faites que cliquer sur les mêmes écrans pour que ça arrive. ClipMaster expose désormais tout ce workflow par le code : une API REST pour les scripts et les outils, et un serveur MCP qui permet à Claude de tout piloter depuis une conversation. Cet article montre comment les deux fonctionnent et quand choisir l'un ou l'autre.

Une API, deux portes d'entrée

Les deux approches reposent sur la même API et le même compte : chaque appel est limité à vos propres projets, décompté avec les mêmes jetons que l'app, sans facturation séparée. L'authentification passe par une clé API (cm_live_…) créée dans l'app, sous Paramètres → Accès API, disponible avec les offres payantes. La clé se place dans l'en-tête Authorization, peut être révoquée à tout moment et ne donne jamais accès à la gestion du compte, à la facturation ni aux fonctions d'administration — tout cela reste dans l'app web.

• L'API REST sert aux scripts, aux tâches cron et à vos propres outils — partout où vous voulez un contrôle déterministe.
• Le serveur MCP sert à travailler en conversation : vous dites à Claude quel résultat vous voulez, et il appelle la même API à votre place.

Tout le workflow est couvert

Tout ce qui se passe entre « voici une vidéo » et « le clip est programmé » est scriptable : importer une vidéo par URL ou envoyer un fichier, suivre le traitement, lister les clips générés avec leurs métadonnées IA (phrases d'accroche, types de clips, transcriptions), ajuster les bornes et les sous-titres, enregistrer les réglages de l'éditeur, lancer des exports, monter des compilations et programmer des exports finis sur une chaîne YouTube connectée.

Un cycle complet en quatre étapes

Importez une vidéo et menez-la jusqu'à un clip téléchargeable :

# 1. Import a YouTube video
curl -X POST "https://api.clipmaster.app/api/v1/upload/from-url" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_url": "https://youtube.com/watch?v=..."}'
# -> {"project_id": 123, ...}

# 2. Poll until processing completes
curl "https://api.clipmaster.app/api/v1/projects/123/status" \
  -H "Authorization: Bearer $KEY"
# -> {"status": "completed", "total_clips": 6, ...}

# 3. List the generated clips
curl "https://api.clipmaster.app/api/v1/projects/123/clips" \
  -H "Authorization: Bearer $KEY"

# 4. Export it (captions, effects, trim), then download the export
curl -X POST "https://api.clipmaster.app/api/v1/projects/123/clips/456/export" \
  -H "Authorization: Bearer $KEY"
# -> {"export_id": 37, ...}; poll /exports/37/status until "completed"
curl "https://api.clipmaster.app/api/v1/exports?clip_id=456" \
  -H "Authorization: Bearer $KEY"
# -> newest completed export's "download_url" (presigned S3, expires next 00:00 UTC)
curl -L "$DOWNLOAD_URL" -o clip.mp4

À partir de là, le même principe s'étend à la programmation (POST /scheduled-posts). La référence complète des endpoints, avec des exemples de requêtes et de réponses, se trouve sur clipmaster.app/docs/api, avec une version miroir en Markdown brut sur /docs/api.md si vous comptez la donner à un LLM.

Ou confiez-la à Claude

Le serveur MCP expose l'API sous forme d'outils pour Claude Desktop, Claude Code et n'importe quel client MCP. La configuration tient en un seul bloc avec votre clé API :

{
  "mcpServers": {
    "clipmaster": {
      "command": "uvx",
      "args": ["clipmaster-mcp"],
      "env": { "CLIPMASTER_API_KEY": "cm_live_..." }
    }
  }
}

Ensuite, le workflow, c'est tout ce que vous savez formuler. Quelques exemples qui fonctionnent en une seule demande :

• « Importe cet épisode et préviens-moi quand c'est terminé. »
• « Quel clip a l'accroche la plus forte ? Montre-moi sa transcription. »
• « Lance le rendu des deux meilleurs clips et programme-les sur ma chaîne vendredi à 17 h. »
• « Qu'est-ce qui est déjà prévu pour cette semaine ? »

La différence avec un script, c'est le discernement : Claude lit les métadonnées des clips — accroches, types, transcriptions — et fait les choix que vous feriez sinon à l'œil. Votre client MCP demande confirmation avant les appels d'outils qui ont des conséquences, et tout ce qui est programmé apparaît dans le calendrier de l'app, où vous pouvez le décaler ou l'annuler comme n'importe quelle autre publication. Guide de configuration : clipmaster.app/docs/mcp.

Les détails pratiques

• Les coûts sont identiques à ceux de l'app. 1 jeton = 1 minute source pour le traitement ; les exports sont facturés selon les règles de l'app. Un appel API ne coûte jamais plus cher.
• Les clés sont révocables et limitées en débit. 120 requêtes/minute par clé ; révoquer une clé dans les Paramètres la désactive immédiatement.
• Les nouvelles tentatives sont sans risque là où ça compte. Programmer deux fois le même export sur le même créneau renvoie la publication existante au lieu de publier en double.
• La connexion des chaînes se fait une fois, dans l'app. L'API et le MCP peuvent programmer sur une chaîne connectée, mais n'effectuent jamais eux-mêmes la connexion OAuth.

Si votre routine de découpage est déjà prévisible, arrêtez de cliquer pour la dérouler. Scriptez la partie prévisible, ou confiez-la à Claude — et passez ce temps sur vos enregistrements.