Spotify History 是一个基于 Spotify Web API 开发的命令行工具，旨在帮助用户快速访问和管理自己在 Spotify 平台上的音乐收听数据。通过简单的脚本调用，用户可以直接获取最近播放的歌曲、热门艺术家以及个性化推荐内容，极大地方便了个人音乐品味分析或智能助手集成场景。该工具采用一次性 OAuth 授权机制，确保安全且持久的访问权限，无需重复登录。其设计注重轻量化与易用性，支持本地凭证存储和环境变量配置两种方式，满足不同开发者的使用习惯。无论是用于构建个人音乐仪表盘，还是作为 AI 助手的知识库扩展，Spotify History 都能提供稳定可靠的数据接口。整体架构简洁高效，适合技术背景有限的用户快速上手，同时满足高级用户对自动化流程的需求。
核心功能特点
- 获取用户最近播放的音乐历史记录
- 查询用户在短期、中期和长期内的热门艺术家与曲目
- 基于用户偏好生成个性化音乐推荐
- 支持命令行直接调用，便于集成到自动化脚本中
- 提供一键设置向导，简化 OAuth 授权流程
- 兼容本地凭证文件与环境变量两种认证方式
适用场景
Spotify History 特别适合那些希望将 Spotify 音乐数据融入日常数字生活的开发者与普通用户。例如，在构建个人音乐分析仪表盘时，可通过定期调用该工具获取收听趋势，可视化展示用户的音乐偏好变化。对于运行智能语音助手（如基于 Agent 框架的系统）的场景，当用户询问‘我最近听了什么’或‘推荐些类似风格的歌’，工具能实时返回准确数据，并结合外部音乐知识增强回答质量。此外，音乐爱好者也可利用此工具批量导出收听记录，用于制作年度回顾歌单或分享给朋友。由于其轻量级设计，它同样适用于服务器端无浏览器环境（headless）的自动化任务，比如定时抓取数据并触发通知。总之，任何需要从 Spotify 提取结构化音乐行为数据的场景，都可以借助 Spotify History 实现高效对接。