Tidal MCP Server

आधिकारिक

Search, browse, and manage your Tidal music library with AI. Discover artists, albums, and tracks. Create and curate playlists. Add favorites to your library. Get personalized recommendations. 32 tools powered by the official Tidal API with OAuth authentication.

GitHub

दस्तावेज़

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 में कनेक्ट करें:

सेटिंग्स → कनेक्टर्स → कस्टम कनेक्टर जोड़ें
दर्ज करें: https://tidal-cli.lucaperret.ch/api/mcp
"कनेक्ट करें" पर क्लिक करें → 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 फ़ाइल देखें।