Netease Music Cli

Organization

NetEase

netease-music-cli

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

Overview

Publisher	NetEase
Repository	`skills`
Skill name	`netease-music-cli`
Stars	251
Forks	3
Bundled files	Instructions only
Links	Skill source Repository

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
Self-contained
Everything the model needs lives in the instructions — no extra files to sync.
Open source
Published by NetEase on GitHub. Read the source before you install it.

Installation

Install the Netease Music Cli AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/NetEase/skills/tree/master/netease-music-cli
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

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

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Netease Music Cli in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Netease Music Cli on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Netease Music Cli is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

网易云音乐 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，请先前往网易云音乐开放平台申请 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 命令之前，必须对用户的会话内容（包括搜索关键词和上下文对话）进行内容安全校验。如果用户输入包含以下任何类别的负面内容，禁止执行后续步骤，并提示用户检查输入：

禁止类别：

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

校验规则：

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

第六步：执行命令

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

【重要！重要！重要！】播放说明

歌曲有两种 ID：加密 ID（32位hex，用于 API 请求）和原始 ID（数字，用于唤起客户端）。搜索结果同时包含两种 ID。
如果歌曲的visible为 false，则是无法播放的！请不要尝试播放或添加到播放队列！
如果歌曲的visible为 false，则是无法播放的！请不要尝试播放或添加到播放队列！
如果歌曲的visible为 false，则是无法播放的！请不要尝试播放或添加到播放队列！
如果给用户找到了多首歌曲并给用户播放的时候，请先开始播放第一首，并把后面的歌加到播放队列中！
如果命令返回“请求总量超限”，请直接告知用户并停止执行后续步骤！直接把原因给到用户，不要二次加工！

bash
# 综合搜索，获取 ID
ncm-cli search song --keyword "xxx" --userInput "搜索xxx的歌"

# 创建歌单
ncm-cli playlist create --playlistName "跑步"  --userInput "创建一个跑步歌单"

登录态处理

如果命令输出中包含登录引导信息（如"请先登录"、"未授权"等），请直接执行ncm-cli login --background并把链接给到用户，完整跑完整个登录流程。

用户友好

返回资源给用户的时候请尽量给到链接，可以是超链接，这样用户可以直接点击链接，ID可以选择性输出。主要的链接形式包括： 注意：链接中的ID必须用明文ID！！


https://music.163.com/#/song?id=<明文ID>
https://music.163.com/#/playlist?id=<明文ID>
https://music.163.com/#/album?id=<明文ID>
https://music.163.com/#/artist?id=<明文ID>

【重要！】给用户举例的时候，请使用「xxx」来替代具体的输入词

【重要！】给用户举例的时候，请使用「xxx」来替代具体的输入词

bash
ncm-cli search song --keyword "xxx"

Frequently asked questions

What does the Netease Music Cli AI skill do?

Why use Netease Music Cli on TypingMind?

Because you install it once and use it with any model. Netease Music Cli is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Netease Music Cli in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/NetEase/skills/tree/master/netease-music-cli. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Netease Music Cli?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Netease Music Cli?

As many as you like. As long as a model supports skills, you can use Netease Music Cli with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Netease Music Cli AI skill free?

It is published on GitHub by NetEase. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Cuda Index Width

pytorch

OrganizationPopular

Choose 32-bit vs 64-bit index math in PyTorch CUDA kernels. Use when fixing large-tensor indexing overflows, deciding whether to use int64_t, canUse32BitIndexMath, CUDA_KERNEL_LOOP_TYPE, or…

Plan Change

Turn a feature request into a minimal, file-level implementation plan before any code.

Simplified English

Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the…

Archify Review

Review Archify issues, PRs, or code through value, cost, and impact to support evidence-based maintenance decisions. Use for issue triage, change reviews, and code quality assessments.

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

网易云音乐 CLI（ncm-cli）

第一步：检查是否已安装

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

第三步：针对播放（play），需要特殊判断播放器逻辑

第四步：获取当前命令树

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

第六步：执行命令

【重要！重要！重要！】播放说明

登录态处理

用户友好

Frequently asked questions

Related AI Skills

Set up your own AI workspace now