用途:使用 spotify-api 浏览个性化 Spotify 内容、搜索音乐与播客、管理用户音乐库和播放列表、检查项目可保存性,并启动或控制 Spotify 播放。语音对话中启动新播放需走 Voice playback 流程,而非直接调用 spotify-api play。通过 Save to Spotify 创建的节目和单集,用 save-to-spotify 管理。
主要能力:连接方面有 status、disconnect、authorize-url;浏览发现用 experience 与 next-page;搜索用 search,支持 TRACKS、ALBUMS、ARTISTS、PLAYLISTS、EPISODES、PODCASTS 类型,精确查找歌曲或专辑应写成“<歌曲或专辑> by <艺人>”;音乐库用 library 与 save;播放列表用 create-collection、add-to-collection、update-collection;播放控制用 play、pause、resume、skip、previous、seek、set-volume、transfer、now-playing、devices、get-queue、add-to-queue。
使用方式:先运行 spotify-api status 确认连接,未连接则用 authorize-url 获取连接链接。播放与加入队列需要活跃的 Spotify Connect 设备,建议先 devices 并尽量指定 --target-device-id。删除 Save to Spotify 内容时用 JSON 模式,先 save-to-spotify --json shows 列出节目,再按标题匹配,删除单集用 episodes delete <episode-id> --show-id <show-id>,删除整个节目用 shows delete <show-id>。
限制:home、recommendations、check-saved、remove、section-items、reorder-collection 未提供,因当前 Partner API 响应或权限不支持或不可靠。TRACKS 不能作为音乐库过滤值。删除响应为 deleted 后列表可能约一分钟才更新,可每 5–10 秒轮询,最多 60 秒,超时不要重复发送删除。CLI 删除只移除 Spotify 副本,不影响本地音频或独立发布的 RSS。不要在命令行传递密钥。