Agent Skills
返回列表
🏠

Spotify 收听历史与推荐

生活服务 更新于 2026.08.30

将以下提示词粘贴到你的 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 多时间窗对比的乐迷