---
title: Spotify
description: 音楽を検索し、プレイリストを管理し、再生をコントロールし、ライブラリにアクセスする
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="spotify"
  color="#000000"
/>

## 使用方法

Spotifyをワークフローに統合しましょう。トラック、アルバム、アーティスト、プレイリストを検索できます。プレイリストの管理、ライブラリへのアクセス、再生のコントロール、ポッドキャストやオーディオブックの閲覧ができます。

## ツール

### `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"\) |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tracks` | array | 一致するトラックのリスト |

### `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_get_tracks`

IDによって複数のSpotifyトラックに関する詳細情報を取得します（最大50件）。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `trackIds` | string | はい | カンマ区切りのSpotifyトラックIDリスト（最大50件） |
| `market` | string | いいえ | トラックの利用可能性を確認するためのISO 3166-1 alpha-2国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tracks` | array | トラックのリスト |

### `spotify_get_album`

IDによってSpotifyアルバムに関する詳細情報（トラックリストを含む）を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `albumId` | string | はい | アルバムのSpotify ID |
| `market` | string | いいえ | トラックの利用可能性を確認するためのISO 3166-1 alpha-2国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `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_get_albums`

複数のアルバムの詳細をIDで取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `albumIds` | string | はい | カンマ区切りのアルバムID（最大20個） |
| `market` | string | いいえ | マーケット用のISO国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `albums` | json | アルバムのリスト |

### `spotify_get_album_tracks`

アルバムからトラックを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `albumId` | string | はい | Spotify アルバム ID |
| `limit` | number | いいえ | 返すトラック数（1-50） |
| `offset` | number | いいえ | 返す最初のトラックのインデックス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tracks` | json | トラックのリスト |
| `total` | number | トラックの総数 |
| `next` | string | 次のページのURL |

### `spotify_get_saved_albums`

ユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返すアルバム数（1-50） |
| `offset` | number | いいえ | 返す最初のアルバムのインデックス |
| `market` | string | いいえ | マーケット用のISO国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `albums` | json | 保存されたアルバムのリスト |
| `total` | number | 保存されたアルバムの総数 |
| `next` | string | 次のページのURL |

### `spotify_save_albums`

ユーザーにアルバムを保存する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `albumIds` | string | はい | カンマ区切りのアルバムID（最大20） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | アルバムが保存されたかどうか |

### `spotify_remove_saved_albums`

ユーザーからアルバムを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `albumIds` | string | はい | カンマ区切りのアルバムID（最大20） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | アルバムが削除されたかどうか |

### `spotify_check_saved_albums`

アルバムがライブラリに保存されているかを確認します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `albumIds` | string | はい | カンマ区切りのアルバムID（最大20個） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | json | 各アルバムに対するブール値の配列 |

### `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_get_artists`

複数のアーティストの詳細をIDで取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `artistIds` | string | はい | カンマ区切りのアーティストID（最大50個） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `artists` | json | アーティストのリスト |

### `spotify_get_artist_albums`

Spotifyでアーティストのアルバムを取得します。アルバムタイプでフィルタリングできます。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `artistId` | string | はい | アーティストのSpotify ID |
| `include_groups` | string | いいえ | アルバムタイプでフィルタリング: album, single, appears_on, compilation （カンマ区切り） |
| `limit` | number | いいえ | 返すアルバムの最大数（1-50） |
| `offset` | number | いいえ | 返す最初のアルバムのインデックス |
| `market` | string | いいえ | ISO 3166-1 alpha-2国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `albums` | array | アーティスト |

### `spotify_get_artist_top_tracks`

