你的私人 Spotify 音乐档案分析师

通过 Spotify Web API 获取个人听歌历史、最爱艺人/曲目及智能推荐，需一次性 OAuth 授权，适合音乐品味分析与个性化发现。

基本信息

• 技能名称?Spotify History
• 中文名称?你的私人 Spotify 音乐档案分析师
• 作者?braydoncoyer
• 分类?专业技能
• 版本?1.1.0
• 标签?spotify, music, api, oauth, personalization, recommendations, listening-history, data-analysis

使用方法

使用说明
核心功能
Spotify History 是一款连接 Spotify Web API 的个人音乐数据工具，主要提供三类能力：

1. 历史回溯 ：获取最近播放记录（ recent ），支持查看约最近 50 首曲目
2. 品味分析 ：提取最爱艺人（ top-artists ）和曲目（ top-tracks ），支持三种时间维度——近 4 周（short_term）、近 6 个月（medium_term）、历史全部（long_term）
3. 智能推荐 ：基于用户 top artists 生成个性化新音乐推荐（ recommend ）
   显著优点
   官方 API 背书 ：直接调用 Spotify 官方 Web API，数据来源权威、实时性强
   灵活时间维度 ：三种时间范围可精准捕捉短期探索 vs 长期偏好
   双模式认证 ：支持浏览器自动跳转和纯命令行 headless 模式，服务器环境友好
   自动化 token 管理 ：OAuth token 自动刷新，无需重复授权
   权限最小化 ：仅申请必要 scope（recently-played、top-read、playback-state），不请求修改播放列表等敏感操作
   潜在局限
   仅限个人数据 ：无法获取好友或公共播放列表的聚合数据
   推荐质量依赖算法 ： recommend 端点返回结果由 Spotify 算法决定，可能出现重复或偏差
   需开发者账户 ：使用前必须注册 Spotify Developer App，对非技术用户门槛较高
   网络依赖 ：API 调用需稳定网络，且受 Spotify 服务可用性影响
   地域限制 ：部分曲目/艺人可能因版权区域不可用
   适合人群
   希望量化分析个人音乐品味的用户
   需要基于真实听歌数据做推荐的场景（如年度总结、DJ 策划）
   技术用户/开发者构建音乐相关的自动化工作流
   隐私敏感用户（数据本地存储，token 文件权限 0600）
   常规风险
   | 风险类型 | 说明 | |---------|------| | Token 泄露 | 若 ~/.config/spotify-clawd/token.json 被复制，攻击者可读取个人音乐数据，但无法操作账户（scope 只读） | | 凭证配置错误 | Client Secret 硬编码或误提交版本控制可能导致账户被滥用 | | 依赖失效 | Spotify 可能调整 API 端点或 rate limit，需关注官方变更 | | 本地端口冲突 | Redirect URI 使用 127.0.0.1:8888，若端口被占用需手动调整 |