renezander030/capcut-cli

これは何？

主な機能

• 01ローカルのCapCutおよびJianYingのドラフトJSONを編集し、アプリ内でトラックを編集可能な状態に保ちます。
• 02動画、音声、テキストを追加し、トリミング、速度・音量の変更、トランジションを適用します。
• 03SRTおよびVTT字幕のインポート・エクスポートに対応し、単語単位の字幕も扱えます。
• 04無音区間、シーン、繰り返しテイクを検出して、長時間の録画をショート動画に分割します。
• 05自動化向けにCLI、型付きライブラリ、JSONLキューランナーを提供します。

ユースケース

• 長時間の録画から、字幕付きショート動画をまとめて作成する。
• SRTファイルを使って、既存のCapCutプロジェクトの字幕を生成または修正する。
• LLMエージェントが決定的なコマンドインターフェースを通じてドラフトを確認・作成できるようにする。
• 字幕を翻訳して、ドラフトの多言語版を作成する。

クイックスタート

1. 1

   npmからCLIをグローバルにインストールする

   npm install -g capcut-cli
2. 2

   doctorコマンドでセットアップを確認する

   capcut doctor
3. 3

   動画と字幕を含む最初のプロジェクトを作成する

   capcut quickstart my-first --video clip.mp4 --srt captions.srt
4. 4

   プロジェクトを人が読みやすい形式で確認する

   capcut info ./my-first/ -H

使う前に知っておきたいこと

• !Node 18以降が必要です。一部のコマンドでは、Whisper、FFmpeg、Anthropic APIキーなどのオプションツールも必要です。
• !CapCutやByteDanceとは関係のない、非公式のコミュニティプロジェクトです。
• !出力はCapCutまたはJianYingで開いてレンダリングする必要があります。このツール自体は最終動画を公開もレンダリングもしません。

トピック

よくある質問

capcut-cli とは？

APIやサーバーなしで、CapCut / JianYingのドラフトをローカルJSONとして編集するCLIツール兼ライブラリ。 capcut-cliは、ローカルのドラフト保存領域を直接操作して、実際のCapCutおよびJianYing（剪映）プロジェクトを作成・編集します。各コマンドはJSONを読み込んでJSONを書き戻すため、出力したプロジェクトは動画、字幕、その他のトラックを編集可能な状態でCapCutから開けます。フラット化された書き出し動画にはなりません。メディアやテキストの追加、トリミング、速度・音量の変更、トランジション、テンプレート、SRTやVTT字幕のインポート・エクスポートなどに対応しています。

capcut-cli は無料で使えますか？ライセンスは？

capcut-cli は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

capcut-cli は今もメンテナンスされていますか？

活発にメンテナンス中。capcut-cli の最終コミットは 2026年10月19日 です。

capcut-cli は何に使えますか？

長時間の録画から、字幕付きショート動画をまとめて作成する。 SRTファイルを使って、既存のCapCutプロジェクトの字幕を生成または修正する。 LLMエージェントが決定的なコマンドインターフェースを通じてドラフトを確認・作成できるようにする。 字幕を翻訳して、ドラフトの多言語版を作成する。

capcut-cli のインストール方法は？

npmからCLIをグローバルにインストールする: npm install -g capcut-cli doctorコマンドでセットアップを確認する: capcut doctor 動画と字幕を含む最初のプロジェクトを作成する: capcut quickstart my-first --video clip.mp4 --srt captions.srt プロジェクトを人が読みやすい形式で確認する: capcut info ./my-first/ -H

capcut-cli はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/renezander030/capcut-cli