Spotifyでアーティストの最も人気のある上位10曲を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `artistId` | string | はい | アーティストのSpotify ID |
| `market` | string | いいえ | ISO 3166-1 alpha-2国コード（このエンドポイントでは必須） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tracks` | array | アーティスト |

### `spotify_follow_artists`

一人または複数のアーティストをフォローします。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `artistIds` | string | はい | フォローするアーティストIDをカンマ区切りで指定（最大50） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | アーティストのフォローが成功したかどうか |

### `spotify_unfollow_artists`

一人または複数のアーティストのフォローを解除します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `artistIds` | string | はい | フォロー解除するアーティストIDをカンマ区切りで指定（最大50） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | アーティストのフォロー解除が成功したかどうか |

### `spotify_get_followed_artists`

ユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返すアーティストの数（1-50） |
| `after` | string | いいえ | ページネーション用カーソル（前回リクエストの最後のアーティストID） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `artists` | json | フォロー中のアーティストのリスト |
| `total` | number | フォロー中のアーティストの総数 |
| `next` | string | 次ページ用カーソル |

### `spotify_check_following`

ユーザーがアーティストまたは他のユーザーをフォローしているかを確認します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `type` | string | はい | 確認するタイプ："artist"または"user" |
| `ids` | string | はい | アーティストまたはユーザーIDをカンマ区切りで指定（最大50） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | json | 各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_get_shows`

複数のポッドキャスト番組の詳細を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `showIds` | string | はい | カンマ区切りの番組ID（最大50） |
| `market` | string | いいえ | マーケット用のISO国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `shows` | json | 番組のリスト |

### `spotify_get_show_episodes`

ポッドキャスト番組からエピソードを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `showId` | string | はい | Spotify番組ID |
| `limit` | number | いいえ | 返すエピソード数（1-50） |
| `offset` | number | いいえ | 返す最初のエピソードのインデックス |
| `market` | string | いいえ | マーケット用のISO国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `episodes` | json | エピソードのリスト |
| `total` | number | 合計エピソード数 |
| `next` | string | 次のページのURL |

### `spotify_get_saved_shows`

ユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返す番組数（1-50） |
| `offset` | number | いいえ | 返す最初の番組のインデックス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `shows` | json | 保存された番組のリスト |
| `total` | number | 保存された番組の合計数 |
| `next` | string | 次のページのURL |

### `spotify_save_shows`

ポッドキャスト番組をユーザーに保存する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `showIds` | string | はい | カンマ区切りの番組ID（最大50） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 番組が保存されたかどうか |

### `spotify_remove_saved_shows`

ユーザーからポッドキャスト番組を削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `showIds` | string | はい | カンマ区切りの番組ID（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 番組が削除されたかどうか |

### `spotify_check_saved_shows`

ライブラリに番組が保存されているかを確認する。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `showIds` | string | はい | カンマ区切りの番組ID（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | json | 各番組に対するブール値の配列 |

### `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_get_episodes`

複数のポッドキャストエピソードの詳細を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `episodeIds` | string | はい | カンマ区切りのエピソードID（最大50件） |
| `market` | string | いいえ | 市場のISOカントリーコード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `episodes` | json | エピソードのリスト |

### `spotify_get_saved_episodes`

ユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返すエピソード数（1-50） |
| `offset` | number | いいえ | 返す最初のエピソードのインデックス |
| `market` | string | いいえ | 市場のISOカントリーコード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `episodes` | json | 保存されたエピソードのリスト |
| `total` | number | 保存されたエピソードの総数 |
| `next` | string | 次のページのURL |

### `spotify_save_episodes`

ポッドキャストエピソードをユーザーに保存する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `episodeIds` | string | はい | カンマ区切りのエピソードID（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | エピソードが保存されたかどうか |

### `spotify_remove_saved_episodes`

ユーザーからポッドキャストエピソードを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `episodeIds` | string | はい | カンマ区切りのエピソードID（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | エピソードが削除されたかどうか |

### `spotify_check_saved_episodes`

エピソードがライブラリに保存されているかを確認する。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `episodeIds` | string | はい | カンマ区切りのエピソードID（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | json | 各エピソードに対するブール値の配列 |

### `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_get_audiobooks`

複数のオーディオブックの詳細を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `audiobookIds` | string | はい | カンマ区切りのオーディオブックID（最大50個） |
| `market` | string | いいえ | マーケット用のISO国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `audiobooks` | json | オーディオブックのリスト |

