openclip-captions

OpenClip：クリップに字幕を追加する

render_clip は、OpenClip のクリッピングパイプラインで生成されたバイラルな瞬間に、アニメーション字幕を焼き込みます。これは有料パイプラインの一部であり、有効なサブスクリプションとクレジットが必要です。

ここでの字幕は動画に直接レンダリングされ、サイドカー形式の字幕ファイルではありません。代わりに SRT ファイルまたは VTT ファイルが必要な場合は、無料の transcribe ツールを使用してください。詳しくは openclip-transcription をご覧ください。

セットアップ（一度だけ）

OpenClip は https://openclip.app/mcp にあるリモート MCP サーバーです。OAuth プロンプトが表示されたら OpenClip アカウントでサインインしてください。コピーする API キーはありません。

• Claude Code： claude mcp add --transport http openclip https://openclip.app/mcp を実行し、その後 /mcp で認証します。
• Claude Desktop / web： 設定を開き、「コネクタ」から「カスタムコネクタを追加」を選択して URL を貼り付け、サインインします。
• Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• ヘッダーのみ対応するクライアント： openclip.app/settings/connect で MCP トークンを発行し、Authorization: Bearer <token> を指定して https://openclip.app/mcp/key に接続します。

動作確認：get_account を呼び出し、credits_remaining > 0 であることを確認します。

手順

1. 対象となる瞬間を用意します。 list_clips(job_id) から moment_id を取得する必要があります。ユーザーがまだ動画をパイプラインに通していない場合は、まず submit_video を実行します。詳しくは openclip-clipping スキルをご覧ください。
2. プリセットを選びます。 list_caption_presets を呼び出して、現在のキーを取得します。既知のキーは次のとおりです。 default、dan、dan-reveal、pop、mozi、kendrick、sara、lucy、tayo、beast。 必ず呼び出して確認してください。 キーは変更される場合があります。同じ呼び出しで、字幕スタイルのプロパティスキーマ全体と字幕の位置オプションも返されます。これは、名前付きプリセットではなくカスタムスタイルを使用する際に必要です。
3. レンダリングします。 render_clip(moment_id, caption_preset) を呼び出します。
4. 状態を確認します。 レンダリングは非同期です。list_clips(job_id) をポーリングして、対象の瞬間の rendered_clip フィールドを確認します。このフィールドが表示されると、完成した字幕付き動画を示す {url, size_bytes} が格納されています。get_render_status ではレンダリングの状態を直接確認できます。

プリセットの選び方

プリセットは単なるフォントではなく、視覚的なスタイルです。ユーザーがクリエイター名や雰囲気を指定した場合は、次のように対応させます。

• 大きく、力強く、太い縁取りで単語ごとに表示するポップなスタイル - beast。
• すっきりと読みやすく、ブランドアカウントに適した無難なデフォルト - default。
• 弾むような楽しいスタイル - pop。
• 単語が順に表示されるリビールスタイル - dan-reveal。

ユーザーがこだわらない場合は default を使い、切り替えられるよう他のキーも提示します。どのプリセットにもないスタイルを希望する場合は、無理に近いプリセットを選ばず、list_caption_presets から字幕スタイルのプロパティスキーマを取得し、カスタムスタイルを作成します。

ルール

• レンダリング前に、必ず list_caption_presets でプリセットキーを確認します。不明な caption_preset を指定すると、ツールの結果に検証メッセージが返されます。
• 必ずポーリングします。render_clip はすぐに戻りますが、動画はまだ完成していません。
• 同じ瞬間を別のプリセットで再レンダリングできます。rendered_clip には、最後に成功したレンダリングの結果が反映されます。
• clip は未レンダリングのクリップ、clip_watermarked はウォーターマーク付きのバージョン、rendered_clip は字幕付きの出力です。ユーザーに適切なものを渡してください。
• 時間の単位はミリ秒です。

エラー

ツールの失敗は HTTP ステータスではなく、isError: true とプレーンテキストのメッセージを含むツール結果として返されます。

• "Viral moment not found." - moment_id が間違っているか、別のアカウントに属しています。list_clips を再実行し、その応答に含まれる ID を使ってください。
• "Not authenticated. Reconnect your OpenClip token." - 再接続するか、トークンを再発行してください。
• 不明なプリセットキーを指定すると、検証メッセージのテキストが返されます。list_caption_presets を呼び出し、有効なキーで再試行してください。

プロンプトからアクションへの例

• 「このクリップにキャプションを追加して」 - list_caption_presets、render_clip(moment_id, caption_preset="default")、ポーリングします。
• 「MrBeast風にして」 - render_clip(moment_id, caption_preset="beast")、ポーリングします。
• 「どんなキャプションスタイルがありますか？」 - list_caption_presets を実行し、キーを表示します。
• 「上位3つすべてにキャプションを付けて」 - list_clips を実行し、virality_score の上位3つを選んでそれぞれに render_clip を実行し、 すべての rendered_clip が揃うまでポーリングします。
• 「キャプションを上部に配置して、ブランドフォントを使いたい」 - スタイルのスキーマと位置のオプションを確認するために list_caption_presets を実行し、カスタムスタイルでレンダリングします。

関連項目

キャプションを付けるクリップの作成については openclip-clipping を参照してください。スタンドアロンのSRTおよびVTT字幕ファイルについては openclip-transcription を参照してください。キャプションプリセットを再利用可能な処理エージェントに固定する方法については openclip-clipping で説明しています。