Monochrome

基于 Monochrome（Tidal 代理）Hi-Fi API 的音乐浏览 Skill：支持按关键字或 ISRC 搜索曲目、艺术家、专辑、视频与播放列表，查询曲目详情、专辑曲目表、相似艺术家与推荐、歌词与封面，并返回可流式播放或下载的音频链接。需联网调用外部接口，未包含实际播放或下载实现。

ricanwarfare

热度 53.22

最近更新 2026-05-11 17:40:25

分类：生活依赖：第三方 API / 代码执行应用场景：推荐

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add monochrome

Metadata

name: monochrome
description: Browse and search music from monochrome.tf (Tidal-based Hi-Fi streaming). Search for artists, albums, tracks, and get streaming URLs. Use for music discovery and high-fidelity audio streaming.
license: Apache-2.0

Monochrome Music Skill

Browse and stream music from Monochrome (monochrome.tf) — a minimalist, high-fidelity music streaming client powered by Tidal.

Capabilities

Search for artists, albums, tracks, videos, and playlists
Get track info and streaming URLs
Browse artist discographies
Get album details and track lists
Fetch lyrics for tracks
Get artist recommendations

API Instances

Monochrome uses the Hi-Fi API (Tidal proxy). Available instances:

Instance	Version	Status
`eu-central.monochrome.tf`	2.8	Primary
`us-west.monochrome.tf`	2.8	Secondary
`hifi-one.spotisaver.net`	2.8	Community
`hifi-two.spotisaver.net`	2.8	Community
`hifi.geeked.wtf`	2.7	Community

Use the primary instance for best reliability:

https://eu-central.monochrome.tf

Usage

Search for Music

Search for tracks, artists, albums, videos, or playlists:

Track Search:

GET /search/?s={query}&limit={limit}&offset={offset}

Artist Search:

GET /search/?a={query}&limit={limit}

Album Search:

GET /search/?al={query}&limit={limit}

Video Search:

GET /search/?v={query}&limit={limit}

Playlist Search:

GET /search/?p={query}&limit={limit}

ISRC Search (exact track match):

GET /search/?i={isrc}

Get Track Info

GET /info/?id={track_id}

Get Track Streaming URL

GET /track/?id={track_id}&quality={quality}&immersiveaudio={bool}

Quality options: LOW, HIGH, LOSSLESS, HI_RES, HI_RES_LOSSLESS

Get Album Details

GET /album/?id={album_id}&limit={limit}&offset={offset}

Get Artist Info

GET /artist/?id={artist_id}

Get Artist Albums & Tracks

GET /artist/?f={artist_id}

Get Similar Artists

GET /artist/similar/?id={artist_id}

Get Similar Albums

GET /album/similar/?id={album_id}

Get Lyrics

GET /lyrics/?id={track_id}

Get Playlist

GET /playlist/?id={playlist_id}&limit={limit}&offset={offset}

Get Mix

GET /mix/?id={mix_id}

Get Recommendations

GET /recommendations/?id={track_id}

Get Cover Art

GET /cover/?id={track_id}
GET /cover/?q={search_query}

Cover URLs follow the pattern:

https://resources.tidal.com/images/{uuid}/{size}.jpg

Sizes: 80x80, 320x320, 640x640, 1280x1280, 750x750

Implementation

Step 1: Search for Music

curl "https://eu-central.monochrome.tf/search/?s=Linkin%20Park&limit=10"

Returns JSON with track items including:

id — Track ID
title — Track title
artists — Artist list
album — Album info
duration — Duration in seconds
audioQuality — Quality tier

Step 2: Get Streaming URL

curl "https://eu-central.monochrome.tf/track/?id=12345678&quality=HI_RES_LOSSLESS"

Returns streaming manifest URL.

Step 3: Play/Download

The streaming URL can be used directly in audio players or downloaders.

Example Queries

User Request	API Call
"Search for Linkin Park"	`/search/?a=Linkin%20Park`
"Find the album Hybrid Theory"	`/search/?al=Hybrid%20Theory`
"Get track info for 12345"	`/info/?id=12345`
"Get lyrics for track 12345"	`/lyrics/?id=12345`
"Similar artists to Eminem"	`/artist/similar/?id=12345`

Notes

API is rate-limited; use appropriate delays for bulk requests
Quality HI_RES_LOSSLESS requires compatible streaming setup
All endpoints return JSON with version and data fields
Default countryCode is US

Related Skills

music-downloader — Download tracks from monochrome.tf
mcp-vision — Analyze album covers