Spotify

使用方法

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