openclip-video-editing

OpenClip：動画編集

edit_video は、動画ファイルに対して1回の呼び出しにつき1つの操作を実行します。トリミング、切り抜き、回転、サイズ変更、圧縮、またはミュートができます。無料で利用でき、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: 設定から「コネクタ」を開き、「カスタムコネクタを追加」を選択して 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 を video 引数として渡します。

complete_upload は呼び出さないでください。 これは有料のクリッピングパイプラインを開始します。無料ツールはアップロード済みファイルを直接読み取ります。list_videos にすでにある動画も入力として使用できます。

操作

各呼び出しは edit_video(video, operation, ...params) の形式です。

• crop - aspect（"1:1"、"9:16"、"16:9"、"4:5"）または明示的な x、y、width、height を指定します。横向きの映像を TikTok、Reels、Shorts 向けに再構成するには、aspect: "9:16" を使用します。
• trim - start_ms と end_ms の両方が必須です。時刻の単位はミリ秒です。
• rotate - degrees（90、180、270）および／または flip（none、horizontal、vertical）を指定します。
• resize - ピクセル単位で width と height を指定します。
• compress - target_mb（目標ファイルサイズ）または crf（18～32。値が小さいほど画質が高く、ファイルサイズも大きくなります）を指定します。ユーザーがサイズ制限を指定した場合は、target_mb を使用してください。
• mute - パラメーターは不要です。音声トラックを削除します。

ポーリング

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

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

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

ルール

• 1回の呼び出しにつき1つの操作を実行します。トリミングしてから再構成するには、まず trim を実行し、その出力を crop 呼び出しに渡します。
• 時刻の単位はすべてミリ秒で、秒ではありません。
• 出力 URL は永続的な CDN リンクであり、署名付き URL や期限付き URL ではありません。
• 無料利用には、1日あたりのレート制限とファイルごとのサイズ上限があります。エラーメッセージに制限の解除方法が記載されています。

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

• 「最初の30秒だけにして」 - create_upload を実行してバイト列を PUT し、edit_video(video, operation="trim", start_ms=0, end_ms=30000) を呼び出してポーリングします。
• 「TikTok 用に縦長にして」 - edit_video(video, operation="crop", aspect="9:16") を呼び出してポーリングします。
• 「このファイルは400MBです。50MB未満にして」 - edit_video(video, operation="compress", target_mb=50) を呼び出してポーリングします。
• 「音声を削除して」 - edit_video(video, operation="mute") を呼び出してポーリングします。
• 「真ん中の1分にトリミングして正方形にして」 - trim を実行してポーリングし、その出力を aspect="1:1" で crop して、もう一度ポーリングします。

関連項目

形式間の変換（mp4、gif、mp3）には convert_media を使用します。openclip-convert スキルを参照してください。長い動画を評価順の短いクリップにするには、有料のパイプラインを使用します。openclip-clipping を参照してください。