AGENT SKILL

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 milliseconds
  • artists[].name — artist display name
  • album.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 table
  • table — 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

  1. Search queries work best with song name + artist name in Chinese.
  2. duration is always in milliseconds.
  3. The originalId field is the canonical song ID (same as what appears in NetEase URLs).
  4. Rate limits are generous for search — no throttling needed for typical use.
  5. If a command hangs, the login token may have expired. Check with ncm-cli login --check.

04 同仓库更多 Skills

HKU-MMLab
HKU-MMLab/UniClawBench

cli-anything-zoom

Command-line interface for Zoom — manage meetings, participants, and recordings from the command line via the Zoom REST API.

★ 40
HKU-MMLab
HKU-MMLab/UniClawBench

google-calendar-gcalcli

Install and use gcalcli for live Google Calendar read access using the provided OAuth cache.

★ 40
HKU-MMLab
HKU-MMLab/UniClawBench

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.

★ 40
HKU-MMLab
HKU-MMLab/UniClawBench

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".

★ 40
HKU-MMLab
HKU-MMLab/UniClawBench

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.

★ 40
HKU-MMLab
HKU-MMLab/UniClawBench

songsee

Generate spectrograms and feature-panel visualizations from audio with the songsee CLI, and pull out music-information-retrieval features such as tempo, key, beat grid, and section boundaries.

★ 40