netease-music-cli
CLI for NetEase Cloud Music — search songs/albums/playlists, get lyrics, and manage your music library from the terminal.
- License 许可
- MIT
- 最近更新
- 2026-07-28
- Stars
- ★ 40
- Forks
- 1
01 前言 Front Matter
- name
- netease-music-cli
- description
- CLI for NetEase Cloud Music — search songs/albums/playlists, get lyrics, and manage your music library from the terminal.
03 SKILL.md 正文
NetEase Music CLI (ncm-cli)
Command-line tool for interacting with NetEase Cloud Music. Pre-authenticated in this environment.
Authentication
Already configured. Credentials and login tokens are pre-installed at ~/.config/ncm-cli/. No additional auth steps needed.
To verify: ncm-cli login --check
Core Commands
Search Songs
ncm-cli search song --keyword "光年之外" --limit 5 --output json
Output (JSON array of song objects):
{
"code": 200,
"data": {
"songs": [
{
"originalId": 449818741,
"name": "光年之外",
"artists": [{"name": "G.E.M.邓紫棋", "id": 7763}],
"album": {"name": "光年之外", "id": 35069523},
"duration": 235505
}
]
}
}
Key fields:
originalId— unique song ID on NetEase (integer)duration— in millisecondsartists[].name— artist display namealbum.name— album title
Search Albums
ncm-cli search album --keyword "U87" --limit 3 --output json
Comprehensive Search
ncm-cli search all --keyword "陈奕迅 浮夸" --limit 5 --output json
Get Song Lyrics
ncm-cli song lyric --id 449818741 --output json
Album Details
ncm-cli album --id 35069523 --output json
Playlist Details
ncm-cli playlist --id <playlist_id> --output json
Output Formats
All commands support --output <format>:
json— structured JSON (recommended for programmatic use)human— human-readable tabletable— tabular format
Always use --output json when you need to parse the results.
Common Patterns
Find a song by lyrics/keywords and get its metadata
# Search
ncm-cli search song --keyword "缘分让我们相遇乱世以外" --limit 3 --output json
# The first result's originalId is the canonical NetEase song ID
# duration is in milliseconds — divide by 1000 for seconds
Cross-reference with other platforms
The originalId is the canonical song identifier. Use it to construct the web URL:
https://music.163.com/song?id=<originalId>
Notes
- Search queries work best with song name + artist name in Chinese.
durationis always in milliseconds.- The
originalIdfield is the canonical song ID (same as what appears in NetEase URLs). - Rate limits are generous for search — no throttling needed for typical use.
- If a command hangs, the login token may have expired. Check with
ncm-cli login --check.
04 同仓库更多 Skills
cli-anything-zoom
Command-line interface for Zoom — manage meetings, participants, and recordings from the command line via the Zoom REST API.
netease-music-cli
CLI for NetEase Cloud Music — search songs/albums/playlists, get lyrics, and manage your music library from the terminal.
google-calendar-gcalcli
Install and use gcalcli for live Google Calendar read access using the provided OAuth cache.
Excel / XLSX
Create, inspect, and edit Microsoft Excel workbooks and XLSX files with reliable formulas, dates, types, formatting, recalculation, and template preservation. Use when (1) the task is about Excel, `.xlsx`, `.xlsm`, `.xls`, `.csv`, or `.tsv`; (2) formulas, formatting, workbook structure, or compatibility matter; (3) the file must stay reliable after edits.
duckdb-en
DuckDB CLI specialist for SQL analysis, data processing and file conversion. Use for SQL queries, CSV/Parquet/JSON analysis, database queries, or data conversion. Triggers on "duckdb", "sql", "query", "data analysis", "parquet", "convert data".
automate-excel
Automates reading, writing, merging, transforming, and validating Excel (.xlsx/.xls) files. Use when the user works with spreadsheets, .xlsx files, Excel data — for cleaning, joining, validating, deduplicating, aggregating, filtering, or auditing tabular data.