Spotify Automation by composiohq/awesome-claude-skills
npx skills add https://github.com/composiohq/awesome-claude-skills --skill 'Spotify Automation'自动化 Spotify 操作——管理播放列表、搜索音乐目录、控制播放、浏览专辑和曲目,以及访问用户资料——所有这些都通过 Composio MCP 集成进行编排。
工具包文档: composio.dev/toolkits/spotify
https://rube.app/mcp 上的 Composio MCP 服务器连接您的 Spotify 账户SPOTIFY_* 工具都可供执行检索已认证 Spotify 用户的完整资料信息。
工具: SPOTIFY_GET_CURRENT_USER_S_PROFILE
无需参数。
返回:显示名称、电子邮件、国家/地区、订阅级别(高级/免费)、
露骨内容设置、资料图片、关注者数量以及 Spotify URI。
所需权限范围:user-read-private, user-read-email。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
通过关键词查找专辑、艺术家、播放列表、曲目、节目、剧集或有声读物。
工具: SPOTIFY_SEARCH_FOR_ITEM
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
q | string | 是 | 搜索查询关键词 |
type | array | 是 | 项目类型:album, artist, playlist, track, show, episode, audiobook |
limit | integer | 否 | 要返回的结果数(默认:20) |
offset | integer | 否 | 分页偏移量(默认:0) |
market | string | 否 | ISO 3166-1 alpha-2 国家代码 |
include_external | string | 否 | 设置为 audio 以包含外部内容 |
注意: 有声读物仅在美国、英国、加拿大、爱尔兰、新西兰和澳大利亚可用。
浏览、创建、修改和填充播放列表。
获取用户的播放列表:
工具: SPOTIFY_GET_USER_S_PLAYLISTS
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
user_id | string | 是 | Spotify 用户 ID |
limit | integer | 否 | 最大播放列表数,1-50(默认:20) |
offset | integer | 否 | 分页偏移量,0-100000(默认:0) |
获取当前用户的播放列表:
工具: SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
limit | integer | 否 | 最大播放列表数,1-50(默认:20) |
offset | integer | 否 | 分页偏移量,0-100000(默认:0) |
获取播放列表详情:
工具: SPOTIFY_GET_PLAYLIST
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
playlist_id | string | 是 | Spotify 播放列表 ID(例如:3cEYpjA9oz9GiPac4AsH4n) |
fields | string | 否 | 逗号分隔的字段过滤器,用于减少响应大小 |
market | string | 否 | 针对特定市场内容的 ISO 国家代码 |
additional_types | string | 否 | track,episode 以包含播客剧集 |
更新播放列表详情:
工具: SPOTIFY_CHANGE_PLAYLIST_DETAILS
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
playlist_id | string | 是 | 播放列表 ID(必须由当前用户拥有) |
name | string | 否 | 新的播放列表名称 |
description | string | 否 | 新的播放列表描述 |
public | boolean | 否 | 公开/私密切换 |
collaborative | boolean | 否 | 协作模式(仅在非公开播放列表上可用) |
查看播放列表中的曲目并添加新项目。
工具: SPOTIFY_GET_PLAYLIST_ITEMS
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
playlist_id | string | 是 | Spotify 播放列表 ID |
limit | integer | 否 | 每页项目数,1-50(默认:20) |
offset | integer | 否 | 分页偏移量(默认:0) |
fields | string | 否 | 字段过滤器(例如:items(track(name,id))) |
market | string | 否 | ISO 国家代码 |
additional_types | string | 否 | track,episode 用于播客剧集 |
工具: SPOTIFY_ADD_ITEMS_TO_PLAYLIST
使用 Spotify URI 向播放列表添加曲目或剧集。
检索单个曲目和专辑的目录信息。
工具: SPOTIFY_GET_TRACK —— 通过 Spotify ID 获取单个曲目的详情。
工具: SPOTIFY_GET_ALBUM —— 获取包括曲目列表、艺术家信息、封面艺术和流行度在内的完整专辑数据。
在用户的活动设备上开始、恢复或更改播放。
工具: SPOTIFY_START_RESUME_PLAYBACK
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
context_uri | string | 否 | 专辑、艺术家或播放列表的 Spotify URI(不能与 uris 结合使用) |
uris | array | 否 | 要播放的曲目 URI 列表(不能与 context_uri 结合使用) |
offset | object | 否 | 起始位置:{position: 5} 或 {uri: 'spotify:track:...'} |
position_ms | integer | 否 | 起始位置(毫秒) |
device_id | string | 否 | 目标设备 ID(默认为活动设备) |
要求: Spotify Premium 订阅和至少一个活动设备。
| 问题 | 详情 |
|---|---|
| 播放需要 Premium 订阅 | 如果用户没有 Spotify Premium,SPOTIFY_START_RESUME_PLAYBACK 会返回 403 |
| 需要活动设备 | 如果没有活动的 Spotify 设备(移动设备、桌面端、网页端、扬声器),播放控制会返回 404 |
| context_uri 与 uris 互斥 | 不能在同一个播放调用中同时使用 context_uri 和 uris |
| 协作播放列表 | collaborative 只能在非公开播放列表上设置为 true(public 必须为 false) |
| 播放列表所有权 | SPOTIFY_CHANGE_PLAYLIST_DETAILS 仅对已认证用户拥有的播放列表有效 |
| 有声读物市场限制 | 通过搜索获取的有声读物仅在美国、英国、加拿大、爱尔兰、新西兰和澳大利亚可用 |
| 最多 11000 个播放列表 | 用户通过 SPOTIFY_CREATE_PLAYLIST 创建的播放列表数量限制约为 11,000 个 |
| 工具标识 | 用途 |
|---|---|
SPOTIFY_GET_CURRENT_USER_S_PROFILE | 获取已认证用户的资料 |
SPOTIFY_SEARCH_FOR_ITEM | 在目录中搜索曲目、专辑、艺术家等 |
SPOTIFY_GET_USER_S_PLAYLISTS | 获取任何用户的播放列表 |
SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS | 获取当前用户的播放列表 |
SPOTIFY_GET_PLAYLIST | 获取详细的播放列表信息 |
SPOTIFY_GET_PLAYLIST_ITEMS | 列出播放列表中的曲目/剧集 |
SPOTIFY_CHANGE_PLAYLIST_DETAILS | 更新播放列表名称、描述、可见性 |
SPOTIFY_CREATE_PLAYLIST | 创建新的播放列表 |
SPOTIFY_ADD_ITEMS_TO_PLAYLIST | 向播放列表添加曲目/剧集 |
SPOTIFY_GET_TRACK | 通过 ID 获取曲目详情 |
SPOTIFY_GET_ALBUM | 通过 ID 获取专辑详情 |
SPOTIFY_START_RESUME_PLAYBACK | 在设备上开始或恢复播放 |
由Composio提供支持
每周安装数
0
代码仓库
GitHub 星标数
42.7K
首次出现
1970年1月1日
安全审计
Automate Spotify operations -- manage playlists, search the music catalog, control playback, browse albums and tracks, and access user profiles -- all orchestrated through the Composio MCP integration.
Toolkit docs: composio.dev/toolkits/spotify
https://rube.app/mcpSPOTIFY_* tools become available for executionRetrieve comprehensive profile information for the authenticated Spotify user.
Tool: SPOTIFY_GET_CURRENT_USER_S_PROFILE
No parameters required.
Returns: display name, email, country, subscription level (premium/free),
explicit content settings, profile images, follower count, and Spotify URIs.
Required scopes: user-read-private, user-read-email.
Find albums, artists, playlists, tracks, shows, episodes, or audiobooks by keyword.
Tool: SPOTIFY_SEARCH_FOR_ITEM
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query keywords |
type | array | Yes | Item types: album, artist, playlist, track, show, episode, |
Note: Audiobooks are only available in US, UK, Canada, Ireland, New Zealand, and Australia.
Browse, create, modify, and populate playlists.
Get a user's playlists:
Tool: SPOTIFY_GET_USER_S_PLAYLISTS
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | Spotify user ID |
limit | integer | No | Max playlists, 1-50 (default: 20) |
offset | integer | No | Pagination offset, 0-100000 (default: 0) |
Get current user's playlists:
Tool: SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Max playlists, 1-50 (default: 20) |
offset | integer | No | Pagination offset, 0-100000 (default: 0) |
Get playlist details:
Tool: SPOTIFY_GET_PLAYLIST
| Parameter | Type | Required | Description |
|---|---|---|---|
playlist_id | string | Yes | Spotify playlist ID (e.g., 3cEYpjA9oz9GiPac4AsH4n) |
fields | string | No | Comma-separated field filter to reduce response size |
market | string | No | ISO country code for market-specific content |
additional_types |
Update playlist details:
Tool: SPOTIFY_CHANGE_PLAYLIST_DETAILS
| Parameter | Type | Required | Description |
|---|---|---|---|
playlist_id | string | Yes | Playlist ID (must be owned by current user) |
name | string | No | New playlist name |
description | string | No | New playlist description |
public | boolean | No | Public/private toggle |
View tracks in a playlist and add new items.
Tool: SPOTIFY_GET_PLAYLIST_ITEMS
| Parameter | Type | Required | Description |
|---|---|---|---|
playlist_id | string | Yes | Spotify playlist ID |
limit | integer | No | Items per page, 1-50 (default: 20) |
offset | integer | No | Pagination offset (default: 0) |
fields | string | No | Field filter (e.g., items(track(name,id))) |
Tool: SPOTIFY_ADD_ITEMS_TO_PLAYLIST
Add tracks or episodes to a playlist using Spotify URIs.
Retrieve catalog information for individual tracks and albums.
Tool: SPOTIFY_GET_TRACK -- Get details for a single track by Spotify ID.
Tool: SPOTIFY_GET_ALBUM -- Get comprehensive album data including track listing, artist info, cover art, and popularity.
Start, resume, or change playback on the user's active device.
Tool: SPOTIFY_START_RESUME_PLAYBACK
| Parameter | Type | Required | Description |
|---|---|---|---|
context_uri | string | No | Spotify URI of album, artist, or playlist (cannot combine with uris) |
uris | array | No | List of track URIs to play (cannot combine with context_uri) |
offset | object | No | Starting position: {position: 5} or |
Requirements: Spotify Premium subscription and at least one active device.
| Pitfall | Details |
|---|---|
| Premium required for playback | SPOTIFY_START_RESUME_PLAYBACK returns 403 if the user does not have Spotify Premium |
| Active device required | Playback control returns 404 if no Spotify device (mobile, desktop, web, speaker) is active |
| context_uri vs uris are exclusive | Cannot use both context_uri and uris in the same playback call |
| Collaborative playlists | collaborative can only be set to true on non-public playlists (public must be ) |
| Tool Slug | Purpose |
|---|---|
SPOTIFY_GET_CURRENT_USER_S_PROFILE | Get authenticated user's profile |
SPOTIFY_SEARCH_FOR_ITEM | Search catalog for tracks, albums, artists, etc. |
SPOTIFY_GET_USER_S_PLAYLISTS | Get playlists for any user |
SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS | Get current user's playlists |
SPOTIFY_GET_PLAYLIST | Get detailed playlist info |
SPOTIFY_GET_PLAYLIST_ITEMS |
Powered byComposio
Weekly Installs
0
Repository
GitHub Stars
42.7K
First Seen
Jan 1, 1970
Security Audits
通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南
31,600 周安装
audiobooklimit | integer | No | Results to return (default: 20) |
offset | integer | No | Offset for pagination (default: 0) |
market | string | No | ISO 3166-1 alpha-2 country code |
include_external | string | No | Set to audio to include external content |
| string |
| No |
track,episode to include podcast episodes |
collaborative| boolean |
| No |
| Collaborative mode (only on non-public playlists) |
market | string | No | ISO country code |
additional_types | string | No | track,episode for podcast episodes |
{uri: 'spotify:track:...'}position_ms | integer | No | Start position in milliseconds |
device_id | string | No | Target device ID (defaults to active device) |
false| Playlist ownership | SPOTIFY_CHANGE_PLAYLIST_DETAILS only works on playlists owned by the authenticated user |
| Audiobook market restrictions | Audiobooks via search are only available in US, UK, Canada, Ireland, New Zealand, and Australia |
| Max 11000 playlists | Users are limited to approximately 11,000 playlists via SPOTIFY_CREATE_PLAYLIST |
| List tracks/episodes in a playlist |
SPOTIFY_CHANGE_PLAYLIST_DETAILS | Update playlist name, description, visibility |
SPOTIFY_CREATE_PLAYLIST | Create a new playlist |
SPOTIFY_ADD_ITEMS_TO_PLAYLIST | Add tracks/episodes to a playlist |
SPOTIFY_GET_TRACK | Get track details by ID |
SPOTIFY_GET_ALBUM | Get album details by ID |
SPOTIFY_START_RESUME_PLAYBACK | Start or resume playback on a device |