Spotify 收听历史与推荐
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-spotify-history。
技能介绍
想解决什么问题
用助手回答「最近在听什么」「最爱哪些艺人」时,如果没有接 Spotify 官方 API,只能猜或靠用户手动贴歌单。本技能把 OAuth 授权、令牌自动刷新 和一组 CLI 入口串起来,让 Agent 能读 user-read-recently-played、user-top-read 等 scope 下的真实数据,并在推荐时把 API 结果和自己的乐理/风格知识叠在一起。
怎么工作
一次性配置走向导或手动:在 developer.spotify.com 建 App,Redirect URI 固定为 http://127.0.0.1:8888/callback,把 Client ID/Secret 写入凭证文件或环境变量,再跑 spotify-auth.py(本地浏览器或 --headless 粘贴回调 URL)。令牌落在 ~/.config/spotify-clawd/token.json,过期会自动刷新。
日常使用主要靠脚本接口,时间窗口可选:short_term(约 4 周)、medium_term(默认,约 6 个月)、long_term(全部历史)。典型映射:
- 「最近在听什么」→
spotify-api.py recent - 「头牌艺人是谁」→
spotify-api.py top-artists - 「推点新歌」→
spotify-api.py recommend,并补充库外相似艺人
还能读当前播放状态(user-read-playback-state / user-read-currently-playing),方便对话里对齐「正在播哪首」。
边界与注意
这是 个人 Spotify 账号 集成,不是流媒体控制台也不是歌单批量运营工具。无浏览器环境要用 headless 授权;凭证或 Client Secret 配错会出现 400/401,需重跑 setup 或删 token 再授权。Client Secret 与 token 文件应仅本机可读(技能侧 token 为 0600)。
使用场景
- 每周复盘听歌习惯时,用 `medium_term` 拉 top artists 写进个人周报
- 对话里被问「最近常听谁」,Agent 调 `recent` 按真实播放记录回答
- 想扩容曲库时,在 `recommend` 基础上让助手补充库外风格相近艺人
- 远程无桌面的服务器上完成 headless 授权后查询当前正在播放的曲目
适合人员
- 在本机跑个人助手的工程师,希望音乐问答能读到自己 Spotify 账号数据
- 习惯用 CLI 做周报/日记、要把「最近在听」自动写进 Markdown 的用户
- 在无图形界面的 VPS 上部署 Agent、仍能完成 Spotify OAuth 的运维
- 做听歌品味分析时,需要 short/medium/long 多时间窗对比的乐迷