### `spotify_get_audiobook_chapters`

オーディオブックからチャプターを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `audiobookId` | string | はい | SpotifyオーディオブックID |
| `limit` | number | いいえ | 返すチャプターの数（1-50） |
| `offset` | number | いいえ | 返す最初のチャプターのインデックス |
| `market` | string | いいえ | マーケット用のISO国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `chapters` | json | チャプターのリスト |
| `total` | number | チャプターの総数 |
| `next` | string | 次のページのURL |

### `spotify_get_saved_audiobooks`

ユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返すオーディオブックの数（1-50） |
| `offset` | number | いいえ | 返す最初のオーディオブックのインデックス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `audiobooks` | json | 保存されたオーディオブックのリスト |
| `total` | number | 保存されたオーディオブックの合計数 |
| `next` | string | 次のページのURL |

### `spotify_save_audiobooks`

ユーザーにオーディオブックを保存する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `audiobookIds` | string | はい | カンマ区切りのオーディオブックID（最大50個） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | オーディオブックが保存されたかどうか |

### `spotify_remove_saved_audiobooks`

ユーザーからオーディオブックを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `audiobookIds` | string | はい | カンマ区切りのオーディオブックID（最大50個） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | オーディオブックが削除されたかどうか |

### `spotify_check_saved_audiobooks`

オーディオブックがライブラリに保存されているかを確認する。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `audiobookIds` | string | はい | カンマ区切りのオーディオブックID（最大50個） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | json | 各オーディオブックに対するブール値の配列 |

### `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_get_playlist_tracks`

