openclip-convert

OpenClip: Medienkonvertierung

convert_media ändert den Container oder Codec einer Datei, einschließlich Video-zu-GIF und Video-zu-reinem-Audio. Es ist kostenlos, es braucht ein OpenClip-Konto, aber kein Abo und keine Credits.

Einrichtung (einmalig)

OpenClip ist ein entfernter MCP-Server unter https://openclip.app/mcp. Melde dich mit deinem OpenClip-Konto an, wenn der OAuth-Hinweis erscheint. Es gibt keinen API-Key zum Kopieren.

• Claude Code: claude mcp add --transport http openclip https://openclip.app/mcp, dann /mcp zur Autorisierung.
• Claude Desktop / Web: Einstellungen, Connectors, „Benutzerdefinierten Connector hinzufügen“, URL einfügen, anmelden.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Nur-Header-Clients: Erstelle einen MCP-Token unter openclip.app/settings/connect und verbinde dich mit https://openclip.app/mcp/key mit Authorization: Bearer <token>.

Kurzer Test: Rufe get_account auf.

Datei einspielen

1. create_upload(filename, content_type) gibt eine id und eine upload_url zurück.
2. Sende die rohen Bytes per PUT an upload_url.
3. Übergib die zurückgegebene id als file-Argument.

Rufe NICHT complete_upload auf. Das startet die kostenpflichtige Clipping-Pipeline. Kostenlose Tools lesen die hochgeladene Datei direkt. Eine Datei, die bereits in list_videos existiert, kann ebenfalls als Eingabe verwendet werden.

Zielformate

convert_media(file, to, ...params).

• Video-Container – mp4, webm, mov, mkv. Standard ist mp4, wenn der Benutzer einfach etwas haben möchte, das überall abgespielt werden kann.
• gif – optional fps (Standard 12) und width (Standard 480). Höhere fps für flüssigere Bewegungen, größere width für ein schärferes GIF – beides macht die Datei viel größer. Schneide die Quelle vorher auf die wichtigen Sekunden zu, wenn sie lang ist, GIFs werden schnell riesig.
• Audio – mp3, aac, wav, flac. Verwende dies, um Audio aus einem Video zu extrahieren. mp3 zum Teilen, wav oder flac, wenn das Audio an ein anderes Tool übergeben wird, das verlustfrei arbeiten soll.

Um eine bestimmte Dateigröße zu erreichen, statt das Format zu ändern, verwende edit_video mit operation="compress" (target_mb oder crf), siehe den Skill openclip-video-editing.

Polling

convert_media gibt eine tool_job-Hashid mit status: "queued" zurück. Frage alle 5 bis 10 Sekunden get_tool_job_status(tool_job) ab:

• queued / processing – noch in Arbeit, weiter abfragen.
• completed – gibt permanente CDN-outputs-URLs sowie result_meta zurück.
• failed – gibt error zurück.

Gehe niemals davon aus, dass ein Aufruf synchron abgeschlossen wird.

Regeln

• Immer abfragen, die Konvertierung ist asynchron.
• Ausgabe-URLs sind permanente CDN-Links, weder signiert noch zeitlich begrenzt.
• Die kostenlose Nutzung ist pro Tag rate-limitiert, mit einer maximalen Dateigröße pro Datei. Der Fehlertext erklärt, wie eine Begrenzung aufgehoben werden kann.
• Die Konvertierung eines langen Videos in ein GIF erzeugt eine enorme Datei. Schneide zuerst auf die interessanten Sekunden zu, dann konvertiere.

Beispiel-Prompts zu Aktionen

• „Konvertiere dies in mp4“ – create_upload, Bytes per PUT, convert_media(file, to="mp4"), abfragen.
• „Mach ein GIF davon“ – zuerst mit edit_video auf den Moment zuschneiden, dann convert_media(file, to="gif", fps=15, width=640), abfragen.
• „Gib mir nur den Ton“ – convert_media(file, to="mp3"), abfragen.
• „Ich brauche verlustfreies Audio zum Bearbeiten“ – convert_media(file, to="wav"), abfragen.

Verwandte Skills

Zuschneiden, Beschneiden und zielgrößenorientierte Komprimierung befinden sich in openclip-video-editing. Das Transkribieren des gerade extrahierten Audios ist openclip-transcription.