Tidal

resmi

Cari, jelajahi, dan kelola perpustakaan musik Tidal Anda dengan AI. Temukan artis, album, dan trek. Buat dan kurasi daftar putar. Tambahkan favorit ke perpustakaan Anda. Dapatkan rekomendasi yang dipersonalisasi. 32 alat yang didukung oleh API Tidal resmi dengan autentikasi OAuth.

GitHub
9

Apa yang bisa Anda lakukan dengan Tidal MCP?

  • Cari katalog Tidal — Temukan artis, album, trek, video, atau daftar putar menggunakan search, plus pelengkapan otomatis dengan search suggest.
  • Kelola daftar putar — Buat, ganti nama, hapus, dan urutkan ulang daftar putar, atau tambah/hapus trek individu dan seluruh album melalui perintah playlist.
  • Kontrol perpustakaan Anda — Tambah atau hapus artis, album, trek, video, dan daftar putar favorit dengan library add dan library remove.
  • Dapatkan rekomendasi yang dipersonalisasi — Jelajahi campuran Harian, Discovery, Rilis Baru, dan Offline dengan recommend, lalu gali item campuran dengan mix items.
  • Cari detail dan konten terkait — Ambil info artis, trek teratas, artis serupa, detail album, info trek, trek serupa, dan radio melalui perintah artist, album, dan track.
  • Putar dan bagikan musik — Dapatkan info streaming atau URL pemutaran langsung dengan playback, dan buat tautan berbagi publik untuk trek dan album menggunakan share.

Dokumentasi

tidal-cli

tidal-cli — Control Tidal from your terminal

npm CI smithery badge License Node

Tentang

tidal-cli membungkus Tidal API v2 menjadi satu alat baris perintah. Cari katalog, kelola daftar putar, jelajahi artis, putar trek, dan atur pustaka Anda — semuanya tanpa membuka peramban. Setiap perintah mendukung keluaran --json, menjadikannya tulang punggung untuk otomatisasi agen LLM melalui OpenClaw.

Fitur

  • Cari artis, album, trek, video, daftar putar, dan saran pelengkapan otomatis
  • Artis — info, trek teratas, diskografi, artis serupa, radio
  • Album — detail, pencarian kode batang
  • Trek — info, trek serupa, pencarian ISRC, radio
  • Daftar Putar — CRUD lengkap, tambah/hapus trek, susun ulang, tambah seluruh album
  • Pustaka — favorit untuk artis, album, trek, video, daftar putar
  • Pemutaran — info streaming, URL langsung, pemutaran lokal melalui DASH
  • Rekomendasi — campuran yang dipersonalisasi (Harian, Penemuan, Rilisan Baru, Offline) dengan penelusuran ke item campuran
  • Riwayat — trek, album, artis yang baru ditambahkan; riwayat pencarian (daftar, hapus, bersihkan)
  • Simpan untuk Nanti — tandai item dalam antrean terpisah dari pustaka utama Anda
  • Berbagi — buat tautan berbagi publik untuk trek dan album
  • Keluaran JSON pada setiap perintah untuk skrip dan penggunaan agen

Instalasi

npm install -g @lucaperret/tidal-cli

Persyaratan

  • Node.js >= 20
  • Akun Tidal

Mulai Cepat

# 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

Penggunaan

Pencarian

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"

Artis

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 & Trek

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>

Daftar Putar

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>

Pustaka

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>

Penemuan & Riwayat

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

Simpan untuk Nanti & Berbagi

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>

Pemutaran

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

Opsi kualitas: LOW, HIGH, LOSSLESS, HI_RES.

Keluaran JSON

Tambahkan --json sebelum subperintah apa pun:

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

Server MCP (Integrasi Claude)

tidal-cli tersedia sebagai server MCP jarak jauh untuk Claude Desktop, Smithery, dan klien yang kompatibel dengan MCP.

Hubungkan di Claude Desktop:

  1. Pengaturan → Konektor → Tambah konektor kustom
  2. Masukkan: https://tidal-cli.lucaperret.ch/api/mcp
  3. Klik "Hubungkan" → masuk ke Tidal → selesai

40 alat dengan autentikasi OAuth, anotasi keamanan, dan 3 templat prompt.

Otomatisasi Agen

tidal-cli juga tersedia sebagai keterampilan OpenClaw di ClawHub. Instal untuk agen AI Anda:

clawhub install tidal-cli

Setelah tidal-cli auth, agen dapat menjalankan perintah secara non-interaktif dengan token yang diperbarui otomatis.

Contoh prompt untuk agen AI Anda

  • "Buat daftar putar dengan trek terbaik dari album Discovery Daft Punk"
  • "Temukan artis yang mirip dengan Massive Attack dan tambahkan trek teratas mereka ke pustaka saya"
  • "Apa daftar putar saya? Tambahkan album baru LCD Soundsystem ke daftar putar pertama"
  • "Putarkan sesuatu dari Boards of Canada"
  • "Bangun daftar putar indie rock 2000-an dengan The Strokes, Arctic Monkeys, dan Interpol"

Pola skrip

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

Pengembangan

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

Menjalankan Pengujian

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

143 pengujian mencakup pencarian, daftar putar, artis, trek, album, pustaka, rekomendasi, campuran, simpan-untuk-nanti, berbagi, riwayat pencarian, autentikasi, dan sesi.

Lisensi

tidal-cli dilisensikan di bawah Lisensi MIT. Lihat berkas LICENSE untuk detailnya.