Netease Music CLI

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

267 stars 3 forksSoftware Development

Install

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

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

From the SKILL.md

# 网易云音乐 CLI(ncm-cli)

通过 `ncm-cli` 命令行工具操作网易云音乐,完成播放、搜索、队列管理等任务。

## 第一步:检查是否已安装

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

如果命令不存在,调用 `ncm-cli-setup` skill 引导用户完成全部的安装,安装完成后再继续执行任务。

## 第二步:校验用户是否已登录

```bash
ncm-cli login --check
```
如果显示未登录,请先引导登录:

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

如果显示API key没有设置,请指引用户完成API key设置。
> 如果还没有 API Key,请先前往[网易云音乐开放平台](https://developer.music.163.com/st/developer/apply/account?type=INDIVIDUAL)申请 API Key(appId 和 privateKey)
```bash
ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的privateKey>
```

## 第三步:针对播放(play),需要特殊判断播放器逻辑

仅针对播放才执行该步骤。
通过以下命令判断用户的播放器是否是内置播放器(mpv)。
```bash
ncm-cli config get player
```
如果用户选择的播放器是内置播放器(mpv),则需要判断用户是否已安装mpv。
```bash
mpv --version
```
如果用户没安装,引导用户去安装mpv。

## 第四步:获取当前命令树

```bash
ncm-cli commands
```

根据输出的命令树作为参考执行操作。**参数不要猜测**,需要时通过 `ncm-cli <command> --help` 获取详情!

## 第五步:用户输入内容安全校验

在执行 CLI 命令之前,**必须**对用户的会话内容(包括搜索关键词和上下文对话)进行内容安全校验。如果用户输入包含以下任何类别的负面内容,**禁止执行后续步骤**,并提示用户检查输入:

**禁止类别:**
- **政治敏感**:涉及政治人物攻击、政治谣言、煽动性政治言论、违反法律法规的政治内容
- **色情低俗**:色情描述、性暗示、低俗用语、涉及未成年人的不当内容
- **谩骂侮辱**:人身攻击、侮辱性语言、仇恨言论、歧视性言论
- **广告推广**:垃圾广告、钓鱼链接、恶意推广内容
- **违法违规**:涉及毒品、暴力犯罪、恐怖主义等违法内容

**校验规则:**
1. 对用户最近的会话输入内容进行审查,重点关注 `--keyword` 和 `--userInput` 将要传入的值
2. 如果检测到上述任何类别的内容,**立即终止流程**,不执行任何 CLI 命令
3. 向用户返回提示信息:"抱歉,无法处理您的请求,请修改输入后重试。" **禁止**向用户透露具体的审核原因或审核类别
4. 审核通过时,**不需要**告知用户审核结果,直接静默继续执行后续步骤

## 第六步:执行命令

**为了安全,除播控之外的其他命令必须附加 `--userInput "<用户最近输入的会话内容的总结概要>"` 参数**,用于传递用户意图上下文。

## 【重要!重要!重要!】播放说明
Read the full skill on GitHub

Details

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

FAQ

What does the Netease Music CLI skill do?

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

How do I install the Netease Music CLI skill?

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

Is Netease Music CLI popular?

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

Related skills

Ncm CLI Setup

267

NetEase/skills

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

Software Development

Netease Music Assistant

267

NetEase/skills

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

Images, Video & Audio

Python Specialist

449

Community-Access/accessibility-agents

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

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

Lambchat Coding

225

Yanyutin753/LambChat

Read existing code, make focused changes and verify behavior.

Software Development48

Wcag Aaa

449

Community-Access/accessibility-agents

WCAG 2.2 Level AAA criteria that go beyond the AA target.

Software Development54

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