核心功能概述
spotify-claw 是一款功能完备的 Spotify Premium 命令行控制工具，深度整合 Spotify Web API，提供从基础播放到高级音乐分析的完整工作流。
显著优势
| 维度 | 表现 |
|------|------|
| **播放控制** | 完整支持 play/pause/next/prev/volume/shuffle/queue，支持按名称搜索播放、URI 直链、歌单播放 |
| **智能启动** | 独有「自动启动」能力：Spotify 未运行时自动打开应用，等待初始化后继续执行播放指令 |
| **音乐分析** | 覆盖短/中/长期（4周/6月/全部）的 top tracks/artists 统计，完整 genre 画像，liked songs 检索与按艺人筛选 |
| **发现机制** | 绕过 Spotify 对新开发者账号封禁的 Recommendations API，采用 `related_artists` + `artist_top_tracks` 组合策略实现相似音乐发现 |
| **歌单工程** | 单命令创建并填充歌单（`make-playlist`），支持从艺人维度批量构建主题歌单 |
| **多语言支持** | 触发词覆盖英文与俄文 |
潜在局限与风险
1. 平台限制：仅支持 macOS（Keychain 凭据存储），Linux/Windows 用户需自行适配凭据方案
2. API 依赖：部分功能受 Spotify API 速率限制约束；新开发者账号无法使用 recommendations 和 audio_features API
3. Premium 门槛：播放控制功能需 Spotify Premium 订阅
4. 本地执行：需本地安装 Python3 + spotipy 库，首次配置涉及开发者账号注册与 OAuth 授权流程
适合人群
- 重度 Spotify 用户，追求键盘驱动的效率播放体验
- 音乐 curator，需要基于数据（top tracks、genre 分布）快速构建主题歌单
- macOS 自动化工作流用户，希望将音乐控制集成到 Alfred/Raycast 等启动器
常规风险提示
- OAuth 凭据存储于 macOS Keychain 属安全实践，但
CLIENT_ID/CLIENT_SECRET泄露仍可能导致账号级别的 API 滥用 - 自动启动 Spotify 应用涉及系统级应用调用，建议在可信环境使用
- 歌单批量操作（如
liked-all拉取全部喜欢歌曲）可能触发 API 速率限制