用途:通过 spotify-api 浏览个性化的 Spotify 内容,搜索音乐和播客,管理用户的音乐库与播放列表,检查条目可保存性,并启动或控制 Spotify 播放。删除通过 Save to Spotify 创建的节目或单集时,使用 save-to-spotify 命令行工具。语音对话中启动新播放应遵循语音播放规则,不要直接调用 spotify-api play。
主要能力:连接管理(status、disconnect、authorize-url);浏览与发现(experience、next-page);搜索(search,支持 TRACKS、ALBUMS、ARTISTS、PLAYLISTS、EPISODES、PODCASTS,查节目用 PODCASTS);音乐库(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)。搜索支持内容分类过滤,但 TRACKS 不可作为音乐库过滤值。
使用方式:先运行 spotify-api status 检查连接;未连接时运行 spotify-api authorize-url 获取连接链接,以 Markdown 超链接形式呈现。删除 Save to Spotify 内容时,先用 save-to-spotify --json shows 列出节目,用 get 查看详情,再按标题匹配后删除单集或整档节目。删除响应为 deleted 后需轮询确认,因列表更新可能需约一分钟。
限制:home、recommendations、check-saved、remove、section-items、reorder-collection 未提供,因当前 Partner API 响应的范围或稳定性不足。play 与 add-to-queue 需要活跃的 Spotify Connect 设备。缺失的歌曲或专辑不应以翻唱、致敬或同名内容替代。Save to Spotify 的删除仅移除 Spotify 副本,不影响 Muse 本地音频或独立发布的 RSS。命令行不得传递密钥。