Automatisiere deinen Clip-Workflow: Die ClipMaster API und der MCP Server
Wenn du jede Woche Videos clippst, wird irgendwann die App-Oberfläche zum langsamsten Teil. Du weißt längst, welcher Podcast geclippt wird, auf welchen Kanal die Clips gehen und ungefähr, wann sie erscheinen sollen – du klickst dich nur jedes Mal durch dieselben Screens, um es umzusetzen. ClipMaster macht diesen ganzen Workflow jetzt programmatisch zugänglich: eine REST-API für Skripte und Tools und einen MCP-Server, mit dem Claude ihn aus einem Chat heraus steuert. Dieser Artikel zeigt, wie beides funktioniert und wann du was nimmst.
Eine API, zwei Zugänge
Beide Wege nutzen dieselbe API und dasselbe Konto: Jeder Aufruf ist auf deine eigenen Projekte beschränkt und wird mit denselben Tokens abgerechnet wie die App, ohne separate Rechnung. Authentifiziert wird mit einem API-Schlüssel (cm_live_…), den du in der App unter Einstellungen → API-Zugang erstellst – verfügbar in den Bezahlplänen. Der Schlüssel kommt in den Authorization-Header, lässt sich jederzeit widerrufen und gibt nie Zugriff auf Kontoverwaltung, Abrechnung oder Admin-Funktionen – die bleiben in der Web-App.
- Die REST-API ist für Skripte, Cronjobs und deine eigenen Tools – überall dort, wo du deterministische Kontrolle willst.
- Der MCP-Server ist fürs Arbeiten im Gespräch: Du sagst Claude, welches Ergebnis du willst, und Claude ruft in deinem Auftrag dieselbe API auf.
Der ganze Workflow ist abgedeckt
Alles zwischen „hier ist ein Video“ und „der Clip ist zur Veröffentlichung eingeplant“ lässt sich skripten: ein Video per URL importieren oder eine Datei hochladen, die Verarbeitung abfragen, die erzeugten Clips mit ihren KI-Metadaten (Hook-Zeilen, Clip-Typen, Transkripte) auflisten, Grenzen und Untertitel anpassen, Editor-Einstellungen speichern, Exporte rendern, Compilations bauen und fertige Exporte auf einem verbundenen YouTube-Kanal einplanen.
Ein kompletter Durchlauf in vier Schritten
Importier ein Video und bring es bis zum herunterladbaren Clip:
# 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.mp4Von dort lässt sich dasselbe Muster aufs Planen (POST /scheduled-posts) übertragen. Die komplette Endpunkt-Referenz mit Beispiel-Requests und -Responses findest du unter clipmaster.app/docs/api, dazu eine Kopie in reinem Markdown unter /docs/api.md, falls du sie einem LLM füttern willst.
Oder lass Claude ran
Der MCP-Server stellt die API als Tools für Claude Desktop, Claude Code und jeden MCP-Client bereit. Die Einrichtung ist ein einziger Config-Block mit deinem API-Schlüssel:
{
"mcpServers": {
"clipmaster": {
"command": "uvx",
"args": ["clipmaster-mcp"],
"env": { "CLIPMASTER_API_KEY": "cm_live_..." }
}
}
}Danach ist der Workflow alles, was du in Worte fassen kannst. Ein paar Dinge, die als einzelne Anfrage funktionieren:
- „Importier diese Folge und sag mir Bescheid, wenn sie fertig ist.“
- „Welcher Clip hat den stärksten Hook? Zeig mir sein Transkript.“
- „Render die zwei besten Clips und plan sie für Freitag um 17 Uhr auf meinem Kanal ein.“
- „Was ist diese Woche schon zur Veröffentlichung eingeplant?“
Der Unterschied zu einem Skript ist Urteilsvermögen: Claude liest die Clip-Metadaten – Hooks, Typen, Transkripte – und trifft die Auswahl, die du sonst nach Augenmaß treffen würdest. Dein MCP-Client fragt vor folgenreichen Tool-Aufrufen nach, und alles Eingeplante taucht im Kalender der App auf, wo du es wie jeden anderen Post verschieben oder stornieren kannst. Einrichtungsanleitung: clipmaster.app/docs/mcp.
Die praktischen Details
- Die Kosten sind dieselben wie in der App. 1 Token = 1 Quellminute bei der Verarbeitung; Exporte kosten nach den Regeln der App. Ein API-Aufruf kostet nie extra.
- Schlüssel sind widerrufbar und rate-limitiert. 120 Requests/Minute pro Schlüssel; wer einen Schlüssel in den Einstellungen widerruft, legt ihn sofort still.
- Wiederholungen sind sicher, wo es darauf ankommt. Wenn du denselben Export zweimal für denselben Slot einplanst, bekommst du den bestehenden Post zurück, statt doppelt zu veröffentlichen.
- Kanäle verbindest du einmal, in der App. API und MCP können auf einem verbundenen Kanal planen, führen die OAuth-Verbindung aber nie selbst durch.
Wenn deine Clipping-Routine ohnehin vorhersehbar ist, hör auf, dich durchzuklicken. Skripte den vorhersehbaren Teil oder gib ihn an Claude ab – und steck die Zeit lieber in die Aufnahmen selbst.
