Spotify听歌记录

技能简介

连接Spotify Web API，读取个人听歌历史、常听艺人和歌曲排行，并基于音乐口味生成推荐。

能做什么

• 查看最近播放记录
• 获取Top艺人/歌曲（近4周、6个月或全部时间）
• 生成个性化音乐推荐
• 执行任意Spotify API端点查询

使用说明

安装与配置（一次性）

1. 运行自动化配置脚本：
   bash skills/spotify-history/scripts/setup.sh
2. 或手动配置：在Spotify开发者后台创建应用，填写Redirect URI为http://127.0.0.1:8888/callback，保存Client ID和Secret
3. 存储凭证（二选一）：
   文件方式：credentials/spotify.json（权限600）
   环境变量：SPOTIFY_CLIENT_ID和SPOTIFY_CLIENT_SECRET
4. 完成授权：
   本地带浏览器：python3 scripts/spotify-auth.py
   无浏览器：python3 scripts/spotify-auth.py --headless

常用命令

• 最近播放：python3 scripts/spotify-api.py recent
• Top艺人：python3 scripts/spotify-api.py top-artists medium_term
• Top歌曲：python3 scripts/spotify-api.py top-tracks long_term
• 获取推荐：python3 scripts/spotify-api.py recommend

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管Client Secret，避免泄露
• Token文件默认存储于~/.config/spotify-clawd/，权限已设为0600
• Redirect URI限定本地回环地址，降低中间人攻击风险
• Token过期后自动刷新，若失败需重新执行授权流程

来源信息

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