Spotify音乐控制

技能简介

通过Spotify Web API实现跨平台的音乐控制，支持播放、暂停、切歌、搜索、查看播放历史和热门曲目等功能。无需Mac系统，任何平台均可使用。

业务背景

为Windows、Linux等非Mac用户提供完整的Spotify控制能力，打破平台限制。通过Web API直接对接Spotify服务，支持查看个人听歌偏好和实时操控播放，满足跨设备办公场景下的音乐管理需求。

落地案例：一位产品经理使用Windows电脑办公，午休时想通过数据了解自己最近的听歌习惯。他运行脚本查看热门曲目排行，发现近期偏好后，直接搜索并播放特定歌曲放松心情，全程无需安装桌面客户端或依赖特定操作系统。

能做什么

• 查看当前播放歌曲和最近播放记录
• 获取个人热门曲目和艺人排行
• 控制播放：播放、暂停、下一首、上一首
• 按名称搜索歌曲并直接播放
• 列出可用的播放设备

使用说明

1. 创建Spotify应用：访问 Spotify开发者控制台，创建新应用，添加重定向URI为 http://localhost:8888/callback，复制Client ID和Client Secret。
2. 设置环境变量：

   export SPOTIFY_CLIENT_ID="your_client_id"
   export SPOTIFY_CLIENT_SECRET="your_client_secret"

3. 完成认证：运行 python3 {baseDir}/scripts/spotify.py auth，浏览器将打开OAuth授权页面，令牌自动缓存至 ~/.spotify_cache.json。
4. 执行命令：使用 python3 {baseDir}/scripts/spotify.py [命令] 格式调用各项功能。

输入与输出

见下方输入与输出表格。

风险提示

• 需要Spotify Premium订阅才能使用播放控制功能
• 免费账户仅支持查看历史和排行数据
• 需妥善保管Client ID和Client Secret，避免泄露
• OAuth令牌存储在本地文件，注意文件权限安全

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mvanhorn/spotify-web-api/SKILL.md
来源类型：GitHub仓库