Tidal

公式

AIでTidalの音楽ライブラリを検索、閲覧、管理できます。アーティスト、アルバム、トラックを発見。プレイリストの作成と管理。お気に入りをライブラリに追加。パーソナライズされたレコメンデーションを取得。OAuth認証による公式Tidal APIを利用した32のツール。

GitHub
10
このMCPを試すスポンサー

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 ファイルを参照してください。