核心功能
spotify-claw 是一个面向 Spotify Premium 用户的命令行控制中枢，将完整的音乐流媒体操控能力整合到终端环境。功能覆盖三大维度：
播放控制：支持播放/暂停/切歌、音量调节（含步进）、随机模式开关、队列管理，并具备智能自动启动能力——当 Spotify 未运行时自动唤起应用并等待初始化完成。
数据分析：深度读取用户的收听数据，包括不同时段（4周/6个月/全部时间）的热门曲目与艺术家、最近播放、收藏歌曲、风格画像统计，以及完整的播放列表枚举。数据来源为 Spotify 官方 Web API，具有平台原生可靠性。
发现与创作：绕过被限制的新版 Recommendations API，采用 related_artists + artist_top_tracks 组合策略实现音乐发现。支持基于风格画像的智能推荐、指定艺术家的关联挖掘、一键生成个性化歌单并自动填充内容。
显著优点
- 零界面依赖：全程终端操作，适合自动化脚本与效率工作流
- macOS 原生安全：凭证存储于系统 Keychain，避免明文配置文件泄露风险
- 智能容错：自动检测应用状态并处理启动流程，减少人工干预
- API 降级兼容：针对 Spotify 对新开发者账号限制 Recommendations API 的现状，提供替代方案保持功能可用
局限与风险
平台绑定：仅支持 macOS（Keychain 依赖），Linux/Windows 用户需修改凭证存储逻辑。
账号门槛：需要 Spotify Premium 订阅及开发者账号配置，初始化流程涉及 OAuth 授权，对非技术用户存在门槛。
API 限制：部分功能（如音频特征分析）因平台政策受限不可用；频繁调用可能触发速率限制。
权限范围：需要 user-read-private、playlist-modify-private 等较广泛权限，用户需评估数据访问范围。
适用人群
- Spotify Premium 重度用户，偏好键盘驱动工作流
- 需要批量管理歌单、生成听歌报告的音乐爱好者
- macOS 环境下追求自动化音乐控制的开发者
安全建议
建议定期审查 Spotify 账号的第三方应用授权，避免在共享设备上存储 Keychain 凭证。脚本执行时注意验证来源，防止注入恶意曲目 URI。