SuperAPI AI 工具集

spotify

通用与其它

查看项目

更新于 10-16 09:46

技能介绍

用途:通过 Hermes 提供的 Spotify 工具集(共 7 个工具)操作用户的 Spotify 账号,覆盖播放控制、搜索、队列、播放列表、专辑、设备与音乐库管理等常见操作。安装与授权说明见 https://hermes-agent.nousresearch.com/docs/user-guide/features/spotify。

七类工具能力:spotify_playback 支持播放、暂停、上一首/下一首、跳转、循环、随机、音量、获取状态与当前播放及最近播放;spotify_devices 列出与转移设备;spotify_queue 查看与添加队列;spotify_search 搜索目录;spotify_playlists 列出、获取、创建、增删条目与更新信息;spotify_albums 获取专辑与曲目;spotify_library 以 tracks 或 albums 为单位列出、保存、移除。

使用方式:命令类请求可直接执行,不必每次先查状态;播放指定内容时先搜索取 URI 再播放,例如先 spotify_search 取到 spotify:album:...,再 spotify_playback 以 context_uri 播放;查询当前播放用单个 get_currently_playing 调用即可。ID 可使用 URI、URL 或裸 ID,建议用完整 URI。

限制:修改播放状态的操作需要 Spotify Premium,搜索、音乐库与播放列表等读取操作在免费版可用。常见错误:403 无活动设备需先在任意客户端打开播放;403 需 Premium;204 表示当前无播放内容而非报错;429 为限流应稍后重试;401 需重新执行 hermes auth spotify 授权。工具集具体安装命令与鉴权细节暂未提供完整内容,请以官方文档为准。