Tidal MCP Server

tidal-cli

Sobre

O tidal-cli encapsula a API Tidal v2 em uma única ferramenta de linha de comando. Pesquise no catálogo, gerencie playlists, explore artistas, reproduza faixas e administre sua biblioteca — tudo sem abrir um navegador. Todos os comandos oferecem saída --json, tornando-o a espinha dorsal para automação de agentes LLM via OpenClaw.

Funcionalidades

• Pesquisar artistas, álbuns, faixas, vídeos, playlists e sugestões de autocompletar
• Artistas — informações, principais faixas, discografia, artistas similares, rádio
• Álbuns — detalhes, consulta por código de barras
• Faixas — informações, faixas similares, consulta por ISRC, rádio
• Playlists — CRUD completo, adicionar/remover faixas, reordenar, adicionar álbuns inteiros
• Biblioteca — favoritos para artistas, álbuns, faixas, vídeos, playlists
• Reprodução — informações de streaming, URLs diretas, reprodução local via DASH
• Recomendações — mixes personalizados (Diário, Descobertas, Novos Lançamentos, Offline) com detalhamento dos itens do mix
• Histórico — faixas, álbuns, artistas adicionados recentemente; histórico de buscas (listar, excluir, limpar)
• Salvar para Depois — marcar itens em uma fila separada da sua biblioteca principal
• Compartilhamento — gerar links públicos de compartilhamento para faixas e álbuns
• Saída JSON em todos os comandos para scripting e uso por agentes

Instalação

npm install -g @lucaperret/tidal-cli

Requisitos

• Node.js >= 20
• Uma conta Tidal

Início 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

Pesquisa

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 e Faixa

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>

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>

Descoberta e Histórico

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

Salvar para Depois e Compartilhamento

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>

Reprodução

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

Opções de qualidade: LOW, HIGH, LOSSLESS, HI_RES.

Saída JSON

Adicione --json antes de qualquer subcomando:

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

Servidor MCP (Integração com Claude)

O tidal-cli está disponível como um servidor MCP remoto para Claude Desktop, Smithery e qualquer cliente compatível com MCP.

Conectar no Claude Desktop:

1. Configurações → Conectores → Adicionar conector personalizado
2. Insira: https://tidal-cli.lucaperret.ch/api/mcp
3. Clique em "Conectar" → faça login no Tidal → pronto

40 ferramentas com autenticação OAuth, anotações de segurança e 3 modelos de prompt.

Automação com Agentes

O tidal-cli também está disponível como uma skill do OpenClaw no ClawHub. Instale-a para o seu agente de IA:

clawhub install tidal-cli

Após tidal-cli auth, os agentes podem executar comandos de forma não interativa com tokens de atualização automática.

Exemplos de prompts para seu agente de IA

• "Crie uma playlist com as melhores faixas do álbum Discovery do Daft Punk"
• "Encontre artistas similares ao Massive Attack e adicione as principais faixas deles à minha biblioteca"
• "Quais são minhas playlists? Adicione o novo álbum do LCD Soundsystem à primeira delas"
• "Toque algo do Boards of Canada para mim"
• "Monte uma playlist de indie rock dos anos 2000 com The Strokes, Arctic Monkeys e Interpol"

Padrões 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"

Desenvolvimento

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

Executando Testes

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

143 testes cobrindo pesquisa, playlists, artistas, faixas, álbuns, biblioteca, recomendações, mixes, salvar para depois, compartilhamento, histórico de buscas, autenticação e sessão.

Licença

O tidal-cli está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.