SuperAPI AI 工具集

ears

编程与开发

查看项目

更新于 10-15 22:11

技能介绍

用途:Ears 是 OpenClaw 的音乐工具集,通过多个 Python 脚本统一操作 Spotify、网易云音乐、YouTube Music、Apple Music 和 QQ 音乐,用于播放控制、曲库浏览、歌单管理与曲目下载。

主要能力:Spotify 支持查看当前播放、热门曲目/艺人、最近播放、歌单、收藏、关注、搜索、设备列表,以及播放/暂停/切歌、创建歌单、添加曲目和原始 API 调用。网易云支持短信或二维码登录、搜索、歌单、最近播放、喜欢、获取音频 URL、下载单曲或歌单,以及 macOS 桌面端播放控制。YouTube Music 支持 OAuth 或浏览器头登录、搜索、艺人/专辑、歌单、喜欢、历史、获取 URL、浏览器播放与下载。Apple Music 支持免登录搜索、播放、30 秒预览及 macOS Music.app 控制。QQ 音乐支持 Cookie 或二维码登录、搜索、歌单、获取 URL、浏览器播放与下载。

使用方式:各平台脚本位于 scripts/ 目录,如 python3 scripts/spotify.py auth、python3 scripts/netease.py login-qr、python3 scripts/ytmusic.py login、python3 scripts/applemusic.py search <query>、python3 scripts/qqmusic.py login。配置与令牌分别保存在 ~/.config 下对应目录。

适用场景:在 OpenClaw 对话中按用户请求查询或播放音乐、整理歌单、下载曲目。

限制:Spotify 播放需活跃设备;网易云播放控制仅限 macOS 且需安装 NeteaseMusic.app,无远程播放协议;YouTube Music 与 QQ 音乐无远程播放控制 API;Apple Music 个人曲库需 MusicKit($99/年);部分曲目可能为 VIP 或区域限制;下载依赖 pyncm、yt-dlp 等外部工具。