Tidal

公式

Search, browse, and manage your Tidal music library with AI. Discover artists, albums, and tracks. Create and curate playlists. Add favorites to your library. Get personalized recommendations. 32 tools powered by the official Tidal API with OAuth authentication.

GitHub
6

Tidal MCPで何ができますか？

  • Tidalカタログを検索 — searchを使用してアーティスト、アルバム、トラック、動画、プレイリストを検索。さらにsearch suggestでオートコンプリートも可能。
  • プレイリストを管理 — playlistコマンドを使用して、プレイリストの作成、名前変更、削除、並べ替え、個別のトラックやアルバム全体の追加・削除が可能。
  • ライブラリを管理 — library addおよびlibrary removeを使用して、お気に入りのアーティスト、アルバム、トラック、動画、プレイリストを追加・削除。
  • パーソナライズされたおすすめを取得 — recommendを使用してデイリーミックス、ディスカバリーミックス、新着リリースミックス、オフラインミックスを閲覧し、mix itemsでミックス内のアイテムを詳細表示。
  • 詳細情報や関連コンテンツを確認 — artist、album、trackコマンドを使用して、アーティスト情報、トップトラック、類似アーティスト、アルバム詳細、トラック情報、類似トラック、ラジオを取得。
  • 音楽を再生・共有 — playbackでストリーム情報や直接再生URLを取得し、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 検索、ラジオ
  • プレイリスト — 完全な CRUD、トラックの追加/削除、並べ替え、アルバム全体の追加
  • ライブラリ — アーティスト、アルバム、トラック、ビデオ、プレイリストのお気に入り
  • 再生 — ストリーム情報、直接 URL、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 は Claude Desktop、Smithery、および任意の MCP 互換クライアント向けのリモート MCP サーバーとして利用可能です。

Claude Desktop での接続方法:

  1. 設定 → コネクター → カスタムコネクターを追加
  2. 入力: https://tidal-cli.lucaperret.ch/api/mcp
  3. 「接続」をクリック → Tidal にログイン → 完了

OAuth 認証、安全性アノテーション、3 つのプロンプトテンプレートを備えた 40 のツール。

エージェント自動化

tidal-cli は ClawHub 上の OpenClaw スキルとしても利用可能です。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 ファイルを参照してください。