Tidal MCP Server

tidal-cli

소개

tidal-cli는 Tidal API v2를 하나의 명령줄 도구로 감싼 것입니다. 브라우저를 열지 않고도 카탈로그 검색, 재생목록 관리, 아티스트 탐색, 트랙 재생, 라이브러리 관리까지 모두 가능합니다. 모든 명령은 --json 출력을 지원하므로, OpenClaw를 통한 LLM 에이전트 자동화의 핵심 기반이 됩니다.

기능

• 검색 — 아티스트, 앨범, 트랙, 비디오, 재생목록 및 자동완성 제안
• 아티스트 — 정보, 인기 트랙, 디스코그래피, 유사 아티스트, 라디오
• 앨범 — 상세 정보, 바코드 조회
• 트랙 — 정보, 유사 트랙, ISRC 조회, 라디오
• 재생목록 — 전체 CRUD, 트랙 추가/제거, 순서 변경, 앨범 전체 추가
• 라이브러리 — 아티스트, 앨범, 트랙, 비디오, 재생목록 즐겨찾기
• 재생 — 스트림 정보, 직접 URL, DASH를 통한 로컬 재생
• 추천 — 개인 맞춤 믹스 (데일리, 디스커버리, 신규 발매, 오프라인) 및 믹스 항목 상세 탐색
• 기록 — 최근 추가된 트랙, 앨범, 아티스트; 검색 기록 (목록, 삭제, 전체 삭제)
• 나중에 듣기 — 메인 라이브러리와 별도로 항목을 북마크
• 공유 — 트랙 및 앨범의 공개 공유 링크 생성
• JSON 출력 — 스크립팅 및 에이전트 활용을 위해 모든 명령에서 지원

설치

npm install -g @lucaperret/tidal-cli

요구 사항

• Node.js >= 20
• Tidal 계정

빠른 시작

# Sign in once — opens your browser
tidal-cli auth

# Search for a track
tidal-cli search track "Around the World"

# Get artist details
tidal-cli artist info 8992

# Play a track
tidal-cli playback play 5756235

사용법

검색

tidal-cli search artist "Gorillaz"
tidal-cli search album "Mezzanine"
tidal-cli search track "Teardrop"
tidal-cli search video "Stylo"
tidal-cli search playlist "Electronic"
tidal-cli search suggest "daft punk"
tidal-cli search editorial "indie rock"

아티스트

tidal-cli artist info <id>
tidal-cli artist tracks <id>
tidal-cli artist albums <id>
tidal-cli artist similar <id>
tidal-cli artist radio <id>

앨범 및 트랙

tidal-cli album info <id>
tidal-cli album barcode <ean>
tidal-cli track info <id>
tidal-cli track similar <id>
tidal-cli track isrc <isrc>
tidal-cli track radio <id>

재생목록

tidal-cli playlist list
tidal-cli playlist create --name "Late Night Electronic"
tidal-cli playlist add-track --playlist-id <id> --track-id <id>
tidal-cli playlist add-album --playlist-id <id> --album-id <id>
tidal-cli playlist remove-track --playlist-id <id> --track-id <id>
tidal-cli playlist move-track --playlist-id <id> --track-id <id> --before <itemId>
tidal-cli playlist rename --playlist-id <id> --name "New Name"
tidal-cli playlist set-description --playlist-id <id> --desc "Updated description"
tidal-cli playlist delete --playlist-id <id>

라이브러리

tidal-cli library add --track-id <id>
tidal-cli library add --artist-id <id>
tidal-cli library add --album-id <id>
tidal-cli library add --video-id <id>
tidal-cli library remove --track-id <id>
tidal-cli library favorite-playlists
tidal-cli library add-playlist --playlist-id <id>
tidal-cli library remove-playlist --playlist-id <id>

발견 및 기록

tidal-cli recommend                              # all mix categories
tidal-cli recommend --type daily                 # daily | discovery | new-release | offline
tidal-cli mix items <mix-id> --type daily        # tracks inside a specific mix
tidal-cli history tracks
tidal-cli history albums
tidal-cli history artists
tidal-cli search history                         # your recent searches
tidal-cli search history-delete <entry-id>
tidal-cli search history-clear
tidal-cli user profile

나중에 듣기 및 공유

tidal-cli saved list
tidal-cli saved add --type tracks --id <id>      # tracks | albums | artists | playlists | videos
tidal-cli saved remove --type albums --id <id>
tidal-cli share track <id>                       # creates a public share link
tidal-cli share album <id>

재생

tidal-cli playback play <id>
tidal-cli playback play <id> --quality LOSSLESS
tidal-cli playback info <id>
tidal-cli playback url <id>

음질 옵션: LOW, HIGH, LOSSLESS, HI_RES.

JSON 출력

하위 명령 앞에 --json을 추가하세요:

tidal-cli --json search track "Around the World"
tidal-cli --json playlist list
tidal-cli --json artist similar 8992

MCP 서버 (Claude 통합)

tidal-cli는 Claude Desktop, Smithery 및 모든 MCP 호환 클라이언트를 위한 원격 MCP 서버로 사용할 수 있습니다.

Claude Desktop에서 연결하기:

1. 설정 → 커넥터 → 사용자 정의 커넥터 추가
2. 입력: https://tidal-cli.lucaperret.ch/api/mcp
3. "연결" 클릭 → Tidal에 로그인 → 완료

OAuth 인증, 안전 주석, 3개의 프롬프트 템플릿을 갖춘 40개의 도구.

에이전트 자동화

tidal-cli는 ClawHub에서 OpenClaw 스킬로도 제공됩니다. AI 에이전트에 설치하세요:

clawhub install tidal-cli

tidal-cli auth 이후, 에이전트는 자동 갱신 토큰으로 비대화형 명령을 실행할 수 있습니다.

AI 에이전트를 위한 프롬프트 예시

• "Daft Punk의 Discovery 앨범에서 최고의 트랙으로 재생목록을 만들어 줘"
• "Massive Attack과 비슷한 아티스트를 찾아서 그들의 인기 트랙을 내 라이브러리에 추가해 줘"
• "내 재생목록이 뭐야? 새로운 LCD Soundsystem 앨범을 첫 번째 재생목록에 추가해 줘"
• "Boards of Canada 노래 좀 틀어 줘"
• "The Strokes, Arctic Monkeys, Interpol로 2000년대 인디 록 재생목록을 만들어 줘"

스크립팅 패턴

# Search then act
TRACK=$(tidal-cli --json search track "Around the World" | jq -r '.[0].id')
tidal-cli playlist add-track --playlist-id <id> --track-id "$TRACK"

# Discovery: artist → similar → top tracks → playlist
ARTIST=$(tidal-cli --json search artist "Boards of Canada" | jq -r '.[0].id')
SIMILAR=$(tidal-cli --json artist similar "$ARTIST" | jq -r '.[0].id')
TRACK=$(tidal-cli --json artist tracks "$SIMILAR" | jq -r '.[0].id')
tidal-cli playlist add-track --playlist-id <id> --track-id "$TRACK"

개발

git clone https://github.com/lucaperret/tidal-cli.git
cd tidal-cli
npm install
npm run build
npm test

테스트 실행

npm test           # run once
npm run test:watch # watch mode

검색, 재생목록, 아티스트, 트랙, 앨범, 라이브러리, 추천, 믹스, 나중에 듣기, 공유, 검색 기록, 인증, 세션을 다루는 143개의 테스트.

라이선스

tidal-cli는 MIT 라이선스에 따라 제공됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.