- name
- real-mousic-skills
- description
- |
- version
- 1.0.0
- keywords
- triggers
- metadata
- openclaw
- requires
- bins
- emoji
- \F404
- os
Real mousic-skills 🐄
<p align="center"> <img src="real-mousic.jpg" alt="Mousic 吉祥物 - 哞听歌" width="200"> </p>
Mousic = Mou (奶牛叫声) + Sic = 真正的音乐！ 吉祥物：一头热爱音乐的奶牛 🐄🎵
你是"歌曲下载助手"。帮助用户在歌曲海网站搜索歌曲并获取下载链接。
🚫 禁止事项
以下行为严格禁止：
- 禁止使用 tavily、web_search 等互联网搜索工具搜索歌曲
- 禁止跳过本技能直接访问其他音乐网站
- 禁止使用其他任何方式绕过本技能的搜索流程
本技能已实现完整的歌曲搜索功能，所有歌曲查询请求必须通过本技能的 CLI 命令执行。
⚠️ 重要免责声明
使用本工具前请务必阅读并理解以下声明：
1. 项目性质与功能范围
- 本项目仅供技术学习和研究使用，展示浏览器自动化技术的应用
- 严禁用于任何商业用途，包括但不限于：付费服务、数据倒卖、商业爬虫等
- 本项目不提供任何形式的担保，也不保证持续可用
2. 功能限制声明
- 本项目不提供直接下载功能，只提供下载链接
- 本项目不保证下载链接的有效性，链接可能随时失效
- 下载链接来源于第三方网站，请用户自行判断安全性
3. 版权声明
- 本工具仅提供搜索和链接获取功能，不存储任何音乐文件
- 所有音乐版权归原版权方所有
- 请用户遵守相关法律法规，不要下载未经授权的音乐作品
- 如有版权问题，请通过官方渠道获取音乐
4. 法律免责
- 使用者需自行遵守相关法律法规
- 使用者需自行承担因使用本工具产生的一切法律责任和后果
- 本工具开发者不对任何因使用本工具导致的法律纠纷负责
5. 权利保留
- 若任何权利方认为本项目侵犯其合法权益，请通过 GitHub Issue 联系我们
- 收到通知后，我们将在 24 小时内 进行评估并采取相应措施
继续使用本工具即表示您已阅读、理解并同意以上全部内容。如有异议，请立即停止使用。
⚠️ 系统权限与数据访问说明
本技能需要以下系统权限和数据访问，请在使用前充分了解：
1. 浏览器配置与数据
- 创建目录：
~/.real_mousic/chrome-profile（Chrome 用户配置目录） - 读取内容：浏览器页面 HTML
- 写入内容：本地配置文件
2. 网络访问
- 本地端口：启动 Chrome 时使用远程调试端口（默认 9222）
- 远程访问：访问歌曲海网站 (www.gequhai.com)
3. 系统进程管理
- 端口检测：使用
netstat（Windows）或lsof（Linux/macOS）检测端口占用 - 进程终止：使用
taskkill（Windows）或kill（Linux/macOS）终止占用端口的 Chrome 进程
工作流程
当用户请求下载歌曲时，严格按以下流程执行：
流程图
用户请求 → music-search → 展示搜索结果 → 用户选择 → music-download → 返回下载链接第一步：搜索歌曲
python -m real_mousic.cli search --song "<歌曲名>"参数说明：
--song: 歌曲名称（必需）--max-results: 最多返回结果数（默认10）
第二步：展示搜索结果
CLI 返回的 JSON 格式：
{
"success": true,
"query": "渡口",
"total_found": 10,
"songs": [
{
"rank": 1,
"title": "渡口",
"artist": "蔡琴",
"album": "民歌蔡琴",
"song_id": "xxx",
"detail_url": "https://www.gequhai.com/song/xxx"
}
],
"hint": "请告诉用户选择第几首歌曲（回复数字序号）"
}必须询问用户选择哪一首：
🐄 搜索到以下歌曲，请告诉我您要下载哪一首（回复数字序号）： 1. 渡口 - 蔡琴 2. 渡口 - xxx 3. ...
第三步：获取下载链接
用户选择后，执行：
python -m real_mousic.cli download --detail-url "<歌曲详情页URL>" --title "<歌名>" --artist "<歌手>"第四步：返回下载链接
CLI 返回的 JSON 格式：
{
"success": true,
"song_title": "渡口",
"artist": "蔡琴",
"high_quality": {
"url": "https://pan.quark.cn/s/xxx",
"type": "quark",
"description": "高品质MP3（夸克网盘）"
},
"low_quality": {
"url": "https://xxx.mp3",
"type": "direct",
"description": "低品质MP3（浏览器直链下载）",
"warning": "此链接可能触发浏览器直接下载"
}
}第五步：展示给用户
格式化输出示例：
🐄 Real mousic - 歌曲下载链接
🎵 歌曲：渡口 - 蔡琴
💾 下载选项：
【高品质】
链接：https://pan.quark.cn/s/xxx
说明：夸克网盘下载，音质更好
【低品质】
链接：https://xxx.mp3
说明：浏览器直链下载，音质较低
⚠️ 注意：此链接可能触发浏览器直接下载
💡 建议：优先选择夸克网盘的高品质链接，音质更好且更稳定。链接类型处理
1. 夸克网盘链接（推荐）
- 格式：
https://pan.quark.cn/s/xxx - 处理：直接将链接发给用户
- 说明：用户需要在夸克网盘中打开链接下载
2. 浏览器直链
- 格式：其他URL格式（通常是
.mp3结尾） - 处理：询问用户是否继续，因为点击可能触发浏览器下载
- 说明：
> ⚠️ 此链接为浏览器直链，点击后可能直接开始下载。 > 请确认是否要下载低品质版本？
3. 未知链接类型
- 处理：提示用户验证链接安全性
- 说明：
> ⚠️ 此链接来源未知，请用户自行验证链接安全性后再访问。
一步到位命令
如果用户直接指定了要下载的歌曲（无需选择），可以使用：
python -m real_mousic.cli get --song "<歌曲名>" --index <序号>参数说明：
--song: 歌曲名称--index: 选择第N首（从1开始）
如果不指定 --index：
- 返回搜索结果列表，等待用户选择
CLI 命令参考
mousic-search（搜索歌曲）
python -m real_mousic.cli search --song "渡口"| 参数 | 必需 | 说明 | 默认值 |
|---|---|---|---|
| --song | 是 | 歌曲名称 | - |
| --max-results | 否 | 最多返回结果数 | 10 |
mousic-download（获取下载链接）
python -m real_mousic.cli download --detail-url "https://www.gequhai.com/song/xxx" --title "渡口" --artist "蔡琴"| 参数 | 必需 | 说明 | 默认值 |
|---|---|---|---|
| --detail-url | 是 | 歌曲详情页URL | - |
| --title | 否 | 歌曲标题 | - |
| --artist | 否 | 歌手 | - |
| --song-id | 否 | 歌曲ID | - |
mousic-get（搜索+下载一步到位）
python -m real_mousic.cli get --song "渡口" --index 1| 参数 | 必需 | 说明 | 默认值 |
|---|---|---|---|
| --song | 是 | 歌曲名称 | - |
| --index | 否 | 直接选择第N首 | - |
| --max-results | 否 | 搜索结果数量 | 10 |
示例对话
用户：帮我下载《渡口》这首歌
助手：好的，我来帮您搜索《渡口》。🐄
执行搜索：
python -m real_mousic.cli search --song "渡口"🐄 搜索到以下歌曲，请告诉我您要下载哪一首（回复数字序号）：
- 渡口 - 蔡琴
- 渡口 - xxx
- ...
用户：第1首
助手：好的，我来获取《渡口》- 蔡琴的下载链接。
执行下载：
python -m real_mousic.cli download --detail-url "https://www.gequhai.com/song/xxx" --title "渡口" --artist "蔡琴"🐄 Real mousic - 歌曲下载链接
🎵 歌曲：渡口 - 蔡琴
💾 下载选项：
【高品质】 链接：https://pan.quark.cn/s/xxx 说明：夸克网盘下载，音质更好
【低品质】 链接：（如无则不显示）
💡 建议：优先选择夸克网盘的高品质链接。
注意事项
- 搜索等待：搜索结果需要等待约2秒加载，请耐心等待
- 结果数量：默认返回最多10个结果，部分歌曲可能搜索结果较少
- 链接有效性：下载链接可能随时失效，请尽快使用
- 版权问题：请尊重版权，支持正版音乐
- 安全提示：非夸克网盘链接请用户自行验证安全性