Tidal

официальный

Поиск, просмотр и управление вашей музыкальной библиотекой Tidal с помощью ИИ. Открывайте для себя исполнителей, альбомы и треки. Создавайте и редактируйте плейлисты. Добавляйте избранное в свою библиотеку. Получайте персонализированные рекомендации. 32 инструмента на основе официального API Tidal с аутентификацией OAuth.

GitHub
9

Что можно делать с Tidal MCP?

  • Поиск по каталогу Tidal — Находите исполнителей, альбомы, треки, видео или плейлисты с помощью search, а также автозаполнение через search suggest.
  • Управление плейлистами — Создавайте, переименовывайте, удаляйте и меняйте порядок плейлистов, а также добавляйте или удаляйте отдельные треки и целые альбомы с помощью команд playlist.
  • Управление библиотекой — Добавляйте или удаляйте избранных исполнителей, альбомы, треки, видео и плейлисты с помощью library add и library remove.
  • Получение персонализированных рекомендаций — Просматривайте подборки Daily, Discovery, New Release и Offline с помощью recommend, затем изучайте элементы подборок через mix items.
  • Просмотр подробностей и связанного контента — Получайте информацию об исполнителе, популярные треки, похожих исполнителей, детали альбома, информацию о треке, похожие треки и радио с помощью команд artist, album и track.
  • Воспроизведение и обмен музыкой — Получайте информацию о потоке или прямые URL-адреса для воспроизведения с помощью playback, а также создавайте публичные ссылки для обмена треками и альбомами через share.

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

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.