Spotify 오토메이션

Spotify Automation

Spotify 작업 자동화 — 재생 목록 관리, 음악 카탈로그 검색, 재생 제어, 앨범 및 트랙 탐색, 사용자 프로필 접근 — 모두 Composio MCP 통합을 통해 조정됩니다.

툴킷 문서: composio.dev/toolkits/spotify

---

설정

1. https://rube.app/mcp에서 Composio MCP 서버를 통해 Spotify 계정을 연결하세요.
2. 활성 연결이 없으면 에이전트가 인증 링크를 제공합니다.
3. 연결이 완료되면 모든 SPOTIFY_* 도구를 사용할 수 있습니다.
4. 참고: 일부 기능(재생 제어)은 Spotify Premium 구독이 필요합니다.

---

핵심 워크플로우

1. 현재 사용자 프로필 가져오기

인증된 Spotify 사용자의 포괄적인 프로필 정보를 검색합니다.

도구: SPOTIFY_GET_CURRENT_USER_S_PROFILE

필요한 매개변수 없음.
반환: 표시 이름, 이메일, 국가, 구독 수준(프리미엄/무료),
명시적 콘텐츠 설정, 프로필 이미지, 팔로워 수, Spotify URI.
필요한 범위: user-read-private, user-read-email.

---

2. Spotify 카탈로그 검색

키워드로 앨범, 아티스트, 재생 목록, 트랙, 쇼, 에피소드 또는 오디오북을 찾습니다.

도구: SPOTIFY_SEARCH_FOR_ITEM

매개변수	유형	필수	설명
q	문자열	예	검색어 키워드
type	배열	예	항목 유형: album, artist, playlist, track, show, episode, audiobook
limit	정수	아니요	반환할 결과 수(기본값: 20)
offset	정수	아니요	페이지네이션 오프셋(기본값: 0)
market	문자열	아니요	ISO 3166-1 알파-2 국가 코드
include_external	문자열	아니요	외부 콘텐츠 포함 시 audio로 설정

참고: 오디오북은 미국, 영국, 캐나다, 아일랜드, 뉴질랜드, 호주에서만 사용 가능합니다.

---

3. 재생 목록 관리

재생 목록을 탐색, 생성, 수정 및 채웁니다.

사용자의 재생 목록 가져오기:

도구: SPOTIFY_GET_USER_S_PLAYLISTS

매개변수	유형	필수	설명
user_id	문자열	예	Spotify 사용자 ID
limit	정수	아니요	최대 재생 목록 수, 1-50(기본값: 20)
offset	정수	아니요	페이지네이션 오프셋, 0-100000(기본값: 0)

현재 사용자의 재생 목록 가져오기:

도구: SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS

매개변수	유형	필수	설명
limit	정수	아니요	최대 재생 목록 수, 1-50(기본값: 20)
offset	정수	아니요	페이지네이션 오프셋, 0-100000(기본값: 0)

재생 목록 세부 정보 가져오기:

도구: SPOTIFY_GET_PLAYLIST

매개변수	유형	필수	설명
playlist_id	문자열	예	Spotify 재생 목록 ID(예: 3cEYpjA9oz9GiPac4AsH4n)
fields	문자열	아니요	쉼표로 구분된 필드 필터(응답 크기 축소)
market	문자열	아니요	시장별 콘텐츠를 위한 ISO 국가 코드
additional_types	문자열	아니요	팟캐스트 에피소드 포함 시 track,episode

재생 목록 세부 정보 업데이트:

도구: SPOTIFY_CHANGE_PLAYLIST_DETAILS

매개변수	유형	필수	설명
playlist_id	문자열	예	재생 목록 ID(현재 사용자가 소유해야 함)
name	문자열	아니요	새 재생 목록 이름
description	문자열	아니요	새 재생 목록 설명
public	부울	아니요	공개/비공개 전환
collaborative	부울	아니요	협업 모드(비공개 재생 목록에서만 가능)

---

4. 재생 목록 항목 탐색 및 트랙 추가

재생 목록의 트랙을 확인하고 새 항목을 추가합니다.

도구: SPOTIFY_GET_PLAYLIST_ITEMS

매개변수	유형	필수	설명
playlist_id	문자열	예	Spotify 재생 목록 ID
limit	정수	아니요	페이지당 항목 수, 1-50(기본값: 20)
offset	정수	아니요	페이지네이션 오프셋(기본값: 0)
fields	문자열	아니요	필드 필터(예: items(track(name,id)))
market	문자열	아니요	ISO 국가 코드
additional_types	문자열	아니요	팟캐스트 에피소드 포함 시 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	문자열	아니요	앨범, 아티스트 또는 재생 목록의 Spotify URI(uris와 함께 사용 불가)
uris	배열	아니요	재생할 트랙 URI 목록(context_uri와 함께 사용 불가)
offset	객체	아니요	시작 위치: {position: 5} 또는 {uri: 'spotify:track:...'}
position_ms	정수	아니요	시작 위치(밀리초)
device_id	문자열	아니요	대상 기기 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는 인증된 사용자가 소유한 재생 목록에서만 작동합니다.
오디오북 시장 제한	검색을 통한 오디오북은 미국, 영국, 캐나다, 아일랜드, 뉴질랜드, 호주에서만 사용 가능합니다.
최대 11,000개 재생 목록	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 제공