mcpField
O
openclip-convert

openclip-convert

github.com/openclip-appクリエイティブ・メディア144 回インストール12 週間前に更新
リポジトリ

openclip-convert について

openclip-convert は、OpenClip を使ってメディアファイルを変換するスキルです。動画・音声の形式変更、GIF の作成、音声抽出に対応し、非同期ジョブの結果は恒久的なリンクで取得できます。

主な機能

  1. 01動画コンテナとコーデックの変換
  2. 02FPS と幅を指定した GIF 作成
  3. 03MP3、AAC、WAV、FLAC への音声抽出
  4. 04非同期変換ジョブのポーリング

活用シーン

  1. 01動画を再生しやすい MP4 に変換
  2. 02トリミングした動画から GIF を作成
  3. 03動画から MP3 音声を抽出
  4. 04編集用のロスレス音声を準備

MCP 対応

https://openclip.app/mcp の OpenClip リモート MCP サーバーを利用します。ファイルをアップロードして convert_media を呼び出し、get_tool_job_status をポーリングして結果を取得します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openclip-app/agent-skills --skill openclip-convert

インストール後、Claude Code で/openclip-convertを入力して読み込まれたか確認します。

詳細

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： Settings、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 を呼び出します。

ファイルの取り込み

  1. create_upload(filename, content_type) は id と upload_url を返します。
  2. 生のバイトデータを upload_url に PUT します。
  3. 返された 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 を使います。

形式を変更するのではなくファイルサイズを指定するには、operation="compress"（target_mb または crf）を指定した edit_video を使います。openclip-video-editing スキルを参照してください。

ポーリング

convert_media は status: "queued" の tool_job ハッシュ ID を返します。5～10 秒ごとに get_tool_job_status(tool_job) をポーリングします。

  • queued / processing — まだ処理中です。ポーリングを続けてください。
  • completed — 永続的な CDN outputs URL と result_meta が返されます。
  • failed — error が返されます。

呼び出しが同期的に完了したと決めつけないでください。

ルール

  • 必ずポーリングしてください。変換は非同期です。
  • 出力 URL は永続的な CDN リンクであり、署名付き URL や期限切れになる URL ではありません。
  • 無料利用には、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 を参照してください。

コメント

Markdown 対応