Builderoom

2026年9月25日

安装

在终端或 LLM agent 中编辑 CapCut 和剪映项目草稿,无需 API,直接读写本地 JSON 文件。

MIT
安装命令(说明)bash
npm install -g capcut-cli
最小用法bash
capcut doctor
capcut quickstart my-first --video clip.mp4 --srt captions.srt
capcut info ./my-first/ -H

产品信息

形态
命令行工具
分类
创意与多媒体 › 视频剪辑与后期
定价
开源
授权协议
MIT
首发日期
2026年9月25日
收录时间
2026年9月25日

概览

GitHubGitHub

capcut-cli 是一个独立的、非官方的命令行工具,用于在终端中创建和编辑 CapCut 与 JianYing(剪映)项目。它直接操作本地的 `draft_content.json` 和 `draft_info.json` 文件,不需要上传、API、MCP server 或 HTTP daemon。 该工具的核心工作流是将原始录音转化为带有静音感知剪辑和样式化字幕的可编辑草稿。生成的项目可以在 CapCut 或剪映中打开,所有轨道均保持可编辑状态,而非扁平化的导出文件。 **使用方式** - **CLI**:通过 `npm install -g capcut-cli` 安装后,使用 `capcut <command> <project>` 执行命令。 - **Library**:作为 JavaScript 库导入,提供 `loadDraft`、`lintDraft`、`saveDraft` 等类型化函数,零依赖。 - **Queue runner**:运行 `capcut serve` 从 stdin 读取 JSONL 任务,适用于 n8n、Make、Coze 等自动化平台。 - **Agent sandbox**:实验性的 WebAssembly 组件,为 AI agent 提供只读的 MCP 工具,不包含文件系统或网络访问权限。 **主要能力** 支持字幕编辑、时间轴调整、速度控制、音量调节、模板应用以及将长视频裁剪为短视频。对于较新版本的 CapCut,它能检测并同步所有可读的时间轴目标。同时支持中文和英文请求触发。 **前置条件** 需要 Node.js 18 及以上版本,仅使用内置模块,无原生依赖。部分命令需要可选工具:`caption` 命令需要 Whisper,`render` 命令需要 FFmpeg,自动媒体元数据需要 ffprobe,`translate` 命令需要配置 `ANTHROPIC_API_KEY`。 **Python 支持** 可通过 `pip install capcut` 安装 Python 包装器,调用相同的底层二进制文件。 该项目采用 MIT 协议开源,与 ByteDance、CapCut 或剪映官方无关。

功能特性

  • 本地草稿读写:直接读写本地 draft_content.json 和 draft_info.json,无需上传或使用 API。
  • 多轨道可编辑输出:生成的项目可在 CapCut 或剪映中打开,所有轨道保持可编辑状态。
  • 字幕与时间轴编辑:支持字幕添加、时间轴调整、速度控制和音量调节。
  • 长视频转短视频:支持将长视频裁剪为适合短视频平台的格式。
  • LLM Agent 集成:可作为技能安装到 Claude Code、Codex、Cursor 等 AI agent 中使用。
  • 队列运行模式:通过 capcut serve 从 stdin 读取 JSONL 任务,适配自动化工作流。
  • JavaScript 库调用:可作为零依赖的 JS 库导入,提供类型化的草稿操作函数。
  • Python 包装器:通过 pip 安装 Python 包,调用相同的底层功能。
  • Wasm 沙盒模式:实验性 WebAssembly 组件,为 AI 提供无文件系统访问的只读检查工具。
  • 多语言触发:支持通过中文(如剪映、字幕、草稿)或英文指令触发相应功能。

版本更新

新版本提醒我

首个版本 · capcut-cli

Q&A

capcut-cli 是官方工具吗?由 AI 生成
不是。它是一个独立的、社区维护的非官方项目,与 CapCut、剪映或 ByteDance Ltd. 没有附属、赞助或背书关系。
使用 capcut-cli 需要 API 密钥吗?由 AI 生成
核心功能不需要 API、MCP server 或 HTTP daemon,直接操作本地 JSON 文件。但 translate 命令需要配置 ANTHROPIC_API_KEY。
需要什么环境才能运行?由 AI 生成
需要 Node.js 18 或更高版本,且仅使用内置模块,无原生依赖。Whisper、FFmpeg 和 ffprobe 为可选工具,用于特定命令。
生成的项目可以直接发布吗?由 AI 生成
生成的是包含可编辑轨道的真实本地项目草稿,需要在 CapCut 或剪映中打开进行审查、调整和渲染,发布操作仍需人工完成。
旧版本有什么安全问题?由 AI 生成
0.17.2 及更早版本的 fixture bundles 可能包含未清理的设备标识符;0.17.0 及更早版本存在本地命令注入和不安全的临时文件行为。这些问题已在 0.18.0 和 0.17.1 中修复,建议升级到最新版本。
安装
收藏

这个产品还没有主理人

由平台收录或原作者已注销。如果它是你的作品,证明与它的关系后即可成为主理人。

认领这个产品