← 返回 Skills 市场
音乐下载工具
作者
ziyang9317
· GitHub ↗
· v1.0.0
· MIT-0
130
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install music-download
功能描述
支持从网易云音乐等平台下载高清MP3歌曲,提供单曲、歌单、搜索及批量下载功能,音质最高320kbps。
使用说明 (SKILL.md)
音乐下载技能
功能说明
从网易云音乐等平台下载 MP3 歌曲文件,支持高清音质。
使用工具
- yt-dlp(首选):支持高清音质下载,平台更多
- you-get(备用):传统下载工具
安装方法
pip install --break-system-packages yt-dlp
使用方法
方式一:直接下载(推荐)
# 输入:歌曲页面URL
yt-dlp -x --audio-format mp3 -o /保存路径 "%(title)s.%(ext)s" "URL"
示例:
# 下载网易云音乐《平凡世界的不凡》
yt-dlp -x --audio-format mp3 -o "/home/liangbing/Music/%(title)s.%(ext)s" "https://music.163.com/song?id=2047069187"
方式二:下载最高音质(不转换格式)
yt-dlp -o "/保存路径/%(title)s.%(ext)s" "https://music.163.com/song?id=歌曲ID"
方式三:搜索并下载
# 搜索歌曲
yt-dlp --match-title "歌手名 歌名" --max-downloads 1 "https://music.163.com/search/m/?s=关键词&type=1"
方式四:批量下载歌单
yt-dlp -x --audio-format mp3 -o "/保存路径/%(title)s.%(ext)s" "https://music.163.com/playlist?id=歌单ID"
音质对比
| 工具 | 音质 | 文件大小(约4分钟歌曲) |
|---|---|---|
| you-get | 128 kbps | ~4-5 MB |
| yt-dlp ✅ | 320 kbps | ~10-12 MB |
支持平台
- ✅ 网易云音乐(高清音质)
- ✅ SoundCloud
- ✅ Bandcamp
- ✅ QQ音乐
- ✅ Mixcloud
- ✅ Yandex Music
- ✅ Musicdex
网易云音乐 URL 格式
- 歌曲页:
https://music.163.com/song?id=歌曲ID - 专辑页:
https://music.163.com/album?id=专辑ID - 歌单页:
https://music.163.com/playlist?id=歌单ID - 歌手页:
https://music.163.com/artist?id=歌手ID
获取歌曲 ID
- 在网易云音乐网页版打开歌曲页面
- 浏览器地址栏 URL 中
id=后面的数字即为歌曲 ID - 例如:
https://music.163.com/song?id=2047069187→ 歌曲 ID 是2047069187
常用命令速查
# 下载高清MP3(推荐)
yt-dlp -x --audio-format mp3 -o "/保存路径/%(title)s.%(ext)s" "URL"
# 只下载不转换格式
yt-dlp -o "/保存路径/%(title)s.%(ext)s" "URL"
# 查看可用格式
yt-dlp --list-formats "URL"
# 下载指定音质
yt-dlp -f "bestaudio[ext=m4a]" -x --audio-format mp3 "URL"
注意事项
- 仅用于下载允许下载的歌曲
- 遵守版权法规
- 部分付费歌曲可能无法下载
- 下载的文件会自动按歌曲标题命名
安全使用建议
该技能本质上是一本如何使用 yt-dlp/you-get 的操作说明,内部一致且没有请求敏感凭据,但在安装和使用前请注意:
- 法律与版权:仅用于下载被允许的内容,避免侵犯版权。技能的“仅用于允许下载的歌曲”声明并不能替代合法性判断。
- 安装隔离:SKILL.md 建议使用 pip install,并带有 --break-system-packages 标志,这可能影响系统包管理,建议在虚拟环境(python venv)或容器中安装并避免直接修改系统包。确认要从官方 PyPI 或 yt-dlp 官方发布渠道安装。
- 依赖工具:yt-dlp 有时需要 ffmpeg 用于音频转换(未在说明中明示),你可能需要手动安装额外二进制。元数据未声明必需二进制,安装前请准备好 yt-dlp/you-get/ffmpeg 等依赖。
- 供应链风险:任何通过 pip 安装的第三方包都带有供应链风险——如有顾虑,请自行验证包版本、来源或使用操作系统包管理器/已知的发行版二进制。
- 自动执行:技能允许模型调用(平台默认),如果你不希望代理在无人监督时自动执行下载命令,应控制技能的调用权限或仅在人工触发时使用。
如果你希望更高的安全保证,请要求技能作者在元数据中声明必需二进制,并提供官方源(例如 GitHub releases / PyPI 包名)与安装/验证指南,或在受控环境中手动运行示例命令以验证行为。
能力评估
Purpose & Capability
技能名、描述与 SKILL.md 中的使用说明一致:都在说明如何用 yt-dlp/you-get 下载高清 MP3。唯一小差异是元数据没有声明必需的二进制(yt-dlp/you-get),但说明里明确要求并提供了安装命令。
Instruction Scope
运行指令局限于使用 yt-dlp/you-get 下载、列出格式和指定输出路径;没有指示读取系统文件、环境变量或将数据传送到未预期的外部端点。说明中也包含合理的使用注意事项(版权限制)。
Install Mechanism
技能无 install spec(instruction-only),但 SKILL.md 建议用 pip 安装 yt-dlp(命令含 --break-system-packages)。通过 pip 安装来自 PyPI 是常见做法,但使用 --break-system-packages 可能影响系统包管理器;这有供应链/系统影响风险,建议在虚拟环境或受控环境中安装,并确认包来源(PyPI 发布页/签名)。
Credentials
技能不请求任何环境变量、凭据或配置路径,所需权限与其目的相称(下载公开可访问的媒体)。
Persistence & Privilege
不要求始终加载(always:false),也无安装脚本或修改其它技能/系统全局配置的指令。自动调用能力为平台默认,并未在此技能中放大风险。
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install music-download - 安装完成后,直接呼叫该 Skill 的名称或使用
/music-download触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release with the following features:
- Download MP3 songs with high audio quality from platforms like NetEase Cloud Music.
- Primary tool: yt-dlp (supports more platforms and higher bitrates); fallback: you-get.
- Detailed guides for single/song/playlist downloads, as well as search and batch download.
- Audio quality comparison table (yt-dlp up to 320 kbps, you-get up to 128 kbps).
- Platform support includes NetEase Cloud Music, SoundCloud, Bandcamp, QQ Music, Mixcloud, Yandex Music, Musicdex.
- Instructions for obtaining song IDs and command quick-reference included.
元数据
常见问题
音乐下载工具 是什么?
支持从网易云音乐等平台下载高清MP3歌曲,提供单曲、歌单、搜索及批量下载功能,音质最高320kbps。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 130 次。
如何安装 音乐下载工具?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install music-download」即可一键安装,无需额外配置。
音乐下载工具 是免费的吗?
是的,音乐下载工具 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
音乐下载工具 支持哪些平台?
音乐下载工具 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 音乐下载工具?
由 ziyang9317(@ziyang9317)开发并维护,当前版本 v1.0.0。
推荐 Skills