Spotify Automation
Spotify の操作を自動化します — プレイリスト管理、音楽カタログの検索、再生の制御、アルバムやトラックの閲覧、ユーザープロファイルへのアクセス — すべて Composio MCP 統合を通じてオーケストレーションされます。
ツールキットドキュメント: composio.dev/toolkits/spotify
セットアップ
- Composio MCP サーバー (
https://rube.app/mcp) で Spotify アカウントを接続します - アクティブな接続がない場合、エージェントが認証リンクを要求します
- 接続が完了すると、すべての
SPOTIFY_*ツールが実行可能になります - 注意: 一部の機能（再生制御）には Spotify Premium サブスクリプションが必要です
コアワークフロー
1. 現在のユーザープロファイルを取得
認証された Spotify ユーザーの包括的なプロファイル情報を取得します。
ツール: SPOTIFY_GET_CURRENT_USER_S_PROFILE
パラメータ不要。
戻り値: 表示名、メールアドレス、国、サブスクリプションレベル（premium/free）、
明示的コンテンツ設定、プロフィール画像、フォロワー数、Spotify URI。
必要なスコープ: user-read-private、user-read-email。
2. Spotify カタログを検索
キーワードでアルバム、アーティスト、プレイリスト、トラック、番組、エピソード、またはオーディオブックを見つけます。
ツール: 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 に設定すると外部コンテンツを含める |
注意: オーディオブックは米国、英国、カナダ、アイルランド、ニュージーランド、オーストラリアでのみ利用可能です。
3. プレイリストを管理
プレイリストを閲覧、作成、変更、およびデータ投入します。
ユーザーのプレイリストを取得:
ツール: 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 | いいえ | コラボレーションモード（非公開プレイリストでのみ可能） |
4. プレイリストアイテムを閲覧 & トラックを追加
プレイリスト内のトラックを表示し、新しいアイテムを追加します。
ツール: SPOTIFY_GET_PLAYLIST_ITEMS
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
playlist_id | string | はい | Spotify プレイリスト ID |
limit | integer | いいえ | 1ページあたりのアイテム数、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 を使用してプレイリストにトラックまたはエピソードを追加します。
5. トラック & アルバムの詳細を取得
個々のトラックとアルバムのカタログ情報を取得します。
ツール: SPOTIFY_GET_TRACK -- Spotify ID で単一トラックの詳細を取得します。
ツール: SPOTIFY_GET_ALBUM -- トラックリスト、アーティスト情報、カバーアート、人気度を含む包括的なアルバムデータを取得します。
6. 再生を制御
ユーザーのアクティブデバイスで再生を開始、再開、または変更します。
ツール: 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 サブスクリプションと少なくとも1台のアクティブデバイス。
既知の落とし穴
| 落とし穴 | 詳細 |
|---|---|
| 再生には Premium が必要 | ユーザーが Spotify Premium を持っていない場合、SPOTIFY_START_RESUME_PLAYBACK は 403 を返します |
| アクティブデバイスが必要 | アクティブな Spotify デバイス（モバイル、デスクトップ、Web、スピーカー）がない場合、再生制御は 404 を返します |
| context_uri と uris は排他 | 同じ再生呼び出しで context_uri と uris の両方は使用できません |
| コラボレーションプレイリスト | collaborative は非公開プレイリスト（public が false）でのみ true に設定できます |
| プレイリストの所有権 | 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