Tidal MCP Server

tidal-cli

Giới thiệu

tidal-cli gói gọn Tidal API v2 thành một công cụ dòng lệnh duy nhất. Tìm kiếm danh mục, quản lý playlist, khám phá nghệ sĩ, phát bản nhạc và xử lý thư viện của bạn — tất cả đều không cần mở trình duyệt. Mọi lệnh đều hỗ trợ đầu ra --json, biến nó thành xương sống cho tự động hóa tác nhân LLM thông qua OpenClaw.

Tính năng

• Tìm kiếm nghệ sĩ, album, bản nhạc, video, playlist và gợi ý tự động hoàn thành
• Nghệ sĩ — thông tin, bản nhạc hàng đầu, danh sách đĩa nhạc, nghệ sĩ tương tự, radio
• Album — chi tiết, tra cứu mã vạch
• Bản nhạc — thông tin, bản nhạc tương tự, tra cứu ISRC, radio
• Playlist — CRUD đầy đủ, thêm/xóa bản nhạc, sắp xếp lại, thêm toàn bộ album
• Thư viện — mục yêu thích cho nghệ sĩ, album, bản nhạc, video, playlist
• Phát lại — thông tin luồng, URL trực tiếp, phát cục bộ qua DASH
• Đề xuất — các bản phối cá nhân hóa (Hàng ngày, Khám phá, Phát hành mới, Ngoại tuyến) với khả năng đi sâu vào các mục trong bản phối
• Lịch sử — bản nhạc, album, nghệ sĩ đã thêm gần đây; lịch sử tìm kiếm (liệt kê, xóa, xóa tất cả)
• Lưu để xem sau — đánh dấu các mục trong một hàng đợi riêng biệt với thư viện chính
• Chia sẻ — tạo liên kết chia sẻ công khai cho bản nhạc và album
• Đầu ra JSON trên mọi lệnh để viết kịch bản và sử dụng cho tác nhân

Cài đặt

npm install -g @lucaperret/tidal-cli

Yêu cầu

• Node.js >= 20
• Một tài khoản Tidal

Bắt đầu nhanh

# 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

Cách sử dụng

Tìm kiếm

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"

Nghệ sĩ

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>

Album & Bản nhạc

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>

Playlist

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>

Thư viện

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>

Khám phá & Lịch sử

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

Lưu để xem sau & Chia sẻ

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>

Phát lại

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

Tùy chọn chất lượng: LOW, HIGH, LOSSLESS, HI_RES.

Đầu ra JSON

Thêm --json trước bất kỳ lệnh con nào:

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

Máy chủ MCP (Tích hợp Claude)

tidal-cli có sẵn dưới dạng máy chủ MCP từ xa cho Claude Desktop, Smithery và bất kỳ máy khách tương thích MCP nào.

Kết nối trong Claude Desktop:

1. Cài đặt → Trình kết nối → Thêm trình kết nối tùy chỉnh
2. Nhập: https://tidal-cli.lucaperret.ch/api/mcp
3. Nhấp "Kết nối" → đăng nhập vào Tidal → hoàn tất

40 công cụ với xác thực OAuth, chú thích an toàn và 3 mẫu lời nhắc.

Tự động hóa tác nhân

tidal-cli cũng có sẵn dưới dạng kỹ năng OpenClaw trên ClawHub. Cài đặt nó cho tác nhân AI của bạn:

clawhub install tidal-cli

Sau tidal-cli auth, các tác nhân có thể chạy lệnh không tương tác với token tự động làm mới.

Ví dụ lời nhắc cho tác nhân AI của bạn

• "Tạo một playlist với các bản nhạc hay nhất từ album Discovery của Daft Punk"
• "Tìm nghệ sĩ tương tự Massive Attack và thêm bản nhạc hàng đầu của họ vào thư viện của tôi"
• "Playlist của tôi là gì? Thêm album mới của LCD Soundsystem vào playlist đầu tiên"
• "Phát cho tôi thứ gì đó của Boards of Canada"
• "Xây dựng một playlist indie rock thập niên 2000 với The Strokes, Arctic Monkeys và Interpol"

Mẫu kịch bản

# 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"

Phát triển

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

Chạy kiểm thử

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

143 bài kiểm thử bao gồm tìm kiếm, playlist, nghệ sĩ, bản nhạc, album, thư viện, đề xuất, bản phối, lưu để xem sau, chia sẻ, lịch sử tìm kiếm, xác thực và phiên.

Giấy phép

tidal-cli được cấp phép theo Giấy phép MIT. Xem tệp LICENSE để biết chi tiết.