Spotifyプレイリスト内のトラックを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | プレイリストのSpotify ID |
| `limit` | number | いいえ | 返すトラックの最大数（1-100） |
| `offset` | number | いいえ | 返す最初のトラックのインデックス |
| `market` | string | いいえ | トラックの利用可能性を確認するためのISO 3166-1 alpha-2国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tracks` | array | プレイリスト内のトラックのリスト |

### `spotify_get_playlist_cover`

プレイリストを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | Spotify プレイリスト ID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `images` | json | カバー画像のリスト |

### `spotify_get_user_playlists`

現在のユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返すプレイリストの最大数（1-50） |
| `offset` | number | いいえ | 返す最初のプレイリストのインデックス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `playlists` | array | ユーザー |

### `spotify_create_playlist`

現在のユーザー用に Spotify で新しいプレイリストを作成する。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `name` | string | はい | 新しいプレイリストの名前 |
| `description` | string | いいえ | プレイリストの説明 |
| `public` | boolean | いいえ | プレイリストを公開するかどうか |
| `collaborative` | boolean | いいえ | プレイリストをコラボレーティブにするかどうか（public を false にする必要があります） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `id` | string | Spotify プレイリスト ID |
| `name` | string | プレイリスト名 |
| `description` | string | プレイリストの説明 |
| `public` | boolean | プレイリストが公開されているかどうか |
| `collaborative` | boolean | コラボレーション可能かどうか |
| `snapshot_id` | string | プレイリストのスナップショット ID |
| `external_url` | string | Spotify URL |

### `spotify_update_playlist`

プレイリストを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | Spotify プレイリスト ID |
| `name` | string | いいえ | プレイリストの新しい名前 |
| `description` | string | いいえ | プレイリストの新しい説明 |
| `public` | boolean | いいえ | プレイリストを公開するかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 更新が成功したかどうか |

### `spotify_add_playlist_cover`

プレイリスト用のカスタムカバー画像をアップロードします。画像はJPEG形式で256KB未満である必要があります。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | Spotify プレイリスト ID |
| `imageBase64` | string | はい | Base64エンコードされたJPEG画像（最大256KB） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | アップロードが成功したかどうか |

### `spotify_add_tracks_to_playlist`

Spotifyプレイリストに1つ以上のトラックを追加します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | プレイリストのSpotify ID |
| `uris` | string | はい | カンマ区切りのSpotify URI（例："spotify:track:xxx,spotify:track:yyy"） |
| `position` | number | いいえ | トラックを挿入する位置（0ベース）。省略した場合、トラックは末尾に追加されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `snapshot_id` | string | 変更後の新しいプレイリストスナップショットID |

### `spotify_remove_tracks_from_playlist`

Spotifyプレイリストから1つ以上のトラックを削除します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | プレイリストのSpotify ID |
| `uris` | string | はい | 削除するカンマ区切りのSpotify URI（例："spotify:track:xxx,spotify:track:yyy"） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `snapshot_id` | string | 変更後の新しいプレイリストスナップショットID |

### `spotify_reorder_playlist_items`

プレイリスト内のトラックを別の位置に移動します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | SpotifyプレイリストID |
| `range_start` | number | はい | 並べ替えるアイテムの開始インデックス |
| `insert_before` | number | はい | アイテムを挿入する前のインデックス |
| `range_length` | number | いいえ | 並べ替えるアイテムの数 |
| `snapshot_id` | string | いいえ | 同時実行制御用のプレイリストスナップショットID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `snapshot_id` | string | 新しいプレイリストのスナップショットID |

### `spotify_replace_playlist_items`

プレイリスト内のすべての項目を新しいトラックに置き換えます。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | Spotify プレイリストID |
| `uris` | string | はい | カンマ区切りの Spotify URI（最大100個） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `snapshot_id` | string | 新しいプレイリストのスナップショットID |

### `spotify_follow_playlist`

プレイリストをフォロー（保存）します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | Spotify プレイリストID |
| `public` | boolean | いいえ | プレイリストを公開プレイリストに含めるかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | フォローが成功したかどうか |

### `spotify_unfollow_playlist`

プレイリストのフォローを解除（保存解除）します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | Spotify プレイリストID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | フォロー解除が成功したかどうか |

### `spotify_check_playlist_followers`

ユーザーがプレイリストをフォローしているかを確認します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `playlistId` | string | はい | Spotify プレイリスト ID |
| `userIds` | string | はい | 確認するユーザー ID（カンマ区切り、最大5件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | json | 各ユーザーに対するブール値の配列 |

### `spotify_get_current_user`

現在のユーザーを取得

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `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_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_get_top_tracks`

現在のユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `time_range` | string | いいえ | 時間範囲：short_term（約4週間）、medium_term（約6ヶ月）、long_term（数年） |
| `limit` | number | いいえ | 返すトラック数（1-50） |
| `offset` | number | いいえ | 返す最初のトラックのインデックス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tracks` | array | ユーザー |

### `spotify_get_top_artists`

現在のユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `time_range` | string | いいえ | 時間範囲：short_term（約4週間）、medium_term（約6ヶ月）、long_term（数年） |
| `limit` | number | いいえ | 返すアーティスト数（1-50） |
| `offset` | number | いいえ | 返す最初のアーティストのインデックス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `artists` | array | ユーザー |

### `spotify_get_saved_tracks`

