Tidal

officiel

Recherchez, parcourez et gérez votre bibliothèque musicale Tidal avec l'IA. Découvrez des artistes, albums et morceaux. Créez et gérez des playlists. Ajoutez des favoris à votre bibliothèque. Obtenez des recommandations personnalisées. 32 outils alimentés par l'API officielle Tidal avec authentification OAuth.

GitHub
7

Que pouvez-vous faire avec Tidal MCP ?

  • Rechercher dans le catalogue Tidal — Trouver des artistes, albums, morceaux, vidéos ou playlists avec search, plus l'autocomplétion avec search suggest.
  • Gérer les playlists — Créer, renommer, supprimer et réorganiser des playlists, ou ajouter/supprimer des morceaux individuels et des albums entiers via les commandes playlist.
  • Contrôler votre bibliothèque — Ajouter ou supprimer des artistes, albums, morceaux, vidéos et playlists favoris avec library add et library remove.
  • Obtenir des recommandations personnalisées — Parcourir les mixes Quotidien, Découverte, Nouveautés et Hors ligne avec recommend, puis explorer les éléments du mix avec mix items.
  • Consulter les détails et le contenu connexe — Récupérer les infos d'un artiste, ses meilleurs morceaux, des artistes similaires, les détails d'un album, les infos d'un morceau, des morceaux similaires et la radio via les commandes artist, album et track.
  • Jouer et partager de la musique — Obtenir les infos de streaming ou les URLs de lecture directe avec playback, et générer des liens de partage publics pour les morceaux et albums avec share.

Documentation

tidal-cli

tidal-cli — Control Tidal from your terminal

npm CI smithery badge License Node

À propos

tidal-cli encapsule l'API Tidal v2 dans un seul outil en ligne de commande. Parcourez le catalogue, gérez vos playlists, explorez des artistes, écoutez des morceaux et gérez votre bibliothèque — le tout sans ouvrir de navigateur. Chaque commande prend en charge la sortie --json, ce qui en fait la colonne vertébrale de l'automatisation par agents LLM via OpenClaw.

Fonctionnalités

  • Recherche d'artistes, albums, morceaux, vidéos, playlists et suggestions d'autocomplétion
  • Artistes — informations, meilleurs titres, discographie, artistes similaires, radio
  • Albums — détails, recherche par code-barres
  • Morceaux — informations, titres similaires, recherche par ISRC, radio
  • Playlists — CRUD complet, ajout/suppression de titres, réorganisation, ajout d'albums entiers
  • Bibliothèque — favoris pour artistes, albums, morceaux, vidéos, playlists
  • Lecture — informations de flux, URLs directes, lecture locale via DASH
  • Recommandations — mix personnalisés (Quotidien, Découvertes, Nouveautés, Hors-ligne) avec exploration détaillée des éléments du mix
  • Historique — titres, albums, artistes récemment ajoutés ; historique de recherche (lister, supprimer, effacer)
  • À écouter plus tard — marquez des éléments dans une file d'attente séparée de votre bibliothèque principale
  • Partage — générez des liens de partage publics pour les morceaux et les albums
  • Sortie JSON sur chaque commande pour les scripts et l'utilisation par agents

Installation

npm install -g @lucaperret/tidal-cli

Prérequis

  • Node.js >= 20
  • Un compte Tidal

Démarrage rapide

# 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

Utilisation

Recherche

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"

Artiste

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

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>

Playlists

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>

Bibliothèque

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>

Découverte & Historique

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

À écouter plus tard & Partage

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>

Lecture

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

Options de qualité : LOW, HIGH, LOSSLESS, HI_RES.

Sortie JSON

Ajoutez --json avant toute sous-commande :

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

Serveur MCP (Intégration Claude)

tidal-cli est disponible en tant que serveur MCP distant pour Claude Desktop, Smithery et tout client compatible MCP.

Connexion dans Claude Desktop :

  1. Paramètres → Connecteurs → Ajouter un connecteur personnalisé
  2. Saisissez : https://tidal-cli.lucaperret.ch/api/mcp
  3. Cliquez sur « Connecter » → connectez-vous à Tidal → terminé

40 outils avec authentification OAuth, annotations de sécurité et 3 modèles de prompt.

Automatisation par agent

tidal-cli est également disponible en tant que compétence OpenClaw sur ClawHub. Installez-la pour votre agent IA :

clawhub install tidal-cli

Après tidal-cli auth, les agents peuvent exécuter des commandes de manière non interactive avec des jetons à renouvellement automatique.

Exemples de prompts pour votre agent IA

  • « Crée une playlist avec les meilleurs titres de l'album Discovery de Daft Punk »
  • « Trouve des artistes similaires à Massive Attack et ajoute leurs meilleurs titres à ma bibliothèque »
  • « Quelles sont mes playlists ? Ajoute le nouvel album de LCD Soundsystem à la première »
  • « Joue-moi quelque chose de Boards of Canada »
  • « Construis une playlist rock indé des années 2000 avec The Strokes, Arctic Monkeys et Interpol »

Modèles de script

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

Développement

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

Exécution des tests

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

143 tests couvrant la recherche, les playlists, les artistes, les morceaux, les albums, la bibliothèque, les recommandations, les mix, la liste à écouter plus tard, le partage, l'historique de recherche, l'authentification et la session.

Licence

tidal-cli est sous licence MIT. Voir le fichier LICENSE pour plus de détails.