OpenClip 語音轉錄是什麼？

此技能提供一個名為 `transcribe` 的 MCP 工具，可將影片或音訊檔案轉換為帶有時間碼的文字稿。它完全免費，僅需一個 OpenClip 帳號，無需訂閱或點數，非常適合開發者快速為內容建立字幕或進行文字分析。支援的輸出格式包括結構化的 JSON（含時間戳記與說話者標籤）、以及標準的 SRT 和 VTT 字幕檔案。工作流程為非同步：使用者先上傳檔案，然後呼叫 `transcribe` 工具，並透過輪詢 `get_tool_job_status` 來取得結果。大多數任務在一兩分鐘內即可完成。此工具可於多種平台上使用，包括 Claude Code、Claude Desktop/Web 和 Cursor，透過 OpenClip 遠端 MCP 伺服器進行連接。協定支援 HTTP 傳輸以及選用的標頭式驗證（使用 MCP 權杖）。此技能與付費的 `get_transcript` 工具不同，後者用於存取已透過 OpenClip 剪輯管道處理過的影片文字稿。

相容平台✓Claude Code~Codex CLI✓Cursor

npx skills add https://github.com/OpenClip-App/agent-skills/tree/main/skills/openclip-transcription

說明文件

OpenClip：轉錄

transcribe 可將影片或音訊檔案轉換為帶有時間碼的文字稿。此工具完全免費，需要 OpenClip 帳號，但無需訂閱或點數。輸出格式包括：JSON（結構化，含時間碼）、SRT 和 VTT。

設定（一次性）

OpenClip 是一個位於 https://openclip.app/mcp 的遠端 MCP 伺服器。當 OAuth 提示出現時，請使用你的 OpenClip 帳號登入，無需複製任何 API 金鑰。

Claude Code： claude mcp add --transport http openclip https://openclip.app/mcp，然後使用 /mcp 進行授權。
Claude Desktop / 網頁版： 設定 → 連接器 →「新增自訂連接器」，貼上 URL 並登入。
Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
僅使用標頭的客戶端： 前往 openclip.app/settings/connect 建立 MCP 權杖，然後使用 Authorization: Bearer <權杖> 連線至 https://openclip.app/mcp/key。

驗證方式：呼叫 get_account。

流程

上傳。 create_upload(filename, content_type) 會回傳一個 id 和一個 upload_url。將原始位元組以 PUT 方式傳送至 upload_url，然後將 id 作為 video 參數傳入。請勿呼叫 complete_upload，否則會啟動付費的剪輯管道。免費工具會直接讀取上傳的檔案。list_videos 中已有的影片也可作為輸入。
轉錄。 transcribe(video, language?, diarize?)。
- language - 省略則自動偵測。若已知語言，請設定此參數，以避免短或吵雜的片段被誤判。
- diarize - 預設為 true，會標記說話者。對於單一說話者的音訊，可關閉此選項以保持輸出簡潔。
輪詢。 會回傳一個 tool_job 的 hashid。每 5 到 10 秒輪詢 get_tool_job_status(tool_job)。狀態為 queued / processing 表示正在處理中，completed 會回傳永久的 CDN outputs URL（每個格式一個：json、srt、vtt），failed 則會回傳 error。大多數任務會在一兩分鐘內完成。
讀取輸出。 對於程式化工作，請取得 JSON 輸出（包含開始與結束時間及說話者標籤的片段）。當使用者需要字幕檔案時，提供 SRT 或 VTT URL。

兩種不同的轉錄工具

請勿混淆：

transcribe - 免費工具。可處理你上傳的任何檔案。此技能即為此工具。
get_transcript - 讀取已透過付費剪輯管道處理的影片文字稿。支援句子或詞語層級的 start_ms / end_ms 時間視窗。僅在你已有剪輯 job_id 時使用，不適用於新上傳的檔案。

規則

務必輪詢。轉錄是非同步的，從不會同步回傳文字。
時間單位為毫秒。
輸出 URL 是永久的 CDN 連結，無需簽署或具有時效性。
每日免費使用有速率限制，並有單一檔案大小上限。錯誤訊息會說明如何解除限制。

範例提示與對應動作

「轉錄這段訪談」- create_upload、PUT 位元組、transcribe(video)、輪詢、回傳文字稿。
「我需要這段影片的 SRT」- 同上，然後回傳 srt 輸出 URL。
「這場會議錄音中誰說了什麼？」- transcribe(video, diarize=true)、輪詢、讀取 JSON 輸出並按說話者分組片段。
「從這場演講中摘錄最佳引文」- 轉錄、輪詢、讀取 JSON，然後選取帶有時間碼的引文。
「這是荷蘭文，幫我轉錄」- transcribe(video, language="nl")、輪詢。

OpenClip 語音轉錄