（11536期）Spotify History – 你的私人 Spotify 音乐档案分析师

你的私人 Spotify 音乐档案分析师 通过 Spotify Web API 获取个人听歌历史、最爱艺人/曲目及智能推荐，需一次性 OAuth 授权，适合音乐品味分析与个性化发现。 使用说明 核心功能 Spotify History 是一款连接 Spotify Web API 的个人音乐数据工具，主要提供三类能力： 历史回溯：获取最近播放记录（recent），支持查看约最近 50 首曲目 品味分析：提取最爱艺人（top-artists）和曲目（top-tracks），支持三种时间维度——近 4 周（shortterm）、近 6 个月（mediumterm）、历史全部（long_term） 智能推荐：基于用户 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，若端口被占用需手动调整 | 原始说明 Access Spotify listening history, top artists/tracks, and get personalized recommendations via the Spotify Web API. Use when fetching a user's recent plays, analyzing music taste, or generating recommendations. Requires one-time OAuth setup.