現在のユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返すトラック数（1-50） |
| `offset` | number | いいえ | 返す最初のトラックのインデックス |
| `market` | string | いいえ | ISO 3166-1 alpha-2国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tracks` | array | ユーザー |

### `spotify_save_tracks`

現在のユーザーにトラックを保存する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `trackIds` | string | はい | 保存するSpotifyトラックIDをカンマ区切りで指定（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | トラックが正常に保存されたかどうか |

### `spotify_remove_saved_tracks`

ユーザーからトラックを削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `trackIds` | string | はい | 削除するトラックIDをカンマ区切りで指定（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | トラックが正常に削除されたかどうか |

### `spotify_check_saved_tracks`

1つ以上のトラックがユーザーに保存されているかを確認する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `trackIds` | string | はい | 確認するトラックIDをカンマ区切りで指定（最大50件） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `results` | json | 保存状態を含むトラックIDの配列 |
| `all_saved` | boolean | すべてのトラックが保存されているかどうか |
| `none_saved` | boolean | トラックが1つも保存されていないかどうか |

### `spotify_get_recently_played`

ユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `limit` | number | いいえ | 返すトラック数（1-50） |
| `after` | number | いいえ | ミリ秒単位のUnixタイムスタンプ。このカーソル以降のアイテムを返します。 |
| `before` | number | いいえ | ミリ秒単位のUnixタイムスタンプ。このカーソル以前のアイテムを返します。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `items` | array | 最近再生したトラック |

### `spotify_get_new_releases`

Spotifyで紹介されている新しいアルバムリリースのリストを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `country` | string | いいえ | ISO 3166-1 alpha-2国コード（例："US"、"GB"） |
| `limit` | number | いいえ | 返すリリース数（1-50） |
| `offset` | number | いいえ | 返す最初のリリースのインデックス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `albums` | json | 新しいリリースのリスト |
| `total` | number | 新しいリリースの総数 |
| `next` | string | 次のページのURL |

### `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_get_markets`

Spotifyが利用可能な市場のリストを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `markets` | json | ISO国コードのリスト |

### `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_get_currently_playing`

ユーザーを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `market` | string | いいえ | 市場のためのISO国コード |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `is_playing` | boolean | 再生がアクティブかどうか |
| `progress_ms` | number | トラック内の現在位置（ミリ秒） |
| `track` | json | 現在再生中のトラック |

### `spotify_get_devices`

ユーザーを取得

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `devices` | array | 利用可能な再生デバイス |

### `spotify_get_queue`

ユーザーを取得

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `currently_playing` | json | 現在再生中のトラック |
| `queue` | json | キュー内の次のトラック |

### `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_pause`

Spotifyでの再生を一時停止します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `device_id` | string | いいえ | 一時停止するデバイスID。提供されない場合、アクティブなデバイスを一時停止します。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 再生が一時停止されたかどうか |

### `spotify_skip_next`

Spotifyで次のトラックにスキップします。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `device_id` | string | いいえ | デバイスID。提供されない場合、アクティブなデバイスを使用します。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | スキップが成功したかどうか |

### `spotify_skip_previous`

Spotifyで前のトラックにスキップします。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `device_id` | string | いいえ | デバイスID。提供されない場合、アクティブなデバイスを使用します。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | スキップが成功したかどうか |

### `spotify_seek`

現在再生中のトラックの特定の位置にシークします。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `position_ms` | number | はい | シークする位置（ミリ秒） |
| `device_id` | string | いいえ | 対象デバイスID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | シークが成功したかどうか |

### `spotify_add_to_queue`

ユーザーにトラックを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `uri` | string | はい | 追加するトラックのSpotify URI（例："spotify:track:xxx"） |
| `device_id` | string | いいえ | デバイスID。提供されない場合、アクティブなデバイスを使用します。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | トラックがキューに追加されたかどうか |

### `spotify_set_volume`

Spotifyの再生音量を設定する。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `volume_percent` | number | はい | 音量レベル（0〜100） |
| `device_id` | string | いいえ | デバイスID。提供されない場合、アクティブなデバイスを使用します。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 音量が設定されたかどうか |

### `spotify_set_repeat`

再生のリピートモードを設定する。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `state` | string | はい | リピートモード: "off"、"track"、または "context" |
| `device_id` | string | いいえ | 対象とするデバイスID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | リピートモードが正常に設定されたかどうか |

### `spotify_set_shuffle`

シャッフルのオン・オフを切り替えます。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `state` | boolean | はい | シャッフルをオンにする場合はtrue、オフにする場合はfalse |
| `device_id` | string | いいえ | 対象とするデバイスID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | シャッフルが正常に設定されたかどうか |

### `spotify_transfer_playback`

再生を別のデバイスに転送します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `device_id` | string | はい | 再生を転送する先のデバイスID |
| `play` | boolean | いいえ | 新しいデバイスで再生を開始するかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 転送が成功したかどうか |

## 注意事項

- カテゴリー: `tools`
- タイプ: `spotify`
