bgm-librarylisted
Install: claude install-skill trku052-png/social-media-youtube-skills
# ccMixter 免版税背景音乐库
> **凭据**:无需 API key。ccMixter 是 Creative Commons 创建的社区 remix 站,全部音乐已带 CC 协议。
搜索、筛选并下载商用安全的免版税背景音乐,自动生成署名文件。供 `video-edit` / `video-producer` 的配乐环节使用,也可独立调用。
通过 PATH 调用 wrapper,无需拼接脚本路径:
```bash
bgm-library <command> [args]
```
## 协议过滤(默认开启)
只放行**商用安全**协议,任何含 NonCommercial (NC) 或 NoDerivs (ND) 的协议一律拦截:
- ✅ 允许:CC BY(署名)、CC BY-SA(署名-相同方式共享)
- ❌ 拦截:含 NC / ND 的任何协议
`--no-commercial-only` 可放开(不推荐,商用项目会侵权)。
---
## Commands
### `search [keywords...]` — 关键词 / 预设搜索
```bash
# 关键词搜
bgm-library search chill lofi --limit 5
# 要求同时包含所有标签
bgm-library search chill lofi --match all --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` |
| `--match <mode>` | `any` | 多词默认 OR;`all` 要求同时命中全部标签 |
使用曲库的英文标签;中文会原样参与查询,不会自动翻译或删除后变成无主题搜索。无结果时换英文标签或场景预设,不推定曲库没有相应风格。
### `pick <theme>` — 按标签下载候选曲
默认按任一标签检索,在返回的候选中按标签/标题命中数排序后下载一首;同分保留上游排序。无匹配时报错,不删除关键词另下无关曲目。它不分析音频,不保证旋律、高潮段或最终听感;下载后必须试听。
```bash
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` | 候选评估条数 |
|