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
6

Документация

tidal-cli

tidal-cli — Control Tidal from your terminal

npm CI smithery badge License Node

О проекте

tidal-cli объединяет Tidal API v2 в единый инструмент командной строки. Ищите в каталоге, управляйте плейлистами, изучайте исполнителей, воспроизводите треки и работайте с медиатекой — не открывая браузер. Каждая команда поддерживает вывод в формате --json, что делает tidal-cli основой для автоматизации с помощью LLM-агентов через OpenClaw.

Возможности

  • Поиск исполнителей, альбомов, треков, видео, плейлистов и подсказок автодополнения
  • Исполнители — информация, лучшие треки, дискография, похожие исполнители, радио
  • Альбомы — детали, поиск по штрихкоду
  • Треки — информация, похожие треки, поиск по ISRC, радио
  • Плейлисты — полный CRUD, добавление/удаление треков, переупорядочивание, добавление целых альбомов
  • Медиатека — избранное для исполнителей, альбомов, треков, видео, плейлистов
  • Воспроизведение — информация о потоке, прямые URL, локальное воспроизведение через DASH
  • Рекомендации — персональные миксы (Daily, Discovery, New Release, Offline) с детализацией элементов микса
  • История — недавно добавленные треки, альбомы, исполнители; история поиска (список, удаление, очистка)
  • Отложенное — сохранение элементов в отдельной очереди, независимой от основной медиатеки
  • Поделиться — генерация публичных ссылок для треков и альбомов
  • Вывод в 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.