Spotify 历史记录与推荐

访问 Spotify 收听历史记录并获取个性化推荐。

设置（一次性）

快速设置（推荐）

运行设置向导：

bash skills/spotify-history/scripts/setup.sh

该向导将引导您完成：

1. 创建 Spotify 开发者应用
2. 安全保存凭证
3. 授权访问

手动设置

1. 创建 Spotify 开发者应用

   • 前往developer.spotify.com/dashboard
   • 点击创建应用
   • 填写：
     • 应用名称： Clawd（或任意名称）
     • 应用描述： 个人助手集成
     • 重定向 URI： http://127.0.0.1:8888/callback⚠️ 请使用确切的URL！
   • 保存并复制客户端ID和客户端密钥

2. 存储凭据

   选项A：凭据文件（推荐）

   mkdir -p credentials
   cat > credentials/spotify.json <<EOF
   {
     "client_id": "your_client_id",
     "client_secret": "your_client_secret"
   }
   EOF
   chmod 600 credentials/spotify.json
   

   选项B：环境变量

   # Add to ~/.zshrc or ~/.bashrc
   export SPOTIFY_CLIENT_ID="your_client_id"
   export SPOTIFY_CLIENT_SECRET="your_client_secret"
   

3. 身份验证

   使用浏览器（本地机器）：

   python3 scripts/spotify-auth.py
   

   无头模式（无浏览器）：

   python3 scripts/spotify-auth.py --headless
   

   按照提示通过URL授权并粘贴回调信息。

令牌将保存至~/.config/spotify-clawd/token.json并在过期时自动刷新。

使用

命令行

# Recent listening history
python3 scripts/spotify-api.py recent

# Top artists (time_range: short_term, medium_term, long_term)
python3 scripts/spotify-api.py top-artists medium_term

# Top tracks
python3 scripts/spotify-api.py top-tracks medium_term

# Get recommendations based on your top artists
python3 scripts/spotify-api.py recommend

# Raw API call (any endpoint)
python3 scripts/spotify-api.py json /me
python3 scripts/spotify-api.py json /me/player/recently-played

时间范围

• 短期— 大约最近4周
• 中期— 大约最近6个月（默认）
• 长期— 所有时间

示例输出

Top Artists (medium_term):
  1. Hans Zimmer [soundtrack, score]
  2. John Williams [soundtrack, score]
  3. Michael Giacchino [soundtrack, score]
  4. Max Richter [ambient, modern classical]
  5. Ludovico Einaudi [italian contemporary classical]

代理使用

当用户询问音乐相关问题时：

• "我最近在听什么？" →spotify-api.py recent
• "我最常听的艺术家是谁？" →spotify-api.py top-artists
• "推荐新音乐" →spotify-api.py recommend+ 添加你自己的知识

对于推荐，结合API数据与音乐知识，建议其曲库中没有的相似艺术家。

故障排除

"未找到Spotify凭据！"

• 请确保credentials/spotify.json文件存在或已设置环境变量
• 优先检查凭据文件，然后是环境变量
• 运行bash skills/spotify-history/scripts/setup.sh创建凭据

"未通过身份验证。请先运行 spotify-auth.py。"

• 令牌不存在或无效
• 运行：python3 scripts/spotify-auth.py（或使用--headless如果没有浏览器）

令牌刷新时出现"HTTP 错误 400：错误请求"

• 凭据已更改或无效
• 重新运行设置：bash skills/spotify-history/scripts/setup.sh
• 或更新credentials/spotify.json使用正确的客户端 ID/密钥

"HTTP 错误 401：未授权"

• 令牌已过期且自动刷新失败
• 删除令牌并重新进行身份验证：

  rm ~/.config/spotify-clawd/token.json
  python3 scripts/spotify-auth.py
  

无头模式 / 无浏览器

• 使用--headless标志：python3 scripts/spotify-auth.py --headless
• 在任何设备上手动打开授权URL
• 复制回调URL（以http://127.0.0.1:8888/callback?code=...开头）
• 在提示时将其粘贴回来

安全注意事项

• 令牌以0600权限存储（仅用户可读写）
• 客户端密钥应保持私密
• 重定向URI使用127.0.0.1（仅限本地）以确保安全

所需权限范围

• user-read-recently-played— 最近收听历史
• user-top-read— 热门艺术家和曲目
• user-read-playback-state— 当前播放状态
• user-read-currently-playing— 当前播放曲目