Tidal

tidal-cli

Acerca de

tidal-cli envuelve la API v2 de Tidal en una única herramienta de línea de comandos. Busca en el catálogo, gestiona listas de reproducción, explora artistas, reproduce pistas y administra tu biblioteca — todo sin abrir un navegador. Cada comando admite salida --json, convirtiéndolo en la columna vertebral para la automatización de agentes LLM a través de OpenClaw.

Características

• Buscar artistas, álbumes, pistas, videos, listas de reproducción y sugerencias de autocompletado
• Artistas — información, pistas principales, discografía, artistas similares, radio
• Álbumes — detalles, búsqueda por código de barras
• Pistas — información, pistas similares, búsqueda por ISRC, radio
• Listas de reproducción — CRUD completo, añadir/eliminar pistas, reordenar, añadir álbumes completos
• Biblioteca — favoritos para artistas, álbumes, pistas, videos, listas de reproducción
• Reproducción — información de transmisión, URLs directas, reproducción local vía DASH
• Recomendaciones — mezclas personalizadas (Diaria, Descubrimiento, Nuevo Lanzamiento, Sin Conexión) con desglose en elementos de la mezcla
• Historial — pistas, álbumes, artistas añadidos recientemente; historial de búsqueda (listar, eliminar, limpiar)
• Guardar para más tarde — marcar elementos en una cola separada de tu biblioteca principal
• Compartir — generar enlaces públicos para compartir pistas y álbumes
• Salida JSON en cada comando para scripting y uso por agentes

Instalación

npm install -g @lucaperret/tidal-cli

Requisitos

• Node.js >= 20
• Una cuenta de Tidal

Inicio Rápido

# 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

Uso

Búsqueda

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"

Artista

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>

Álbum y Pista

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>

Listas de reproducción

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>

Biblioteca

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>

Descubrimiento e Historial

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

Guardar para más tarde y Compartir

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>

Reproducción

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

Opciones de calidad: LOW, HIGH, LOSSLESS, HI_RES.

Salida JSON

Añade --json antes de cualquier subcomando:

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

Servidor MCP (Integración con Claude)

tidal-cli está disponible como un servidor MCP remoto para Claude Desktop, Smithery y cualquier cliente compatible con MCP.

Conectar en Claude Desktop:

1. Configuración → Conectores → Añadir conector personalizado
2. Introduce: https://tidal-cli.lucaperret.ch/api/mcp
3. Haz clic en "Conectar" → inicia sesión en Tidal → listo

40 herramientas con autenticación OAuth, anotaciones de seguridad y 3 plantillas de prompts.

Automatización con Agentes

tidal-cli también está disponible como una habilidad de OpenClaw en ClawHub. Instálala para tu agente de IA:

clawhub install tidal-cli

Después de tidal-cli auth, los agentes pueden ejecutar comandos de forma no interactiva con tokens que se auto-renuevan.

Ejemplos de prompts para tu agente de IA

• "Crea una lista de reproducción con las mejores pistas del álbum Discovery de Daft Punk"
• "Encuentra artistas similares a Massive Attack y añade sus pistas principales a mi biblioteca"
• "¿Cuáles son mis listas de reproducción? Añade el nuevo álbum de LCD Soundsystem a la primera"
• "Reprodúceme algo de Boards of Canada"
• "Construye una lista de reproducción de indie rock de los 2000 con The Strokes, Arctic Monkeys e Interpol"

Patrones de scripting

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

Desarrollo

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

Ejecutar Pruebas

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

143 pruebas que cubren búsqueda, listas de reproducción, artistas, pistas, álbumes, biblioteca, recomendaciones, mezclas, guardar para más tarde, compartir, historial de búsqueda, autenticación y sesión.

Licencia

tidal-cli está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.