Spotify
搜索音乐、管理播放列表、控制播放，并访问你的音乐库
配置
搜索
操作
搜索
Spotify 账户*
Connect spotify...
搜索查询*
例如：“Bohemian Rhapsody”、“artist:Queen”
搜索类型
曲目
限制
结果数量（1-50，默认：20）
搜索（
spotify_search）在 Spotify 上搜索曲目、专辑、艺人或播放列表。根据查询返回匹配的结果。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query | string | 是 | 搜索查询 (例如 "Bohemian Rhapsody"、"artist:Queen"、"genre:rock") |
type | string | 否 | 结果类型：track、album、artist、playlist，或使用逗号分隔 (例如 "track,artist") |
limit | number | 否 | 返回结果的最大数量 (1-50) |
offset | number | 否 | 分页时返回的第一个结果索引 |
market | string | 否 | 用于筛选结果的 ISO 3166-1 alpha-2 国家/地区代码 (例如 "US"、"GB") |
输出
| Parameter | Type | Description |
|---|---|---|
tracks | array | 匹配的曲目列表 |
artists | array | 匹配的艺人列表 |
albums | array | 匹配的专辑列表 |
playlists | array | 匹配的歌单列表 |
获取曲目
操作
获取曲目
Spotify 账户*
Connect spotify...
曲目 ID*
Spotify 曲目 ID
获取曲目 (
spotify_get_track)通过 ID 获取 Spotify 上特定曲目的详细信息。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
trackId | string | 是 | 曲目的 Spotify ID |
market | string | 否 | 用于曲目可用性的 ISO 3166-1 alpha-2 国家/地区代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
id | string | Spotify 曲目 ID |
name | string | 曲目名称 |
artists | array | 艺术家列表 |
album | object | 专辑信息 |
duration_ms | number | 曲目时长（毫秒） |
explicit | boolean | 曲目是否包含露骨内容 |
popularity | number | 热度评分 (0-100) |
preview_url | string | 30 秒试听 URL |
external_url | string | Spotify URL |
uri | string | 曲目的 Spotify URI |
获取多个曲目
操作
获取多个曲目
Spotify 账户*
Connect spotify...
曲目 ID*
逗号分隔的曲目 ID
获取多个曲目（
spotify_get_tracks）通过 ID 获取 Spotify 上多个曲目的详细信息（最多 50 个）。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
trackIds | string | 是 | 以逗号分隔的 Spotify 曲目 ID 列表(最多 50 个) |
market | string | 否 | 用于曲目可用性的 ISO 3166-1 alpha-2 国家/地区代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
tracks | 数组 | 曲目列表 |
获取专辑
操作
获取专辑
Spotify 账户*
Connect spotify...
专辑 ID*
Spotify 专辑 ID
获取专辑 (
spotify_get_album)通过 ID 获取 Spotify 专辑的详细信息，包括曲目列表。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
albumId | string | 是 | 专辑的 Spotify ID |
market | string | 否 | 用于曲目可用性的 ISO 3166-1 alpha-2 国家/地区代码 |
输出
| Parameter | Type | Description |
|---|---|---|
id | string | Spotify 专辑 ID |
name | string | 专辑名称 |
artists | array | 艺术家列表 |
album_type | string | 专辑类型 (album、single、compilation) |
total_tracks | number | 曲目总数 |
release_date | string | 发行日期 |
label | string | 唱片公司 |
popularity | number | 热度评分 (0-100) |
genres | array | 流派列表 |
image_url | string | 专辑封面图片 URL |
tracks | array | 专辑中的曲目列表 |
external_url | string | Spotify URL |
获取多张专辑
操作
获取多个专辑
Spotify 账户*
Connect spotify...
专辑 ID*
以逗号分隔的专辑 ID
获取多个专辑（
spotify_get_albums）通过专辑 ID 获取多个专辑的详细信息。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
albumIds | string | 是 | 逗号分隔的专辑 ID (最多 20 个) |
market | string | 否 | 市场对应的 ISO 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
albums | json | 专辑列表 |
获取专辑曲目
操作
获取专辑单曲
Spotify 账户*
Connect spotify...
专辑 ID*
Spotify 专辑 ID
限制
结果数量（1-50，默认：20）
获取专辑曲目（
spotify_get_album_tracks）获取专辑中的曲目。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
albumId | string | 是 | Spotify 专辑 ID |
limit | number | 否 | 要返回的曲目数量 (1-50) |
offset | number | 否 | 要返回的第一首曲目的索引 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
tracks | json | 曲目列表 |
total | number | 曲目总数 |
next | string | 下一页的 URL |
获取已保存的专辑
操作
获取已保存专辑
Spotify 账户*
Connect spotify...
数量上限
结果数量（1-50，默认：20）
获取已保存的专辑（
spotify_get_saved_albums）获取用户已保存的专辑。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 返回的专辑数量 (1-50) |
offset | number | 否 | 首个返回专辑的索引 |
market | string | 否 | 市场的 ISO 国家/地区代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
albums | json | 已保存专辑列表 |
total | number | 已保存专辑总数 |
next | string | 下一页 URL |
保存专辑
操作
保存专辑
Spotify 账户*
Connect spotify...
专辑 ID*
以逗号分隔的专辑 ID
保存专辑 (
spotify_save_albums)将专辑保存到用户音乐库。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
albumIds | string | 是 | 逗号分隔的专辑 ID (最多 20 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 专辑是否已保存 |
移除已保存的专辑
操作
移除已保存专辑
Spotify 账户*
Connect spotify...
专辑 ID*
逗号分隔的专辑 ID
移除已保存的专辑 (
spotify_remove_saved_albums)从用户的音乐库中移除专辑。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
albumIds | string | 是 | 以逗号分隔的专辑 ID (最多 20 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 专辑是否已移除 |
检查已保存的专辑
操作
检查已保存专辑
Spotify 账户*
Connect spotify...
专辑 ID*
以逗号分隔的专辑 ID
检查已保存的专辑 (
spotify_check_saved_albums)检查专辑是否已保存到音乐库。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
albumIds | string | 是 | 以逗号分隔的专辑 ID (最多 20 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
results | json | 每个专辑的布尔值数组 |
获取艺术家
操作
获取艺术家
Spotify 账户*
Connect spotify...
艺术家 ID*
Spotify 艺术家 ID
获取艺人 (
spotify_get_artist)通过 ID 获取 Spotify 上某位艺人的详细信息。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
artistId | string | 是 | 艺人的 Spotify ID |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
id | string | Spotify 艺人 ID |
name | string | 艺人名称 |
genres | array | 与该艺人相关的流派列表 |
popularity | number | 热度评分 (0-100) |
followers | number | 关注者数量 |
image_url | string | 艺人图片 URL |
external_url | string | Spotify URL |
批量获取艺人
操作
获取多个艺人
Spotify 账户*
Connect spotify...
艺人 ID*
以逗号分隔的艺人 ID
获取多个艺术家 (
spotify_get_artists)通过 ID 获取多个艺术家的详细信息。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
artistIds | string | 是 | 逗号分隔的艺术家 ID (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
artists | json | 艺术家列表 |
获取艺术家专辑
操作
获取艺术家专辑
Spotify 账户*
Connect spotify...
艺术家 ID*
Spotify 艺术家 ID
数量
结果数量（1-50，默认：20）
获取艺术家专辑（
spotify_get_artist_albums）获取 Spotify 上某位艺术家的专辑。可按专辑类型筛选。
输入
| Parameter | Type | Required | Description |
|---|---|---|---|
artistId | string | Yes | 艺术家的 Spotify ID |
include_groups | string | No | 按专辑类型筛选：album、single、appears_on、compilation (逗号分隔) |
limit | number | No | 返回的专辑数量上限 (1-50) |
offset | number | No | 返回的第一张专辑的索引 |
market | string | No | ISO 3166-1 alpha-2 国家/地区代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
albums | 数组 | 艺人的专辑 |
total | 数字 | 可用专辑总数 |
next | 字符串 | 下一页结果的 URL |
获取艺术家热门曲目
操作
获取艺人热门曲目
Spotify 账户*
Connect spotify...
艺人 ID*
Spotify 艺人 ID
获取艺术家热门曲目 (
spotify_get_artist_top_tracks)获取 Spotify 上某位艺术家的前 10 首最热门曲目。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
artistId | string | 是 | 艺术家的 Spotify ID |
market | string | 否 | ISO 3166-1 alpha-2 国家/地区代码 (此端点必填) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
tracks | array | 艺人的热门曲目 |
关注艺术家
操作
关注艺人
Spotify 账户*
Connect spotify...
艺人 ID*
以逗号分隔的艺人 ID
关注艺术家（
spotify_follow_artists）关注一个或多个艺术家。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
artistIds | string | 是 | 要关注的艺术家 ID，以逗号分隔 (最多 50 个) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否已成功关注艺人 |
取消关注艺术家
操作
取消关注艺人
Spotify 账号*
Connect spotify...
艺人 ID*
以逗号分隔的艺人 ID
取消关注艺术家 (
spotify_unfollow_artists)取消关注一个或多个艺术家。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
artistIds | string | Yes | 以逗号分隔的艺术家 ID，用于取消关注 (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | 布尔值 | 是否成功取消关注艺术家 |
获取关注的艺术家
操作
获取已关注的艺术家
Spotify 账户*
Connect spotify...
限制
结果数量（1-50，默认：20）
获取已关注艺人 (
spotify_get_followed_artists)获取用户关注的艺人。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 返回的艺人数量 (1-50) |
after | string | 否 | 分页游标（上一次请求的最后一个艺人 ID） |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
artists | json | 关注的艺人列表 |
total | number | 关注的艺人总数 |
next | string | 下一页游标 |
检查关注状态
操作
检查关注状态
Spotify 账户*
Connect spotify...
类型
艺人
要检查的 ID*
以逗号分隔的艺人或用户 ID
检查关注 (
spotify_check_following)检查用户是否关注艺术家或用户。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
type | string | 是 | 要检查的类型："artist" 或 "user" |
ids | string | 是 | 逗号分隔的艺术家或用户 ID (最多 50 个) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
results | json | 每个 ID 对应的布尔值数组 |
获取节目
操作
获取节目
Spotify 账户*
Connect spotify...
节目 ID*
Spotify 节目/播客 ID
获取节目(
spotify_get_show)获取播客节目的详细信息。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
showId | string | 是 | Spotify 节目 ID |
market | string | 否 | 市场 ISO 国家/地区代码 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
id | string | 节目 ID |
name | string | 节目名称 |
description | string | 节目简介 |
publisher | string | 发布者名称 |
total_episodes | number | 单集总数 |
explicit | boolean | 是否包含露骨内容 |
languages | json | 语言 |
image_url | string | 封面图片 URL |
external_url | string | Spotify URL |
获取多个节目
操作
批量获取节目
Spotify 账户*
Connect spotify...
节目 ID*
以逗号分隔的节目 ID
获取多个节目 (
spotify_get_shows)获取多个播客节目的详细信息。
输入
| Parameter | Type | Required | Description |
|---|---|---|---|
showIds | string | Yes | 以逗号分隔的节目 ID (最多 50 个) |
market | string | No | 市场的 ISO 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
shows | json | 节目列表 |
获取节目单集
操作
获取节目单集
Spotify 账户*
Connect spotify...
节目 ID*
Spotify 节目/播客 ID
限制
结果数量（1-50，默认：20）
获取节目剧集 (
spotify_get_show_episodes)从播客节目获取剧集。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
showId | string | 是 | Spotify 节目 ID |
limit | number | 否 | 返回的剧集数量 (1-50) |
offset | number | 否 | 返回的第一集剧集的索引 |
market | string | 否 | 市场的 ISO 国家代码 |
输出
| Parameter | Type | Description |
|---|---|---|
episodes | json | 剧集列表 |
total | number | 剧集总数 |
next | string | 下一页的 URL |
获取已保存的节目
操作
获取已保存的播客节目
Spotify 账户*
Connect spotify...
数量上限
结果数量（1-50，默认：20）
获取已保存节目（
spotify_get_saved_shows）获取用户已保存的播客节目。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 要返回的节目数量 (1-50) |
offset | number | 否 | 要返回的第一个节目索引 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
shows | json | 已保存节目列表 |
total | number | 已保存节目总数 |
next | string | 下一页 URL |
保存节目
操作
保存节目
Spotify 账号*
Connect spotify...
节目 ID*
以逗号分隔的节目 ID
保存节目（
spotify_save_shows）将播客节目保存到用户的库中。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
showIds | string | 是 | 逗号分隔的节目 ID (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 节目是否已保存 |
移除已保存的节目
操作
移除已保存节目
Spotify 账户*
Connect spotify...
节目 ID*
以逗号分隔的节目 ID
移除已保存的节目 (
spotify_remove_saved_shows)从用户库中移除播客节目。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
showIds | string | 是 | 以逗号分隔的节目 ID（最多 50 个） |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 节目是否已被移除 |
检查已保存的节目
操作
检查已保存节目
Spotify 账号*
Connect spotify...
节目 ID*
以逗号分隔的节目 ID
检查已保存的节目（
spotify_check_saved_shows）检查节目是否已保存到资料库。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
showIds | string | 是 | 以逗号分隔的节目 ID (最多 50 个) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
results | json | 每个节目对应的布尔值数组 |
获取单集
操作
获取单集
Spotify 账户*
Connect spotify...
单集 ID*
Spotify 单集 ID
获取剧集 (
spotify_get_episode)获取播客剧集的详细信息。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
episodeId | string | 是 | Spotify 剧集 ID |
market | string | 否 | 市场的 ISO 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
id | string | 剧集 ID |
name | string | 剧集名称 |
description | string | 剧集描述 |
duration_ms | number | 时长（毫秒） |
release_date | string | 发布日期 |
explicit | boolean | 是否包含露骨内容 |
show | json | 所属节目信息 |
image_url | string | 封面图片 URL |
external_url | string | Spotify URL |
获取多个剧集
操作
获取多个剧集
Spotify 账户*
Connect spotify...
剧集 ID*
以逗号分隔的剧集 ID
获取多个单集（
spotify_get_episodes）获取多个播客单集的详细信息。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
episodeIds | string | 是 | 以逗号分隔的单集 ID（最多 50 个） |
market | string | 否 | 市场对应的 ISO 国家/地区代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
episodes | json | 剧集列表 |
获取已保存的单集
操作
获取已保存的剧集
Spotify 账号*
Connect spotify...
数量上限
结果数量（1-50，默认：20）
获取已保存的单集 (
spotify_get_saved_episodes)获取用户已保存的播客单集。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 要返回的单集数量 (1-50) |
offset | number | 否 | 要返回的第一个单集的索引 |
market | string | 否 | 市场 ISO 国家代码 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
episodes | json | 已保存单集的列表 |
total | number | 已保存单集总数 |
next | string | 下一页的 URL |
保存单集
操作
保存单集
Spotify 账户*
Connect spotify...
单集 ID*
以逗号分隔的单集 ID
保存单集 (
spotify_save_episodes)将播客单集保存到用户的资料库。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
episodeIds | string | 是 | 以逗号分隔的单集 ID (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 单集是否已保存 |
移除已保存的单集
操作
移除已保存的单集
Spotify 账户*
Connect spotify...
单集 ID*
以逗号分隔的单集 ID
移除已保存的剧集 (
spotify_remove_saved_episodes)从用户库中移除播客单集。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
episodeIds | string | 是 | 逗号分隔的剧集 ID (最多 50 个) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | 布尔值 | 是否已移除单集 |
检查已保存的剧集
操作
检查已保存的单集
Spotify 账户*
Connect spotify...
单集 ID*
以逗号分隔的单集 ID
检查已保存的剧集 (
spotify_check_saved_episodes)检查剧集是否已保存到库中。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
episodeIds | string | 是 | 逗号分隔的剧集 ID (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
results | json | 每个单集的布尔值数组 |
获取有声书
操作
获取有声书
Spotify 账户*
Connect spotify...
有声书 ID*
Spotify 有声书 ID
获取有声书 (
spotify_get_audiobook)获取有声书的详细信息。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
audiobookId | string | 是 | Spotify 有声书 ID |
market | string | 否 | 市场 ISO 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
id | string | 有声书 ID |
name | string | 有声书名称 |
authors | json | 作者 |
narrators | json | 朗读者 |
publisher | string | 出版方 |
description | string | 描述 |
total_chapters | number | 总章节数 |
languages | json | 语言 |
image_url | string | 封面图片 URL |
external_url | string | Spotify URL |
获取多个有声书
操作
获取多个有声书
Spotify 账号*
Connect spotify...
有声书 ID*
以逗号分隔的有声书 ID
获取多个有声书 (
spotify_get_audiobooks)获取多个有声书的详情。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
audiobookIds | string | 是 | 以逗号分隔的有声书 ID (最多 50 个) |
market | string | 否 | 市场的 ISO 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
audiobooks | json | 有声书列表 |
获取有声书章节
操作
获取有声书章节
Spotify 账户*
Connect spotify...
有声书 ID*
Spotify 有声书 ID
限制
结果数量（1-50，默认：20）
获取有声书章节 (
spotify_get_audiobook_chapters)获取有声书的章节。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
audiobookId | 字符串 | 是 | Spotify 有声书 ID |
limit | 数字 | 否 | 返回的章节数量 (1-50) |
offset | 数字 | 否 | 要返回的第一个章节的索引 |
market | 字符串 | 否 | 市场的 ISO 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
chapters | json | 章节列表 |
total | number | 章节总数 |
next | string | 下一页的 URL |
获取已保存的有声书
操作
获取已保存的有声书
Spotify 账户*
Connect spotify...
限制
结果数量（1-50，默认：20）
获取已保存的有声书（
spotify_get_saved_audiobooks）获取用户已保存的有声书。
输入
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 返回的有声书数量 (1-50) |
offset | number | 否 | 返回的第一本有声书索引 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
audiobooks | json | 已保存的有声书列表 |
total | number | 已保存有声书总数 |
next | string | 下一页的 URL |
保存有声书
操作
保存有声书
Spotify 账户*
Connect spotify...
有声书 ID*
以逗号分隔的有声书 ID
保存有声书（
spotify_save_audiobooks）将有声书保存到用户的资料库中。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
audiobookIds | string | 是 | 以逗号分隔的有声书 ID (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 有声书是否已保存 |
移除已保存的有声书
操作
移除已保存有声书
Spotify 账户*
Connect spotify...
有声书 ID*
以逗号分隔的有声书 ID
移除已保存的有声书 (
spotify_remove_saved_audiobooks)从用户的媒体库中移除有声书。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
audiobookIds | string | 是 | 以逗号分隔的有声书 ID (最多 50 个) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否已移除有声书 |
检查已保存的有声书
操作
检查已收藏有声书
Spotify 账户*
Connect spotify...
有声书 ID*
以逗号分隔的有声书 ID
检查已保存的有声书 (
spotify_check_saved_audiobooks)检查有声书是否已保存在库中。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
audiobookIds | string | 是 | 以逗号分隔的有声书 ID (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
results | json | 每本有声书的布尔值数组 |
获取播放列表
操作
获取播放列表
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
获取播放列表 (
spotify_get_playlist)通过 ID 获取 Spotify 播放列表的详细信息。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
playlistId | string | 是 | 播放列表的 Spotify ID |
market | string | 否 | 用于曲目可用性的 ISO 3166-1 alpha-2 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
id | string | Spotify 播放列表 ID |
name | string | 播放列表名称 |
description | string | 播放列表描述 |
public | boolean | 播放列表是否为公开 |
collaborative | boolean | 播放列表是否为协作 |
owner | object | 播放列表所有者信息 |
image_url | string | 播放列表封面图片 URL |
total_tracks | number | 曲目总数 |
snapshot_id | string | 用于版本控制的播放列表快照 ID |
external_url | string | Spotify URL |
获取播放列表曲目
操作
获取播放列表曲目
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
限制
结果数量（1-50，默认：20）
获取播放列表曲目 (
spotify_get_playlist_tracks)获取 Spotify 播放列表中的曲目。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
playlistId | string | 是 | 播放列表的 Spotify ID |
limit | number | 否 | 返回的最大曲目数 (1-100) |
offset | number | 否 | 返回的首个曲目索引 |
market | string | 否 | 用于曲目可用性的 ISO 3166-1 alpha-2 国家/地区代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
tracks | 数组 | 播放列表中的曲目列表 |
total | 数字 | 播放列表中的曲目总数 |
next | 字符串 | 下一页结果的 URL |
获取播放列表封面
操作
获取播放列表封面
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
获取播放列表封面 (
spotify_get_playlist_cover)获取播放列表的封面图片。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
playlistId | 字符串 | 是 | Spotify 播放列表 ID |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
images | json | 封面图片列表 |
获取我的播放列表
操作
获取我的播放列表
Spotify 账户*
Connect spotify...
限制
结果数量（1-50，默认：20）
获取我的播放列表（
spotify_get_user_playlists）获取当前用户的 Spotify 播放列表。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
limit | number | 否 | 返回的播放列表数量上限 (1-50) |
offset | number | 否 | 返回的第一个播放列表的索引 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
playlists | 数组 | 用户的播放列表 |
total | 数字 | 播放列表总数 |
next | 字符串 | 下一页的 URL |
创建播放列表
操作
创建播放列表
Spotify 账户*
Connect spotify...
播放列表名称*
我的精彩播放列表
播放列表描述
播放列表的可选描述
公开
Enabled
创建播放列表（
spotify_create_playlist）为 Spotify 当前用户创建新播放列表。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 新播放列表的名称 |
description | string | 否 | 播放列表的说明 |
public | boolean | 否 | 播放列表是否公开 |
collaborative | boolean | 否 | 播放列表是否协作 (要求公开设为 false) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
id | string | Spotify 播放列表 ID |
name | string | 播放列表名称 |
description | string | 播放列表描述 |
public | boolean | 播放列表是否公开 |
collaborative | boolean | 是否为协作播放列表 |
snapshot_id | string | 播放列表快照 ID |
external_url | string | Spotify URL |
更新播放列表
操作
更新播放列表
Spotify 账号*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
新名称
新播放列表名称（可选）
播放列表描述
播放列表的可选描述
公开
Enabled
更新播放列表（
spotify_update_playlist）更新播放列表的名称、描述或可见性。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
playlistId | string | 是 | Spotify 播放列表 ID |
name | string | 否 | 播放列表的新名称 |
description | string | 否 | 播放列表的新描述 |
public | boolean | 否 | 播放列表是否公开 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 更新是否成功 |
添加播放列表封面
操作
添加播放列表封面
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
图片（Base64）*
Base64 编码的 JPEG 图片（最大 256KB）
添加播放列表封面（
spotify_add_playlist_cover）为播放列表上传自定义封面图片。图片必须为 JPEG 格式且小于 256KB。
输入
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
playlistId | string | 是 | Spotify 播放列表 ID |
imageBase64 | string | 是 | Base64 编码的 JPEG 图像 (最大 256KB) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 上传是否成功 |
添加曲目到播放列表
操作
向播放列表添加曲目
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
曲目 URI*
spotify:track:xxx,spotify:track:yyy
添加曲目到播放列表（
spotify_add_tracks_to_playlist）向 Spotify 播放列表添加一个或多个曲目。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
playlistId | string | 是 | 播放列表的 Spotify ID |
uris | string | 是 | 以逗号分隔的 Spotify URI (例如 "spotify:track:xxx,spotify:track:yyy") |
position | number | 否 | 插入曲目的位置 (从 0 开始)。如省略，曲目将追加到末尾。 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
snapshot_id | 字符串 | 修改后的新播放列表快照 ID |
从播放列表移除曲目
操作
从播放列表移除曲目
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
曲目 URI*
spotify:track:xxx,spotify:track:yyy
从播放列表移除曲目 (
spotify_remove_tracks_from_playlist)从 Spotify 播放列表中移除一个或多个曲目。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
playlistId | string | 是 | 播放列表的 Spotify ID |
uris | string | 是 | 要移除的以逗号分隔的 Spotify URI (例如，"spotify:track:xxx,spotify:track:yyy") |
输出
| Parameter | Type | Description |
|---|---|---|
snapshot_id | string | 修改后的新播放列表快照 ID |
重新排序播放列表项
操作
重新排列播放列表项目
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
起始范围*
要移动项目的起始索引
插入位置之前*
插入位置的索引
范围长度
要移动的项目数量(默认值:1)
重新排序播放列表项 (
spotify_reorder_playlist_items)将曲目移动到播放列表中的不同位置。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
playlistId | 字符串 | 是 | Spotify 播放列表 ID |
range_start | 数字 | 是 | 要重新排序的项目的起始索引 |
insert_before | 数字 | 是 | 插入项目之前的索引 |
range_length | 数字 | 否 | 要重新排序的项目数量 |
snapshot_id | 字符串 | 否 | 用于并发控制的播放列表快照 ID |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
snapshot_id | 字符串 | 新的播放列表快照 ID |
替换播放列表项
操作
替换播放列表项
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
曲目 URI*
spotify:track:xxx,spotify:track:yyy
替换播放列表项目 (
spotify_replace_playlist_items)用新曲目替换播放列表中的所有项目。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
playlistId | string | 是 | Spotify 播放列表 ID |
uris | string | 是 | 以逗号分隔的 Spotify URI (最多 100 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
snapshot_id | string | 新的播放列表快照 ID |
关注播放列表
操作
关注播放列表
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
公开
Enabled
关注歌单 (
spotify_follow_playlist)关注（保存）歌单。
输入
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | Spotify 歌单 ID |
public | boolean | No | 歌单是否设为公开 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | 布尔值 | 是否关注成功 |
取消关注歌单
操作
取消关注播放列表
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
取消关注播放列表 (
spotify_unfollow_playlist)取消关注（取消保存）播放列表。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
playlistId | string | 是 | Spotify 播放列表 ID |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 取消关注是否成功 |
检查播放列表关注者
操作
检查播放列表关注者
Spotify 账户*
Connect spotify...
播放列表 ID*
Spotify 播放列表 ID
用户 ID*
以逗号分隔的用户 ID，最多 5 个
检查播放列表关注者 (
spotify_check_playlist_followers)检查用户是否关注播放列表。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
playlistId | string | 是 | Spotify 播放列表 ID |
userIds | string | 是 | 逗号分隔的用户 ID，用于检查 (最多 5 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
results | json | 每个用户的布尔值数组 |
获取我的个人资料
操作
获取我的个人资料
Spotify 账户*
Connect spotify...
获取我的个人资料（
spotify_get_current_user）获取当前用户的 Spotify 个人资料信息。
输入
此操作没有直接参数。
输出
| 参数 | 类型 | 说明 |
|---|---|---|
id | string | Spotify 用户 ID |
display_name | string | 显示名称 |
email | string | 电子邮件地址 |
country | string | 国家/地区代码 |
product | string | 订阅级别 (免费、高级) |
followers | number | 关注者数量 |
image_url | string | 个人资料图片 URL |
external_url | string | Spotify 个人资料 URL |
获取用户个人资料
操作
获取用户个人资料
Spotify 账户*
Connect spotify...
用户 ID*
Spotify 用户 ID
获取用户资料 (
spotify_get_user_profile)获取用户的公开个人资料。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | Spotify 用户 ID |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
id | string | 用户 ID |
display_name | string | 显示名称 |
followers | number | 关注者数量 |
image_url | string | 头像 URL |
external_url | string | Spotify URL |
获取我的热门曲目
操作
获取我的热门单曲
Spotify 账户*
Connect spotify...
时间范围
过去 6 个月
数量上限
结果数量（1-50，默认：20）
获取我的热门曲目（
spotify_get_top_tracks）根据收听历史获取当前用户的热门曲目。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
time_range | string | 否 | 时间范围：short_term (约 4 周)、medium_term (约 6 个月)、long_term (数年) |
limit | number | 否 | 返回的曲目数量 (1-50) |
offset | number | 否 | 要返回的第一首曲目的索引 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
tracks | array | 用户的热门曲目 |
total | number | 热门曲目总数 |
next | string | 下一页的 URL |
获取我的热门艺人
操作
获取我的热门艺人
Spotify 账户*
Connect spotify...
时间范围
最近 6 个月
上限
结果数量（1-50，默认 20）
获取我的热门艺术家 (
spotify_get_top_artists)根据收听历史获取当前用户的热门艺术家。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
time_range | string | 否 | 时间范围：short_term (~4周)、medium_term (~6个月)、long_term (数年) |
limit | number | 否 | 返回的艺术家数量 (1-50) |
offset | number | 否 | 返回的第一个艺术家的索引 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
artists | 数组 | 用户的热门艺术家 |
total | 数字 | 热门艺术家总数 |
next | 字符串 | 下一页的 URL |
获取已保存的曲目
操作
获取已保存的曲目
Spotify 账户*
Connect spotify...
限制
结果数量（1-50，默认：20）
获取已保存的曲目 (
spotify_get_saved_tracks)从当前用户的音乐库中获取其收藏/喜欢的曲目。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
limit | number | 否 | 要返回的曲目数量 (1-50) |
offset | number | 否 | 要返回的第一个曲目的索引 |
market | string | 否 | ISO 3166-1 alpha-2 国家/地区代码 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
tracks | array | 用户收藏的曲目 |
total | number | 收藏曲目的总数 |
next | string | 下一页的 URL |
保存曲目
操作
收藏单曲
Spotify 账户*
Connect spotify...
曲目 ID*
以逗号分隔的曲目 ID
保存曲目 (
spotify_save_tracks)将曲目保存到当前用户的音乐库（点赞曲目）。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
trackIds | string | Yes | 用逗号分隔的 Spotify 曲目 ID (最多 50 个) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 曲目是否保存成功 |
移除已保存的曲目
操作
移除已保存的曲目
Spotify 账户*
Connect spotify...
曲目 ID*
以逗号分隔的曲目 ID
移除已保存的曲目 (
spotify_remove_saved_tracks)从用户库中移除曲目。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
trackIds | string | 是 | 要移除的曲目 ID，用逗号分隔 (最多 50 个) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 曲目是否已成功移除 |
检查已保存的曲目
操作
检查已保存曲目
Spotify 账户*
Connect spotify...
曲目 ID*
以逗号分隔的曲目 ID
检查已保存的曲目 (
spotify_check_saved_tracks)检查用户库中是否已保存一个或多个曲目。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
trackIds | string | 是 | 以逗号分隔的曲目 ID，用于检查 (最多 50 个) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
results | json | 包含已保存状态的曲目 ID 数组 |
all_saved | boolean | 是否所有曲目均已保存 |
none_saved | boolean | 是否没有任何曲目已保存 |
获取最近播放
操作
获取最近播放
Spotify 账户*
Connect spotify...
数量上限
结果数量（1-50，默认：20）
获取最近播放 (
spotify_get_recently_played)获取用户最近播放的曲目。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
limit | number | 否 | 要返回的曲目数量（1-50） |
after | number | 否 | Unix 时间戳（毫秒）。返回此游标之后的项目。 |
before | number | 否 | Unix 时间戳（毫秒）。返回此游标之前的项目。 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
items | 数组 | 最近播放的曲目 |
next | 字符串 | 下一页的 URL |
获取新发布
操作
获取新发行
Spotify 账户*
Connect spotify...
国家/地区
ISO 国家代码（例如：US、GB）
限制
结果数量（1-50，默认：20）
获取新发行版 (
spotify_get_new_releases)获取 Spotify 中精选的新专辑发行版列表。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
country | 字符串 | 否 | ISO 3166-1 alpha-2 国家代码 (例如 "US"、"GB") |
limit | 数字 | 否 | 要返回的发行版数量 (1-50) |
offset | 数字 | 否 | 要返回的第一个发行版的索引 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
albums | json | 最新发行列表 |
total | number | 最新发行的总数 |
next | string | 下一页的 URL |
获取分类
操作
获取分类
Spotify 账户*
Connect spotify...
国家/地区
ISO 国家/地区代码（例如：US、GB）
数量上限
结果数量（1-50，默认：20）
获取分类（
spotify_get_categories）获取用于在 Spotify 中标记内容的浏览分类列表。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
country | string | 否 | ISO 3166-1 alpha-2 国家/地区代码 (例如 "US"、"GB") |
locale | string | 否 | 区域设置代码 (例如 "en_US"、"es_MX") |
limit | number | 否 | 要返回的分类数量 (1-50) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
categories | json | 浏览分类列表 |
total | number | 分类总数 |
获取可用市场
操作
获取可用市场
Spotify 账户*
Connect spotify...
获取可用市场 (
spotify_get_markets)获取 Spotify 可用的市场列表。
输入
此操作没有直接参数。
输出
| 参数 | 类型 | 说明 |
|---|---|---|
markets | json | ISO 国家代码列表 |
获取播放状态
操作
获取播放状态
Spotify 账户*
Connect spotify...
获取播放状态 (
spotify_get_playback_state)获取当前播放状态，包括设备、曲目和进度。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
market | string | 否 | ISO 3166-1 alpha-2 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
is_playing | boolean | 播放是否处于活动状态 |
device | object | 活动设备信息 |
progress_ms | number | 进度（毫秒） |
currently_playing_type | string | 正在播放的内容类型 |
shuffle_state | boolean | 是否启用随机播放 |
repeat_state | string | 重复模式 (off, track, context) |
track | object | 当前播放的曲目 |
获取当前播放
操作
获取当前播放
Spotify 账户*
Connect spotify...
获取当前播放 (
spotify_get_currently_playing)获取用户当前正在播放的曲目。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
market | string | 否 | 市场 ISO 国家代码 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
is_playing | boolean | 播放是否处于活动状态 |
progress_ms | number | 曲目中的当前位置(毫秒) |
track | json | 当前播放的曲目 |
获取设备
操作
获取设备
Spotify 账户*
Connect spotify...
获取设备（
spotify_get_devices）获取用户可用的 Spotify 播放设备。
输入
此操作没有直接参数。
输出
| 参数 | 类型 | 描述 |
|---|---|---|
devices | array | 可用的播放设备 |
获取队列
操作
获取队列
Spotify 账户*
Connect spotify...
获取队列（
spotify_get_queue）获取用户的播放队列。
输入
此操作没有直接参数。
输出
| 参数 | 类型 | 说明 |
|---|---|---|
currently_playing | json | 当前播放的曲目 |
queue | json | 队列中即将播放的曲目 |
播放
操作
播放
Spotify 账户*
Connect spotify...
设备 ID
可选 - 未指定时使用当前活动设备
上下文 URI
spotify:album:xxx or spotify:playlist:yyy
曲目 URI
spotify:track:xxx（多个以逗号分隔）
播放（
spotify_play）在 Spotify 上开始或恢复播放。可播放指定曲目、专辑或播放列表。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device_id | string | 否 | 要播放到的设备 ID。未提供时，在活动设备上播放。 |
context_uri | string | 否 | 要播放的专辑、艺人或播放列表的 Spotify URI (例如 "spotify:album:xxx") |
uris | string | 否 | 要播放的曲目 URI，以逗号分隔 (例如 "spotify:track:xxx,spotify:track:yyy") |
offset | number | 否 | 开始播放的上下文位置 (从 0 开始的索引) |
position_ms | number | 否 | 曲目的起始播放位置 (毫秒) |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 播放是否成功启动 |
暂停
操作
暂停
Spotify 账号*
Connect spotify...
设备 ID
可选 - 未指定时使用活动设备
暂停 (
spotify_pause)在 Spotify 上暂停播放。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
device_id | 字符串 | 否 | 要暂停的设备 ID。如果未提供，则暂停活动设备。 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | 布尔值 | 播放是否已暂停 |
跳至下一首
操作
跳至下一首
Spotify 账户*
Connect spotify...
设备 ID
可选 - 未指定时使用当前设备
跳到下一首 (
spotify_skip_next)跳到 Spotify 上的下一首曲目。
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
device_id | string | 否 | 设备 ID。如果未提供，则使用当前活动设备。 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 跳过是否成功 |
跳到上一首
操作
跳到上一首
Spotify 账户*
Connect spotify...
设备 ID
可选 - 未指定时使用当前活动设备
跳到上一首 (
spotify_skip_previous)跳到 Spotify 上的上一首曲目。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
device_id | string | 否 | 设备 ID。如果未提供，则使用活动设备。 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 跳过是否成功 |
跳转
操作
跳转
Spotify 账户*
Connect spotify...
设备 ID
可选 - 如果未指定，则使用活动设备
位置 (ms)*
以毫秒为单位的位置
跳转 (
spotify_seek)跳转到当前播放曲目中的指定位置。
输入
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
position_ms | number | 是 | 跳转到的位置（毫秒） |
device_id | string | 否 | 目标设备 ID |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 跳转是否成功 |
添加到队列
操作
添加到队列
Spotify 账户*
Connect spotify...
设备 ID
可选 - 未指定时使用活动设备
曲目 URI*
spotify:track:xxx
添加到队列（
spotify_add_to_queue）将曲目添加到用户的播放队列。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
uri | string | 是 | 要添加的曲目的 Spotify URI (例如 "spotify:track:xxx") |
device_id | string | 否 | 设备 ID。未提供时使用当前活动设备。 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 曲目是否已添加到队列 |
设置音量
操作
设置音量
Spotify 账户*
Connect spotify...
设备 ID
可选 - 未指定时使用当前活动设备
音量
0
设置音量 (
spotify_set_volume)设置 Spotify 的播放音量。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
volume_percent | number | 是 | 音量级别 (0 到 100) |
device_id | string | 否 | 设备 ID。如未提供，则使用当前活动设备。 |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否已设置音量 |
设置重复模式
操作
设置重复模式
Spotify 账户*
Connect spotify...
设备 ID
可选 — 未指定时使用当前活动设备
重复模式
关闭
设置重复 (
spotify_set_repeat)设置播放的重复模式。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
state | 字符串 | 是 | 重复模式："off"、"track" 或 "context" |
device_id | 字符串 | 否 | 目标设备 ID |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | 布尔值 | 重复模式是否设置成功 |
设置随机播放
操作
设置随机播放
Spotify 账户*
Connect spotify...
设备 ID
可选 - 未指定时使用活动设备
随机播放
Disabled
设置随机播放（
spotify_set_shuffle）开启或关闭随机播放。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
state | boolean | 是 | true 表示开启随机播放，false 表示关闭 |
device_id | string | 否 | 目标设备 ID |
输出
| 参数 | 类型 | 说明 |
|---|---|---|
success | boolean | 随机播放是否设置成功 |
转移播放
操作
转移播放
Spotify 账号*
Connect spotify...
目标设备 ID*
要转移到的设备 ID
转移播放 (
spotify_transfer_playback)将播放转移到其他设备。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
device_id | string | 是 | 要转移播放到的设备 ID |
play | boolean | 否 | 是否在新设备上开始播放 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 转移是否成功 |
使用说明
将 Spotify 集成到你的工作流中。搜索曲目、专辑、艺人和播放列表。管理播放列表，访问你的音乐库，控制播放，浏览播客和有声书。
注意事项
- 类别：
tools - 类型：
spotify