| name | bgm-library |
| description | 搜索、筛选并下载 ccMixter 免版税背景音乐（仅 CC BY / CC BY-SA，商用安全）， 自动生成 TASL 署名。支持关键词搜索、5 套场景预设、按主题自动选曲、按 ID 下载。 纯客户端，无需 API key。 |
| metadata | {"openclaw":{"emoji":"🎵","requires":{"bins":["node"]},"homepage":"https://ccmixter.org"}} |
ccMixter 免版税背景音乐库
凭据：无需 API key。ccMixter 是 Creative Commons 创建的社区 remix 站，全部音乐已带 CC 协议。
搜索、筛选并下载商用安全的免版税背景音乐，自动生成署名文件。供 video-edit / video-producer 的配乐环节使用，也可独立调用。
通过 PATH 调用 wrapper，无需拼接脚本路径：
bgm-library <command> [args]
协议过滤（默认开启）
只放行商用安全协议，任何含 NonCommercial (NC) 或 NoDerivs (ND) 的协议一律拦截：
- ✅ 允许：CC BY（署名）、CC BY-SA（署名-相同方式共享）
- ❌ 拦截：含 NC / ND 的任何协议
--no-commercial-only 可放开（不推荐，商用项目会侵权）。
Commands
search [keywords...] — 关键词 / 预设搜索
bgm-library search chill lofi --limit 5
bgm-library search --preset travel
| Flag | Default | Description |
|---|
-l, --limit <n> | 10 | 最多返回条数 |
-p, --preset <name> | — | 预设：travel / tech / lofi / food / workout |
--commercial-only / --no-commercial-only | on | 协议过滤开关 |
--sort <field> | score | date / name / score |
pick <theme> — 按主题自动选曲并下载
按主题关键词搜、评分排序、自动下载最佳匹配。无精确匹配时回退到首关键词广搜。
bgm-library pick "chill lofi study" --output ./audio/
bgm-library pick "energetic workout motivation" --output ./audio/
| Flag | Default | Description |
|---|
-o, --output <dir> | ./public | 输出目录 |
-l, --limit <n> | 5 | 候选评估条数 |
--force | off | 覆盖已存在文件 |
download <uploadId> — 按 ccMixter upload ID 下载
bgm-library download 70473 --output ./audio/
| Flag | Default | Description |
|---|
-o, --output <dir> | ./public | 输出目录 |
--force | off | 覆盖已存在文件 |
presets — 列出场景预设
bgm-library presets
| Preset | 场景 | Tags |
|---|
travel | 旅行 / Vlog | upbeat, travel, vlog, vacation, summer |
tech | 科技 / 产品 | corporate, technology, digital, modern |
lofi | 咖啡馆 / 学习 | lofi, chill, study, cafe, downtempo |
food | 美食 / 生活 | acoustic, cooking, lifestyle, warm, light |
workout | 运动 / 健身 | workout, gym, sport, energy, edm |
info <uploadId> — 查看曲目详情（协议 / BPM / 时长 / 文件）
bgm-library info 70473
Output
下载后落盘到 --output 目录：
*.mp3 — 音频文件（原文件名，非法字符替换为 _）music_manifest.json — 曲目元数据（供程序化读取）ATTRIBUTION.txt — TASL 格式自动署名（Title / Author / Source / License）
music_manifest.json 示例：
{
"tracks": [
{
"upload_id": 70473,
"title": "The Fade Out",
"artist": "coruscate",
"source_url": "https://ccmixter.org/files/Coruscate/70473",
"license_name": "Attribution (3.0)",
"license_url": "http://creativecommons.org/licenses/by/3.0/",
"file_name": "Coruscate_-_The_Fade_Out.mp3",
"bpm": 92,
"duration": "3:05",
"downloaded_at": "2026-08-15T12:00:00.000Z"
}
]
}
⚠️ 发布时必须附带署名
ATTRIBUTION.txt 是 CC 协议的法律要求。成片发布时把该文件内容写到视频描述 / 简介里，不得省略。
在 video-edit / video-producer 中使用
配乐环节拿到 --bgm 文件的来源之一（与 aigc-video-gen music 生成路线并列）：
bgm-library pick "科技产品展示 轻快" --output <project-dir>/audio/
video-edit audio-mix input.mp4 --bgm <project-dir>/audio/Coruscate_-_The_Fade_Out.mp3 --output out.mp4
选曲策略：
- ✅ 优先
bgm-library：免 key、免版税、自动署名、商用安全；适合绝大多数配乐场景
- ✅ 需要定制风格 / 无法在 ccMixter 找到匹配时：用
aigc-video-gen music（MiniMax 生成，需 MINIMAX_API_KEY）
- ❌ 不要放开
--no-commercial-only 下 NC/ND 协议曲目到商用成片
Pitfalls
pitfall: 403 Forbidden on download
- 症状：下载返回 403
- workaround：脚本已自动带 referer 头；仍 403 说明曲目已从 ccMixter 下架，换一首
pitfall: 搜索无结果
- 症状：
No tracks found matching your query
- workaround：ccMixter 曲库比 Pixabay 小，换更宽的关键词、减少标签、或用
--preset
pitfall: ccMixter SSL 证书链不全
- 症状：Node 报
unable to verify the first certificate
- workaround：脚本已对 ccMixter 域名放宽 TLS 校验（
rejectUnauthorized: false），无需手动处理；仅作用于该站点
pitfall: 依赖未装
- 症状：
Cannot find module 'commander' 等
- workaround：依赖由
apply-addons.sh 自动安装（skill 目录下 package.json）；手动补装可 cd <skill-dir> && npm install --omit=dev
