capcut-mate-skill

by excalibur9527

Install this Skill

curl -fsSL -o capcut-mate-skill.zip https://skill.seembox.com/api/v1/skills/capcut-mate-skill/download && unzip capcut-mate-skill.zip

Download capcut-mate-skill.zip

SKILL.md About

# CapCut Mate 自动化技能

这是一个为 OpenClaw 开发的剪映（CapCut）自动化剪辑技能，通过调用 CapCut Mate API，实现视频草稿的自动化创建、素材导入及云端渲染。

## 🚀 项目概述
CapCut Mate 是一个完全开源、免费的剪映草稿自动化助手，支持本地部署，让大型语言模型具备基础视频编辑能力。

## 🛠️ 安装与部署说明

### 1. 服务端部署（CapCut Mate Server）

#### 方式一：Python 原生部署（推荐）
需确保已安装 `Python 3.11+` 和 `uv` 包管理器。
```bash
# 克隆仓库
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 快速部署
```bash
docker-compose pull && docker-compose up -d
```

---

## ⚙️ OpenClaw 技能配置
在你的 OpenClaw 环境 `TOOLS.md` 中添加 API 地址：
```markdown
### CapCut Mate 配置
- CAPCUT_MATE_URL: http://localhost:30000/openapi/capcut-mate/v1
```

---

## 📚 完整 API 接口列表

### 🎵 音频处理
| 接口 | 功能 | 描述 |
| :--- | :--- | :--- |
| `add_audios` | 添加音频 | 批量添加音频素材，支持音量和淡入淡出 |
| `get_audio_duration` | 获取音频时长 | 获取音频文件的精确时长信息 |

### 📝 文本字幕
| 接口 | 功能 | 描述 |
| :--- | :--- | :--- |
| `add_captions` | 添加字幕 | 批量添加字幕，支持关键词高亮和样式设置 |
| `add_text_style` | 文本样式 | 创建富文本样式，支持关键词颜色和字体 |

### 🎨 动画资源查询
| 接口 | 功能 | 描述 |
| :--- | :--- | :--- |
| `get_text_animations` | 文本动画 | 获取可用的文本入场、出场、循环动画 |
| `get_image_animations` | 图片动画 | 获取可用的图片动画效果列表 |

### 🎬 视频生成
| 接口 | 功能 | 描述 |
| :--- | :--- | :--- |
| `gen_video` | 生成视频 | 提交视频渲染任务，异步处理 |
| `gen_video_status` | 查询状态 | 查询视频生成任务的进度和状态 |

### 🚀 快速工具
| 接口 | 功能 | 描述 |
| :--- | :--- | :--- |
| `easy_create_material` | 快速创建 | 一次性添加多种类型素材，简化创建流程 |

---

## 🛠️ 高级用法：桌面端客户端
如果你需要桌面图形界面，可在项目目录下执行：
```bash
# 安装依赖
npm install --verbose
# 启动 Web 开发版
npm run web:dev
# 启动客户端
npm start
```

## 💡 开发支持
- **Coze 插件**: 本项目支持一键导入 Coze 平台作为插件使用。
- **开源社区**: 如有疑问，请参阅项目主页的微信交流群。

_meta.json Metadata

{
  "ownerId": "kn74zxrmcf06a2zrrfbeqprmtn82934b",
  "publishedAt": 1773299072054,
  "slug": "capcut-mate-skill",
  "version": "0.1.1"
}