Tidal MCP Server

tidal-cli

เกี่ยวกับ

tidal-cli ห่อหุ้ม Tidal API v2 ไว้ในเครื่องมือบรรทัดคำสั่งเดียว ค้นหาแคตตาล็อก จัดการเพลย์ลิสต์ สำรวจศิลปิน เล่นแทร็ก และจัดการคลังของคุณ — ทั้งหมดนี้โดยไม่ต้องเปิดเบราว์เซอร์ ทุกคำสั่งรองรับเอาต์พุต --json ทำให้เป็นแกนหลักสำหรับการทำงานอัตโนมัติของเอเจนต์ LLM ผ่าน OpenClaw

คุณสมบัติ

• ค้นหา ศิลปิน อัลบั้ม แทร็ก วิดีโอ เพลย์ลิสต์ และคำแนะนำการเติมอัตโนมัติ
• ศิลปิน — ข้อมูล, แทร็กยอดนิยม, ผลงานเพลง, ศิลปินที่คล้ายกัน, วิทยุ
• อัลบั้ม — รายละเอียด, การค้นหาด้วยบาร์โค้ด
• แทร็ก — ข้อมูล, แทร็กที่คล้ายกัน, การค้นหา 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 พร้อมใช้งานเป็นเซิร์ฟเวอร์ MCP ระยะไกลสำหรับ Claude Desktop, Smithery และไคลเอนต์ที่เข้ากันได้กับ MCP ใดๆ

เชื่อมต่อใน Claude Desktop:

1. การตั้งค่า → ตัวเชื่อมต่อ → เพิ่มตัวเชื่อมต่อแบบกำหนดเอง
2. ป้อน: https://tidal-cli.lucaperret.ch/api/mcp
3. คลิก "เชื่อมต่อ" → เข้าสู่ระบบ Tidal → เสร็จสิ้น

40 เครื่องมือพร้อมการรับรองความถูกต้อง OAuth, คำอธิบายประกอบความปลอดภัย และเทมเพลตพร้อมท์ 3 แบบ

การทำงานอัตโนมัติของเอเจนต์

tidal-cli ยังพร้อมใช้งานเป็นสกิล OpenClaw บน ClawHub ติดตั้งสำหรับเอเจนต์ AI ของคุณ:

clawhub install tidal-cli

หลังจาก tidal-cli auth เอเจนต์สามารถรันคำสั่งแบบไม่โต้ตอบด้วยโทเค็นที่รีเฟรชอัตโนมัติ

ตัวอย่างพร้อมท์สำหรับเอเจนต์ AI ของคุณ

• "สร้างเพลย์ลิสต์ด้วยแทร็กที่ดีที่สุดจากอัลบั้ม Discovery ของ Daft Punk"
• "ค้นหาศิลปินที่คล้ายกับ Massive Attack และเพิ่มแทร็กยอดนิยมของพวกเขาลงในคลังของฉัน"
• "เพลย์ลิสต์ของฉันมีอะไรบ้าง? เพิ่มอัลบั้มใหม่ของ LCD Soundsystem ลงในเพลย์ลิสต์แรก"
• "เล่นอะไรบางอย่างจาก Boards of Canada ให้ฉันฟัง"
• "สร้างเพลย์ลิสต์อินดี้ร็อกยุค 2000 ด้วย The Strokes, Arctic Monkeys และ Interpol"

รูปแบบการเขียนสคริปต์

# 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 ดูไฟล์ LICENSE สำหรับรายละเอียด