SuperAPI AI 工具集

spotify

通用与其它

查看项目

更新于 10-26 18:14

技能介绍

用途\n该技能面向 Spotify 内容的发现、搜索与管理,通过已安装的命令行工具 spotify-api 与 save-to-spotify 操作,覆盖个性化内容浏览、音乐与播客搜索、资料库和播放列表管理,以及节目与单集的删除。\n\n主要能力\n- 连接管理:spotify-api status 查看 OAuth 连接状态;authorize-url 获取连接地址;disconnect 断开连接。\n- 浏览与搜索:experience 按 ID 获取艺人/专辑/节目页面;next-page 跟进分页;search 支持 TRACKS、ALBUMS、ARTISTS、PLAYLISTS、EPISODES、PODCASTS 等类型,查找精确歌曲或专辑时应使用“<song or album> by <artist>”格式。\n- 资料库:library 可按 ALBUMS、ARTISTS、PLAYLISTS、EPISODES、PODCASTS、SHOWS、PODCASTS_AND_SHOWS 过滤(不支持 TRACKS);save 可保存曲目、专辑、艺人、节目、单集、播放列表。\n- 播放列表:create-collection 新建、add-to-collection 添加条目、update-collection 重命名。\n- 播放控制:play、pause、resume、skip、previous、seek、set-volume、transfer、now-playing、devices、get-queue、add-to-queue。\n- 可穿戴设备:wearable-play 解析曲目并输出 music_fulfillment 节点参数,用于眼镜冷启动播放。\n- Save to Spotify 管理:用 save-to-spotify --json shows 列出节目,查看节目与单集,按标题匹配后删除单集或整个节目。\n\n使用方式\n先从 PATH 直接调用已安装的 CLI。数据调用前先用 spotify-api status 确认连接;未连接时用 authorize-url 取得连接链接并以 Markdown 超链接形式呈现。删除 Save to Spotify 节目时,从 shows 清单开始,按标题匹配并在多个匹配时请用户澄清;删除单集用 episodes delete <episode-id> --show-id <show-id>,删除整个节目用 shows delete <show-id>,无需先逐集删除。返回 deleted 后可每 5–10 秒轮询相关清单,最长 60 秒,确认 ID 消失后再告知完成。\n\n适用场景\n适合在命令行或支持此类技能的助手环境中检索音乐与播客、整理资料库和歌单、控制播放设备,以及清理通过 Save to Spotify 创建的节目内容。\n\n限制\nplay 与 add-to-queue 需要活跃的 Spotify Connect 设备,建议先用 devices 并尽量指定 --target-device-id;set-volume 同样建议指定设备。home、recommendations、check-saved、remove、section-items、reorder-collection 因不支持或不可靠而未提供,不支持取消保存、删除播放列表、从播放列表移除或重排等清理操作。搜索不到精确曲目或专辑时,不得用翻唱、致敬、卡拉OK 或同名内容替代,应原样转述 catalog_fallback.message。CLI 删除仅移除 Spotify 上的副本,不影响本地音频或独立发布的 RSS 源。若 save-to-spotify 提示节目与单集管理不可用,应直接说明限制,不应让用户重连或重试。