CapCutを開かずに、編集できる下書きまで組み立てるCLI

2026年8月30日

自動化で困るのは、速く書き出せても『最後に自分で少し直したい』ができないことです。capcut-cliが狙っているのは、完成MP4ではなく、CapCutで開いて触れる下書きそのものです。

何が起きている？

capcut-cliはCapCut／JianYingのローカル下書きを読み書きする非公式のオープンソースCLIです。動画、音声、字幕、速度、マスクなどをコマンドで組み、編集可能なプロジェクトとして開けます。

READMEでは、HTTPサーバーや非公開APIを介さずローカルの下書きストアを扱うと説明しています。現行版は複数のタイムライン文書を検出し、単一JSONだけを正と決めつけない設計へ更新されています。

一方でCapCut本体の保存形式は公式の安定APIではありません。README自身が古い版の安全問題と、最新版への更新、編集画面を閉じてからの操作を注意点として掲げています。

定型ショートの字幕スタイル、尺違い、差し替えを繰り返す人には、手順を再現可能な命令にできる点が魅力です。『AIに自由に編集させる』より、決めた操作をJSONで受け渡し、最後は人がCapCutで見る方が運用しやすい場面があります。

本番下書きを直接使わず、複製したプロジェクトと短い素材で試してください。CapCut更新後はdoctorやlintで読み取り状況を確認し、形式が未知なら書き込みを止める方が安全です。非公式ツールなので、使えることと長期互換が保証されることは別です。

複製した30秒のプロジェクトに、動画一本、SRT一本、BGM一本だけを入れます。CLIで下書きを作った後、CapCutで各トラックが編集可能か、字幕のスタイル、素材リンク、再起動後の状態を確認します。最新版とCapCut本体の版も一緒に記録します。

定型作業が三回以上繰り返され、下書きを人が最終調整したいなら採用候補です。本体更新のたびに修復へ時間を取られる、または複製運用が守れないなら見送ります。

判断	見る条件
試す	複製した短い下書きで試す。再現性は高いが、非公式形式のバージョン境界を必ず確認する。
待つ	原投稿の条件と手元の環境を比較できない

試す前の判断線

大吉

字幕入りショートを毎回同じ手順で作るなら、テンプレより細かく再利用できそう。

影

本体更新で保存形式が変われば壊れる。元プロジェクトを触る運用は怖いね。

大吉

なら、本番とは別の複製下書きで、CapCut更新後も開けるかだけ小さく確かめたい。

見極

価値は全自動ではなく、編集結果が人の触れる下書きとして戻ることです。

複製した短い下書きで試す。再現性は高いが、非公式形式のバージョン境界を必ず確認する。