Tidal

官方

使用AI搜索、浏览和管理您的Tidal音乐库。发现艺术家、专辑和曲目。创建和策划播放列表。将收藏添加到您的库中。获取个性化推荐。32个工具由官方Tidal API提供支持，采用OAuth认证。

GitHub
9

你可以用 Tidal MCP 做什么？

  • 搜索 Tidal 目录 — 使用 search 查找艺术家、专辑、曲目、视频或播放列表，并通过 search suggest 实现自动补全。
  • 管理播放列表 — 通过 playlist 命令创建、重命名、删除和重新排序播放列表，或添加/移除单首曲目及整张专辑。
  • 控制你的资料库 — 使用 library add 和 library remove 添加或移除收藏的艺术家、专辑、曲目、视频和播放列表。
  • 获取个性化推荐 — 通过 recommend 浏览每日推荐、发现、新发行和离线混音，再使用 mix items 深入查看混音中的项目。
  • 查看详情及相关内容 — 通过 artist、album 和 track 命令获取艺术家信息、热门曲目、相似艺术家、专辑详情、曲目信息、相似曲目及电台。
  • 播放与分享音乐 — 使用 playback 获取流媒体信息或直接播放链接，并通过 share 为曲目和专辑生成公开分享链接。

文档

tidal-cli

tidal-cli — Control Tidal from your terminal

npm CI smithery badge License Node

关于

tidal-cli 将 Tidal API v2 封装为一个单一的命令行工具。搜索曲库、管理播放列表、探索艺术家、播放曲目以及管理你的资料库——所有这些都无需打开浏览器。每条命令都支持 --json 输出，使其成为通过 OpenClaw 实现 LLM 智能体自动化的核心支柱。

功能特性

  • 搜索 艺术家、专辑、曲目、视频、播放列表以及自动补全建议
  • 艺术家 — 信息、热门曲目、作品目录、相似艺术家、电台
  • 专辑 — 详情、条形码查询
  • 曲目 — 信息、相似曲目、ISRC 查询、电台
  • 播放列表 — 完整的增删改查、添加/移除曲目、重新排序、添加整张专辑
  • 资料库 — 收藏艺术家、专辑、曲目、视频、播放列表
  • 播放 — 流媒体信息、直链地址、通过 DASH 进行本地播放
  • 推荐 — 个性化混音（每日、发现、新发行、离线），并可深入查看混音项目
  • 历史记录 — 最近添加的曲目、专辑、艺术家；搜索历史（列表、删除、清除）
  • 稍后保存 — 将项目收藏在与主资料库分开的独立队列中
  • 分享 — 为曲目和专辑生成公开分享链接
  • 每条命令均支持 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 智能体的示例提示

  • “用 Daft Punk 的 Discovery 专辑中最好的曲目创建一个播放列表”
  • “查找与 Massive Attack 相似的艺术家，并将他们的热门曲目添加到我的资料库”
  • “我的播放列表有哪些？将新的 LCD Soundsystem 专辑添加到第一个播放列表中”
  • “给我播放一些 Boards of Canada 的曲子”
  • “创建一个包含 The Strokes、Arctic Monkeys 和 Interpol 的 2000 年代独立摇滚播放列表”

脚本编写模式

# 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 文件。