Ncm CLI Setup

安装和配置 ncm-cli(网易云音乐 CLI 工具)。当用户需要安装 ncm-cli、配置 API Key、安装 mpv 播放器,或排查安装问题时,使用此 skill。

267 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add NetEase/skills --skill ncm-cli-setup
Manual install
git clone --depth 1 https://github.com/NetEase/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/ncm-cli-setup ~/.claude/skills/ncm-cli-setup

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# ncm-cli 安装配置

ncm-cli 是网易云音乐的 CLI 工具(音乐搜索、播放控制、歌单管理、TUI 播放器)。

## 安装流程

### 第一步:安装 ncm-cli、mpv

#### 1.1 安装 ncm-cli

```bash
npm install -g @music163/ncm-cli
```

验证安装:

```bash
ncm-cli --version
```

#### 1.2 安装 mpv

播放功能需要 mpv 播放器。先检测是否已安装:

```bash
mpv --version
```

**macOS / Windows**:若未安装,直接执行安装脚本:

```bash
python3 scripts/install_mpv.py
```

**Linux**:询问用户是否需要播放功能:

- 如果是桌面环境、需要本地播放 → 执行 `python3 scripts/install_mpv.py`
- 如果是服务器环境、不需要播放 → 跳过,搜索/歌单等命令仍可正常使用

安装脚本会自动识别包管理器:

- **macOS**:Homebrew(`brew install mpv`)或 MacPorts
- **Linux**:apt / dnf / pacman / zypper
- **Windows**:winget / Chocolatey / Scoop

### 第二步:配置 API Key

使用 ncm-cli 需要先设置API Key:

```bash
ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的PrivateKey>
```

> 如果还没有 API Key,请先前往[网易云音乐开放平台](https://developer.music.163.com/st/developer/apply/account?type=INDIVIDUAL)申请 API Key(appId 和
> privateKey)。

### 第三步:配置默认播放器

询问用户选择默认播放器:

- **mpv**(内置播放器):轻量、跨平台,需先完成第一步中的 mpv 安装
- **orpheus**(云音乐 App):调用本地网易云音乐客户端播放,仅支持 macOS

根据用户选择执行:

```bash
ncm-cli config set player mpv      # 选择内置播放器
ncm-cli config set player orpheus  # 选择云音乐 App
```

### 第四步:登录

登录是必须的,请使用:

```bash
ncm-cli login --background
```

## 常见问题

| 问题                           | 解决方法                                                       |
|------------------------------|------------------------------------------------------------|
| `ncm-cli: command not found` | 检查 npm 全局 bin 是否在 PATH 中:`npm bin -g`                      |
Read the full skill on GitHub

Details

Skill name
ncm-cli-setup
Repository
NetEase/skills
Path
ncm-cli-setup/SKILL.md
Repo updated
31 March 2026

FAQ

What does the Ncm CLI Setup skill do?

安装和配置 ncm-cli(网易云音乐 CLI 工具)。当用户需要安装 ncm-cli、配置 API Key、安装 mpv 播放器,或排查安装问题时,使用此 skill。

How do I install the Ncm CLI Setup skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add NetEase/skills --skill ncm-cli-setup. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Ncm CLI Setup popular?

It lives in NetEase/skills, which has 267 GitHub stars and 3 forks.

Related skills

Netease Music Assistant

267

NetEase/skills

网易云音乐智能助手,以模型判断为核心,通过 ncm-cli 执行操作。 核心能力:分析用户红心歌单偏好画像、制定多关键词搜索策略、智能推荐歌单/专辑/单曲(含两层推荐说明)、播放控制(播放/暂停/下一首/音量/队列)、管理定时推送调度、通过 OpenClaw 向飞书等 IM 渠道推送推荐结果、创建并写入歌单。 触发时机(满足任意一条即激活): - 消息中含"网易云"或"云音乐" - 用户想听歌、要歌单推荐、找某类型音乐 - 用户想分析自己的音乐偏好或红心记录

Images, Video & Audio

Netease Music CLI

267

NetEase/skills

使用 ncm-cli 操作网易云音乐。当用户想播放歌曲、搜索歌曲、控制播放(暂停、下一首、上一首、调音量)、管理播放队列、查看播放状态、播放歌单时,使用此 skill。

Software Development

Lambchat Coding

225

Yanyutin753/LambChat

Read existing code, make focused changes and verify behavior.

Software Development48

Python Specialist

449

Community-Access/accessibility-agents

Python debugging, packaging, testing, typing, async and performance.

Software Development54

Kb Python Development

449

Community-Access/accessibility-agents

Reference data, not a reviewer. Python and wxPython development: packaging (PyInstaller/Nuitka), testing, desktop accessibility APIs, cross-platform paths, and framework patterns.

Software Development54

Spec Driven Development

160

FredAntB/Spec-Driven-Development

Use this skill to scaffold Spec Driven Development: requirements.md, design.md, tasks.md, and cross-compatible AI config files (CLAUDE.md, .cursorrules, .windsurfrules, .github/copilot-instructions.md). Triggers: 'requirements', 'spec', 'design doc', 'tasks', 'CLAUDE.md', 'cursorrules', 'SDD', 'spec driven', 'AI configuration', 'cross-AI', 'multi-agent', 'agent setup'. Also trigger for: 'set up my AI tools', 'keep agents consistent', 'stop AI going off-script', 'plan before coding', 'structure project for AI'. Retrofit triggers: 'document my system', 'document my codebase', 'describe my archit

Software Development18

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.