openclip-transcription

OpenClip: Transkription

transcribe wandelt eine Video- oder Audiodatei in ein mit Zeitcodes versehenes Transkript um. Es ist KOSTENLOS, erfordert ein OpenClip-Konto, aber kein Abonnement und keine Credits. Ausgabeformate: JSON (strukturiert, mit Zeitangaben), SRT und VTT.

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, Verbindungen, „Benutzerdefinierten Connector hinzufügen“, URL einfügen, anmelden.
• Cursor (.cursor/mcp.json): { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Header-basierte Clients: Erstelle ein 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.

Der Ablauf

1. Hochladen. create_upload(filename, content_type) gibt ein id und eine upload_url zurück. Lege die rohen Bytes per PUT auf die upload_url, dann übergib die id als video. Rufe NICHT complete_upload auf, das startet die kostenpflichtige Clip-Pipeline. Kostenlose Tools lesen die hochgeladene Datei direkt. Bereits in list_videos vorhandene Videos können ebenfalls als Eingabe verwendet werden.
2. Transkribieren. transcribe(video, language?, diarize?).
   • language – weglassen für automatische Erkennung. Setze es, wenn du die Sprache bereits kennst und verhindern möchtest, dass ein kurzer oder verrauschter Clip falsch erkannt wird.
   • diarize – standardmäßig true, kennzeichnet, wer spricht. Deaktiviere es bei Ein-Sprecher-Audio, um die Ausgabe sauber zu halten.
3. Abfragen. Gibt eine tool_job-Hash-ID zurück. Frage get_tool_job_status(tool_job) alle 5 bis 10 Sekunden ab. queued / processing bedeuten in Bearbeitung, completed gibt permanente CDN-outputs-URLs zurück (ein Format pro Ausgabe: json, srt, vtt), failed gibt error zurück. Die meisten Aufträge sind innerhalb von ein bis zwei Minuten abgeschlossen.
4. Ausgabe lesen. Rufe die JSON-Ausgabe für programmatische Arbeit ab (Segmente mit Start- und Endzeiten, Sprecherlabels). Gib dem Benutzer die SRT- oder VTT-URL, wenn er eine Untertiteldatei möchte.

Zwei verschiedene Transkriptionswerkzeuge

Verwechsle diese nicht:

• transcribe – das KOSTENLOSE Werkzeug. Funktioniert mit jeder hochgeladenen Datei. Dieser Skill.
• get_transcript – liest das Transkript eines Videos, das bereits die BEZAHLTE Clip-Pipeline durchlaufen hat. Unterstützt start_ms / end_ms-Fenster auf Satz- oder Wortebene. Verwende es, wenn du bereits eine job_id eines Clips hast, nicht für einen frischen Upload.

Regeln

• Frage immer ab. Die Transkription ist asynchron, sie gibt den Text nie synchron zurück.
• Zeiten sind in Millisekunden.
• Ausgabe-URLs sind permanente CDN-Links, nicht signiert oder zeitlich begrenzt.
• Die kostenlose Nutzung ist pro Tag ratenbegrenzt, mit einer Dateigrößenbeschränkung. Der Fehlertext erklärt, wie man ein Limit aufheben kann.

Beispielaufforderungen für Aktionen

• „Transkribiere dieses Interview“ – create_upload, PUT-Bytes, transcribe(video), abfragen, das Transkript zurückgeben.
• „Ich brauche eine SRT für dieses Video“ – gleicher Ablauf, dann die URL der srt-Ausgabe zurückgeben.
• „Wer hat was in dieser Meeting-Aufzeichnung gesagt?“ – transcribe(video, diarize=true), abfragen, die JSON-Ausgabe lesen und Segmente nach Sprecher gruppieren.
• „Hole die besten Zitate aus diesem Vortrag“ – transkribieren, abfragen, JSON lesen, dann Zitate mit ihren Zeitcodes auswählen.
• „Es ist auf Niederländisch, transkribiere es“ – transcribe(video, language="nl"), abfragen.

Verwandte Skills

Um das Video dann an diesen Zeitcodes zu schneiden, siehe openclip-video-editing (edit_video mit operation="trim"). Um die Momente, die sich zu schneiden lohnen, automatisch zu finden, siehe openclip-clipping.