Tidal

offiziell

Durchsuchen, browsen und verwalten Sie Ihre Tidal-Musikbibliothek mit KI. Entdecken Sie Künstler, Alben und Titel. Erstellen und kuratieren Sie Playlists. Fügen Sie Favoriten zu Ihrer Bibliothek hinzu. Erhalten Sie personalisierte Empfehlungen. 32 Tools, unterstützt durch die offizielle Tidal-API mit OAuth-Authentifizierung.

GitHub
9

Was kann man mit Tidal MCP machen?

  • Tidal-Katalog durchsuchen — Finden Sie Künstler, Alben, Titel, Videos oder Playlists mit search, plus Autovervollständigung mit search suggest.
  • Playlists verwalten — Erstellen, umbenennen, löschen und neu anordnen von Playlists, oder einzelne Titel und ganze Alben hinzufügen/entfernen mit playlist-Befehlen.
  • Ihre Bibliothek verwalten — Lieblingskünstler, Alben, Titel, Videos und Playlists hinzufügen oder entfernen mit library add und library remove.
  • Personalisierte Empfehlungen erhalten — Durchstöbern Sie Daily-, Discovery-, New-Release- und Offline-Mixe mit recommend, und tauchen Sie dann mit mix items in die Mix-Elemente ein.
  • Details und verwandte Inhalte nachschlagen — Rufen Sie Künstlerinformationen, Top-Titel, ähnliche Künstler, Albumdetails, Titelinformationen, ähnliche Titel und Radio ab mit artist-, album- und track-Befehlen.
  • Musik abspielen und teilen — Erhalten Sie Stream-Informationen oder direkte Wiedergabe-URLs mit playback, und generieren Sie öffentliche Freigabelinks für Titel und Alben mit share.

Dokumentation

tidal-cli

tidal-cli — Control Tidal from your terminal

npm CI smithery badge License Node

Überblick

tidal-cli verpackt die Tidal API v2 in ein einziges Kommandozeilen-Werkzeug. Durchsuche den Katalog, verwalte Playlists, erkunde Künstler, spiele Tracks ab und kümmere dich um deine Mediathek – alles ohne einen Browser zu öffnen. Jeder Befehl unterstützt --json-Ausgabe und bildet damit das Rückgrat für die Automatisierung durch LLM-Agenten über OpenClaw.

Funktionen

  • Suche nach Künstlern, Alben, Tracks, Videos, Playlists und Autovervollständigungs-Vorschlägen
  • Künstler — Infos, Top-Tracks, Diskografie, ähnliche Künstler, Radio
  • Alben — Details, Barcode-Suche
  • Tracks — Infos, ähnliche Tracks, ISRC-Suche, Radio
  • Playlists — vollständiges CRUD, Tracks hinzufügen/entfernen, neu anordnen, ganze Alben hinzufügen
  • Mediathek — Favoriten für Künstler, Alben, Tracks, Videos, Playlists
  • Wiedergabe — Stream-Infos, direkte URLs, lokale Wiedergabe via DASH
  • Empfehlungen — personalisierte Mixes (Daily, Discovery, New Release, Offline) mit Drill-down in Mix-Elemente
  • Verlauf — kürzlich hinzugefügte Tracks, Alben, Künstler; Suchverlauf (auflisten, löschen, leeren)
  • Für später speichern — Elemente in einer separaten Warteschlange außerhalb der Hauptmediathek vormerken
  • Teilen — öffentliche Teilen-Links für Tracks und Alben generieren
  • JSON-Ausgabe bei jedem Befehl für Skripting und Agenten-Nutzung

Installation

npm install -g @lucaperret/tidal-cli

Voraussetzungen

  • Node.js >= 20
  • Ein Tidal-Konto

Schnellstart

# 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

Verwendung

Suche

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"

Künstler

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

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>

Mediathek

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>

Entdeckung & Verlauf

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

Für später speichern & Teilen

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>

Wiedergabe

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

Qualitätsoptionen: LOW, HIGH, LOSSLESS, HI_RES.

JSON-Ausgabe

Füge --json vor jedem Unterbefehl hinzu:

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

MCP-Server (Claude-Integration)

tidal-cli ist als entfernter MCP-Server für Claude Desktop, Smithery und jeden MCP-kompatiblen Client verfügbar.

In Claude Desktop verbinden:

  1. Einstellungen → Verbindungen → Benutzerdefinierte Verbindung hinzufügen
  2. Eingeben: https://tidal-cli.lucaperret.ch/api/mcp
  3. Auf „Verbinden“ klicken → bei Tidal anmelden → fertig

40 Werkzeuge mit OAuth-Authentifizierung, Sicherheitsannotationen und 3 Prompt-Vorlagen.

Agenten-Automatisierung

tidal-cli ist auch als OpenClaw-Skill auf ClawHub verfügbar. Installiere ihn für deinen KI-Agenten:

clawhub install tidal-cli

Nach tidal-cli auth können Agenten Befehle nicht-interaktiv mit automatisch aktualisierten Tokens ausführen.

Beispiel-Prompts für deinen KI-Agenten

  • „Erstelle eine Playlist mit den besten Tracks aus Daft Punks Discovery-Album“
  • „Finde Künstler, die Massive Attack ähneln, und füge ihre Top-Tracks zu meiner Mediathek hinzu“
  • „Was sind meine Playlists? Füge das neue LCD Soundsystem-Album zur ersten hinzu“
  • „Spiel mir etwas von Boards of Canada“
  • „Erstelle eine 2000er-Indie-Rock-Playlist mit The Strokes, Arctic Monkeys und Interpol“

Skripting-Muster

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

Entwicklung

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

Tests ausführen

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

143 Tests, die Suche, Playlists, Künstler, Tracks, Alben, Mediathek, Empfehlungen, Mixes, Für-später-speichern, Teilen, Suchverlauf, Authentifizierung und Sitzung abdecken.

Lizenz

tidal-cli ist unter der MIT-Lizenz lizenziert. Siehe die LICENSE-Datei für Details.