核心用法
Spotify Claw 是一个面向 macOS 的 Spotify Premium 深度控制技能，通过本地 Python 脚本实现完整的音乐管理与发现功能。用户可通过自然语言指令（支持英语/俄语）控制播放、暂停、切歌、音量调节、随机播放等基础操作，同时支持高级功能如：
- 智能播放：按名称、URI 或播放列表 ID 播放，应用关闭时自动启动 Spotify 并等待就绪（最多 7.5 秒）
- 音乐品味分析：查看 4 周/6 个月/全部时间维度的热门曲目与艺人，生成完整流派分布百分比
- 发现新音乐：绕过 Spotify 被封锁的
recommendationsAPI，通过相关艺人图谱 + 热门曲目实现智能推荐 - 一键播放列表：单命令创建并填充播放列表，如"本月热门 20 首"
- 多语言触发器：支持 "включи"、"пауза"、"next"、"volume up" 等混合指令
显著优点
1. 完全本地化：无需外部 API 服务，仅依赖 Spotify Web API 与本地 spotipy 库
2. 绕过 API 限制：创新性地用"相关艺人 + 热门曲目"替代被封锁的推荐端点
3. 自动化体验：自动检测并启动 Spotify，无需用户手动干预
4. 深度分析能力：提供流派占比统计、艺人流行度分层（地下/独立/主流）、年度分布等数据洞察
5. 开发者友好：基于 Keychain 的安全凭证管理，OAuth 缓存机制
潜在缺点与局限性
- 平台限制：仅支持 macOS，且需 Spotify Premium 订阅
- 初始配置复杂：需注册 Spotify Developer 应用，手动配置 client_id/secret 到系统钥匙串
- 首次认证依赖浏览器：需完成一次 OAuth 授权流程
- 推荐算法局限：绕开官方推荐 API 后，发现机制依赖人工构建的"相关艺人"网络，精准度可能不及原生算法
- 部分端点仍不可用：
audio_features、related-artists等返回 403/404
适合人群
- 希望用语音/聊天界面控制 Spotify 的重度用户
- 音乐爱好者需要定期分析自己的收听习惯
- 喜欢手动策划播放列表而非依赖算法推荐的用户
- 愿意进行初期技术配置的 macOS 开发者/高级用户
常规风险
- 凭证安全：client_secret 存储于系统钥匙串虽较安全，但仍需防范钥匙串访问权限泄露
- API 速率限制：高频操作可能触发 Spotify Web API 限流
- OAuth 令牌过期：缓存机制失效时需重新授权
- 自动化误操作：语音指令识别错误可能导致非预期的播放行为
- 硬编码路径风险：脚本路径包含用户名（
/Users/mixx/...），多用户环境需调整