← Back to Skills Marketplace
Capcut Mate Skill
by
Excalibur9527
· GitHub ↗
· v0.1.1
· MIT-0
1520
Downloads
3
Stars
7
Active Installs
2
Versions
Install in OpenClaw
/install capcut-mate-skill
Description
Automate CapCut video editing by creating projects, adding videos, and rendering final videos via the CapCut Mate API.
README (SKILL.md)
CapCut Mate 自动化技能
这是一个为 OpenClaw 开发的剪映（CapCut）自动化剪辑技能，通过调用 CapCut Mate API，实现视频草稿的自动化创建、素材导入及云端渲染。
🚀 项目概述
CapCut Mate 是一个完全开源、免费的剪映草稿自动化助手，支持本地部署，让大型语言模型具备基础视频编辑能力。
🛠️ 安装与部署说明
1. 服务端部署（CapCut Mate Server）
方式一：Python 原生部署（推荐）
需确保已安装 Python 3.11+ 和 uv 包管理器。
# 克隆仓库
git clone https://github.com/Hommy-master/capcut-mate.git
cd capcut-mate
# 安装依赖
uv sync
# (Windows 系统需额外执行: uv pip install -e .[windows])
# 启动服务
uv run main.py
服务启动后，默认端口为 30000。
方式二：Docker 快速部署
docker-compose pull && docker-compose up -d
⚙️ OpenClaw 技能配置
在你的 OpenClaw 环境 TOOLS.md 中添加 API 地址：
### CapCut Mate 配置
- CAPCUT_MATE_URL: http://localhost:30000/openapi/capcut-mate/v1
📚 完整 API 接口列表
🏗️ 草稿管理
| 接口 | 功能 | 描述 |
|---|---|---|
create_draft |
创建草稿 | 创建新的剪映草稿项目，设置画布尺寸 |
save_draft |
保存草稿 | 保存当前草稿状态，确保编辑内容持久化 |
get_draft |
获取草稿 | 获取草稿文件列表和详细信息 |
🎥 视频素材
| 接口 | 功能 | 描述 |
|---|---|---|
add_videos |
添加视频 | 批量添加视频素材，支持裁剪、缩放、特效 |
add_images |
添加图片 | 批量添加图片素材，支持动画和转场效果 |
add_sticker |
添加贴纸 | 添加装饰贴纸，支持位置和大小调整 |
🎵 音频处理
| 接口 | 功能 | 描述 |
|---|---|---|
add_audios |
添加音频 | 批量添加音频素材，支持音量和淡入淡出 |
get_audio_duration |
获取音频时长 | 获取音频文件的精确时长信息 |
📝 文本字幕
| 接口 | 功能 | 描述 |
|---|---|---|
add_captions |
添加字幕 | 批量添加字幕，支持关键词高亮和样式设置 |
add_text_style |
文本样式 | 创建富文本样式，支持关键词颜色和字体 |
✨ 特效与动画
| 接口 | 功能 | 描述 |
|---|---|---|
add_effects |
添加特效 | 添加视觉特效，如滤镜、边框、动态效果 |
add_keyframes |
关键帧动画 | 创建位置、缩放、旋转等属性动画 |
add_masks |
遮罩效果 | 添加各种形状遮罩，控制画面可见区域 |
🎨 动画资源查询
| 接口 | 功能 | 描述 |
|---|---|---|
get_text_animations |
文本动画 | 获取可用的文本入场、出场、循环动画 |
get_image_animations |
图片动画 | 获取可用的图片动画效果列表 |
🎬 视频生成
| 接口 | 功能 | 描述 |
|---|---|---|
gen_video |
生成视频 | 提交视频渲染任务，异步处理 |
gen_video_status |
查询状态 | 查询视频生成任务的进度和状态 |
🚀 快速工具
| 接口 | 功能 | 描述 |
|---|---|---|
easy_create_material |
快速创建 | 一次性添加多种类型素材，简化创建流程 |
🛠️ 详细工具类接口
| 接口 | 功能 | 描述 |
|---|---|---|
get_url |
提取URL | 从输入内容中提取 URL 信息 |
search_sticker |
搜索贴纸 | 根据关键词搜索贴纸素材 |
objs_to_str_list |
对象转字符串列表 | 将对象列表转换为字符串列表格式 |
str_list_to_objs |
字符串列表转对象 | 将字符串列表转换为对象列表格式 |
str_to_list |
字符串转列表 | 将字符串转换为列表格式 |
timelines |
创建时间线 | 生成视频编辑所需的时间线配置 |
audio_timelines |
音频时间线 | 根据音频时长计算时间线 |
audio_infos |
音频信息 | 根据 URL 和时间线生成音频信息 |
imgs_infos |
图片信息 | 根据 URL 和时间线生成图片信息 |
caption_infos |
字幕信息 | 根据文本和时间线生成字幕信息 |
effect_infos |
特效信息 | 根据名称和时间线生成特效信息 |
keyframes_infos |
关键帧信息 | 根据配置生成关键帧信息 |
video_infos |
视频信息 | 根据 URL 和时间线生成视频信息 |
🛠️ 高级用法：桌面端客户端
如果你需要桌面图形界面，可在项目目录下执行：
# 安装依赖
npm install --verbose
# 启动 Web 开发版
npm run web:dev
# 启动客户端
npm start
💡 开发支持
- Coze 插件: 本项目支持一键导入 Coze 平台作为插件使用。
- 开源社区: 如有疑问，请参阅项目主页的微信交流群。
Usage Guidance
This skill appears to do what it says: it wraps calls to a CapCut Mate server. Before installing, verify the CapCut Mate server repository (the SKILL.md points to https://github.com/Hommy-master/capcut-mate.git) and only deploy it on a host you control. Ensure you set CAPCUT_MATE_URL in your environment (the registry metadata should declare this but currently does not). Do not expose the local CapCut Mate server port publicly unless you trust the deployment and understand privacy implications for uploaded media. If you need higher assurance, review the upstream capcut-mate codebase and run it in an isolated environment (container or VM) before connecting the skill.
Capability Analysis
Type: OpenClaw Skill
Name: capcut-mate-skill
Version: 0.1.1
The skill is a legitimate automation bridge for the CapCut Mate API, allowing an AI agent to manage video drafts and rendering. The code in index.js consists of standard API wrappers using axios, and the SKILL.md provides clear documentation for local server deployment without any signs of prompt injection or malicious intent.
Capability Assessment
Purpose & Capability
The skill is described as a CapCut Mate automation helper and the code + SKILL.md implement and document calls to a CapCut Mate server API. One minor mismatch: registry metadata lists no required environment variables, but both the code and SKILL.md expect CAPCUT_MATE_URL to be configured.
Instruction Scope
SKILL.md limits runtime actions to deploying/connecting to a CapCut Mate server (git clone, uv/docker-compose), configuring CAPCUT_MATE_URL, and using the documented API. The instructions do not ask the agent to read arbitrary system files or exfiltrate data to unrelated endpoints.
Install Mechanism
This is an instruction-only skill with a small wrapper index.js and package.json. The SKILL.md tells users to clone a GitHub repo or use docker-compose — GitHub and docker-compose are normal sources for open-source projects. There is no opaque download-from-personal-server or extract step in the skill bundle itself.
Credentials
The skill needs a CAPCUT_MATE_URL (used by index.js) but the registry metadata does not declare it as a required env var; this is an inconsistency that should be corrected. No sensitive credentials (API keys, tokens, passwords) are requested by the skill.
Persistence & Privilege
The skill is not always-enabled and does not request elevated/persistent system privileges or modify other skills' configurations. It uses standard network calls to the configured CapCut Mate endpoint.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install capcut-mate-skill - After installation, invoke the skill by name or use
/capcut-mate-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- Major documentation update: SKILL.md now includes comprehensive installation, deployment, API overview, configuration, and advanced usage instructions in Chinese.
- Expanded API list: All available CapCut Mate API endpoints and their functionalities are now documented.
- Installation and deployment instructions now detail both native Python and Docker methods.
- OpenClaw skill configuration and advanced desktop client usage are clearly outlined.
v0.1.0
Initial release: Integrates CapCut Mate API with OpenClaw for automated video editing.
- Create new video editing projects through CapCut Mate.
- Add video materials to projects.
- Render final videos using automation commands.
- Simple configuration via CAPCUT_MATE_URL.
Metadata
Frequently Asked Questions
What is Capcut Mate Skill?
Automate CapCut video editing by creating projects, adding videos, and rendering final videos via the CapCut Mate API. It is an AI Agent Skill for Claude Code / OpenClaw, with 1520 downloads so far.
How do I install Capcut Mate Skill?
Run "/install capcut-mate-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Capcut Mate Skill free?
Yes, Capcut Mate Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Capcut Mate Skill support?
Capcut Mate Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Capcut Mate Skill?
It is built and maintained by Excalibur9527 (@excalibur9527); the current version is v0.1.1.
More Skills