openclip-video-editing

OpenClip: Videobearbeitung

edit_video führt einen Vorgang pro Aufruf an einer Videodatei aus: Zuschneiden, Trimmen, Drehen, Skalieren, Komprimieren oder Tonspur entfernen. Es ist KOSTENLOS, benötigt ein OpenClip-Konto, aber kein Abonnement und keine Credits.

Verkettung von Aufrufen, um mehrere Operationen zu kombinieren: Das Ausgabeergebnis eines Aufrufs als Eingabe für den nächsten verwenden.

Einrichtung (einmalig)

OpenClip ist ein entfernter MCP-Server unter https://openclip.app/mcp. Melden Sie sich mit Ihrem OpenClip-Konto an, wenn die OAuth-Aufforderung 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: Erstellen Sie einen MCP-Token unter openclip.app/settings/connect und verbinden Sie sich mit https://openclip.app/mcp/key mit Authorization: Bearer <token>.

Überprüfung: Rufen Sie get_account auf.

Die Datei ins System bekommen

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

Rufen Sie NICHT complete_upload auf. Dies startet die kostenpflichtige Clipping-Pipeline. Kostenlose Werkzeuge lesen die hochgeladene Datei direkt. Ein Video, das bereits in list_videos vorhanden ist, kann ebenfalls als Eingabe verwendet werden.

Operationen

Jeder Aufruf ist edit_video(video, operation, ...params).

• crop – entweder aspect ("1:1", "9:16", "16:9", "4:5") oder explizite x, y, width, height. Verwenden Sie aspect: "9:16", um Querformatmaterial für TikTok, Reels und Shorts umzuwandeln.
• trim – start_ms und end_ms, beide erforderlich. Zeiten in Millisekunden.
• rotate – degrees (90, 180, 270) und/oder flip (none, horizontal, vertical).
• resize – width und height in Pixeln.
• compress – entweder target_mb (Zielgröße) oder crf (18 bis 32, niedriger bedeutet bessere Qualität und größere Datei). Greifen Sie zu target_mb, wenn der Benutzer eine Größenbeschränkung nennt.
• mute – keine Parameter, entfernt die Tonspur.

Abfragen des Status

edit_video gibt eine tool_job-Hashid mit status: "queued" zurück. Fragen Sie 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.

Gehen Sie niemals davon aus, dass ein Aufruf synchron abgeschlossen wird.

Regeln

• Ein Vorgang pro Aufruf. Um zu trimmen und dann umzuwandeln, führen Sie zuerst den Trimmschritt aus, übergeben dann dessen Ausgabe an einen Zuschneideaufruf.
• Zeiten werden überall in Millisekunden angegeben, nicht in Sekunden.
• Ausgabe-URLs sind permanente CDN-Links, weder signiert noch zeitlich begrenzt.
• Die kostenlose Nutzung ist pro Tag durch ein Rate-Limit und eine maximale Dateigröße eingeschränkt. Die Fehlermeldung erklärt, wie ein Limit aufgehoben werden kann.

Beispielanfragen und Aktionen

• „Schneide das auf die ersten 30 Sekunden herunter“ – create_upload, Bytes per PUT, edit_video(video, operation="trim", start_ms=0, end_ms=30000), abfragen.
• „Mach das vertikal für TikTok“ – edit_video(video, operation="crop", aspect="9:16"), abfragen.
• „Diese Datei ist 400MB, bring sie unter 50“ – edit_video(video, operation="compress", target_mb=50), abfragen.
• „Entferne die Tonspur“ – edit_video(video, operation="mute"), abfragen.
• „Trimme auf die mittlere Minute und mach es quadratisch“ – trimmen, abfragen, dann das Ausgabeergebnis mit aspect="1:1" zuschneiden, erneut abfragen.

Verwandtes

Die Konvertierung zwischen Formaten (mp4, gif, mp3) erfolgt mit convert_media, siehe das Skill openclip-convert. Die Umwandlung eines langen Videos in kurze, bewertete Clips ist die kostenpflichtige Pipeline, siehe openclip-clipping.