OpenClip: メディア変換
convert_media はファイルのコンテナ形式やコーデックを変更します。動画からGIFへの変換や、動画から音声のみの抽出も可能です。無料で利用でき、OpenClipアカウントは必要ですが、サブスクリプションやクレジットは不要です。
セットアップ(初回のみ)
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: 設定 → Connectors → 「Add custom connector」で 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 を呼び出します。
ファイルの取り込み
create_upload(filename, content_type)はidとupload_urlを返します。- 生のバイト列を
upload_urlに PUT します。 - 返された
idをfile引数として渡します。
complete_upload を呼び出さないでください。 それは有料のクリッピングパイプラインを開始します。無料ツールはアップロードされたファイルを直接読み取ります。list_videos にすでにあるファイルも入力として使用できます。
出力形式
convert_media(file, to, ...params) の形式で使用します。
- 動画コンテナ -
mp4、webm、mov、mkv。ユーザーが「どこでも再生できるもの」を求めている場合のデフォルトはmp4です。 - GIF - オプションで
fps(デフォルト 12)とwidth(デフォルト 480)を指定できます。滑らかな動きにするにはfpsを上げ、鮮明なGIFにするにはwidthを上げますが、どちらもファイルサイズが大幅に増加します。GIFはすぐにサイズが大きくなるため、長い動画の場合は最初にトリミングしてください。 - 音声 -
mp3、aac、wav、flac。動画から音声を抽出するために使用します。共有用にはmp3、他のツールでロスレス音声を扱う場合にはwavまたはflacを使用します。
ファイルサイズを目標にするのではなく形式を変換するには、edit_video を operation="compress"(target_mb または crf)で使用します。詳しくは openclip-video-editing スキルを参照してください。
ポーリング
convert_media は tool_job というハッシュIDと status: "queued" を返します。5~10秒ごとに get_tool_job_status(tool_job) をポーリングします。
queued/processing- まだ処理中です。ポーリングを続けてください。completed- 永続的なCDNのoutputsURLとresult_metaを返します。failed-errorを返します。
同期的に完了するとは想定しないでください。
ルール
- 必ずポーリングを行ってください。変換は非同期です。
- 出力URLは永続的なCDNリンクであり、署名や期限切れはありません。
- 無料利用は1日あたりのレート制限と1ファイルあたりのサイズ制限があります。エラーテキストに制限を解除する方法が記載されています。
- 長い動画をGIFに変換すると巨大なファイルになります。まずは興味のある数秒間にトリミングしてから変換してください。
例: プロンプトからアクションへ
- 「これをmp4に変換して」 -
create_upload、バイト列のPUT、convert_media(file, to="mp4")、ポーリング。 - 「これをGIFにして」 - まず
edit_videoで目的の瞬間にトリミングし、次にconvert_media(file, to="gif", fps=15, width=640)、ポーリング。 - 「音声だけ抽出して」 -
convert_media(file, to="mp3")、ポーリング。 - 「編集用にロスレス音声が必要」 -
convert_media(file, to="wav")、ポーリング。
関連スキル
トリミング、クロッピング、サイズ指定圧縮は openclip-video-editing にあります。抽出した音声の文字起こしは openclip-transcription で行います。