SkillFoxx
Telegram

NetEase Cloud Music Agent Skills

Три скилла NetEase Cloud Music: установка ncm-cli, поиск и воспроизведение музыки, ассистент с рекомендациями по вкусам

  • 267 ★ репозитория
  • Последний коммит
СкиллОфициальный

Расширенный доступ

Почему такой уровень

  • Скиллы работают через ключ API NetEase и вход в аккаунт, управляют плеером и создают плейлисты
  • Ассистент по просьбе о расписании пишет задания в crontab и файлы в ~/.config/ncm
  • Список избранных треков раскрывает вкусы пользователя и разбирается моделью
Все причины и проверки

netease/skillsАвтор:NetEase

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/netease-cloud-music-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скиллы работают через ключ API NetEase и вход в аккаунт, управляют плеером и создают плейлисты
  • Ассистент по просьбе о расписании пишет задания в crontab и файлы в ~/.config/ncm
  • Список избранных треков раскрывает вкусы пользователя и разбирается моделью

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий NetEase/skills — официальный набор скиллов NetEase Cloud Music поверх консольной программы ncm-cli. Скилл ncm-cli-setup ставит и настраивает ncm-cli, когда его нет на машине. Скилл netease-music-cli ищет песни, плейлисты и альбомы, управляет воспроизведением (пауза, следующий трек, громкость), ведет очередь, создает плейлисты и добавляет в них треки, показывает ежедневные рекомендации и данные пользователя. Третий скилл, netease-music-assistant, строит на этом слое умного помощника. Он разбирает список избранных треков: считает жанровые теги, определяет настроение, языки и любимых исполнителей, смотрит на свежие добавления. Затем собирает до шести поисковых запросов, прогоняет несколько из них параллельно, убирает уже рекомендованное и сохраненное и объясняет выбор. Рекомендацию он может отправить в Feishu через OpenClaw, а подходящие треки по согласию записать в новый плейлист. Помощник умеет и расписание: правила пишутся в ~/.config/ncm/ncm-schedule.json и регистрируются в crontab, чтобы подборки приходили в заданное время.

Для кого. Пользователям NetEase Cloud Music, которые хотят управлять плеером и плейлистами голосом агента, и разработчикам, собирающим рассылку музыкальных подборок в Feishu.

Подходит, если

  • Нужно найти песню или альбом и сразу включить: первый трек играет, остальные найденные встают в очередь
  • Агенту поручают создать плейлист «Бег» и положить в него подходящие треки
  • По списку избранного хочется получить портрет вкусов: жанры, настроение, языки, любимые исполнители и недавний сдвиг
  • Подборки должны приходить по расписанию в Feishu через OpenClaw

Не подходит, если

  • Музыку слушают в Яндекс Музыке или Spotify: скиллы работают только с NetEase Cloud Music
  • Агент не должен менять расписание системы: ассистент с рассылкой по времени записывает задания в crontab
  • Нужна одна разовая команда: проще вызвать ncm-cli напрямую, без скиллов

Пример запроса к агенту

Найди в NetEase Cloud Music спокойные инструментальные треки для работы, включи первый и добавь остальные в очередь

Ограничения

  • Нужны Node.js 18 или новее, ncm-cli и ключ API (appId и privateKey), который выдают после регистрации разработчика на открытой платформе NetEase Cloud Music; страницы платформы на китайском.
  • README и скиллы написаны по-китайски, ассистент включается по словам «网易云» или «云音乐» в сообщении.
  • Треки с пометкой visible false не воспроизводятся, скилл велит пропускать их.
  • Последний коммит репозитория сделан в марте 2026. Автор не описывает установку скиллов сам.

Как отключить. Скиллы убирают удалением папок ncm-cli-setup, netease-music-cli и netease-music-assistant из каталога навыков агента. Пакет снимает npm uninstall -g @music163/ncm-cli. Задания рассылки видны в crontab -l, их удаляют редактированием crontab.

Частые вопросы

Как подключить скиллы NetEase Cloud Music к агенту?

Поставьте npm install -g @music163/ncm-cli, выполните ncm-cli configure и ncm-cli login, затем добавьте скиллы командой npx skills add NetEase/skills. Если ncm-cli не найден, скилл netease-music-cli сам передает управление скиллу ncm-cli-setup.

Как проверить, что вход выполнен?

Команда ncm-cli login --check покажет статус. При отсутствии входа скилл запускает ncm-cli login --background, а при незаполненном ключе API просит завершить его настройку.

Почему трек не играет?

У недоступных песен в ответе стоит visible false, скилл запрещает ставить их в воспроизведение и очередь. Попросите агента найти другую версию. Для встроенного плеера нужен установленный mpv, его ставит скрипт install_mpv.py из ncm-cli-setup.

Какие файлы ассистент ведет на диске?

Расписание рассылки лежит в ~/.config/ncm/ncm-schedule.json, а в ncm-history.json он сохраняет идентификаторы уже рекомендованных плейлистов, чтобы не повторяться. Предпочтения записываются в ncm-preference.json.

Зачем нужен ключ API и где его взять?

ncm-cli обращается к API NetEase, поэтому нужны appId и privateKey. Их выдают после регистрации разработчика на платформе developer.music.163.com, а вводят командой ncm-cli configure.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

MCP-сервер и скилл для поиска песен, альбомов, текстов и ссылок на прослушивание в четырех китайских музыкальных сервисах

MCP-серверРасширенный доступ118

Скилл учит агента собирать видео с закадровой озвучкой через narrator-ai-cli: поиск ролика, шаблон, музыка, голос, текст и монтаж

СкиллРасширенный доступ3,2 тыс.

29 скиллов для сочинения и аранжировки поп-музыки: по запросу агент заполняет спецификацию для Suno, YuE2 и MIDI

ПлагинМинимальный доступ209

Музыкальный сервер на Rust с MCP: агент ищет треки, собирает очередь и подбирает следующие по темпу и энергии.

MCP-серверРасширенный доступ533

Пиксельный диджей для Claude Code и Codex: играет музыку из Apple Music, показывает тексты и реагирует на коммиты и тесты

СкиллРасширенный доступ112
Официальный

Скилл MiniMax превращает короткое описание песни и размеченный текст в подробный запрос для генератора музыки MiniMax Music 3

СкиллМинимальный доступ1 тыс.

Коротко о README

README на китайском начинается с предупреждения: перед работой надо установить ncm-cli и пройти регистрацию на платформе. Затем идут таблица из трех скиллов, схема их зависимостей и короткое описание каждого с условиями запуска и ключевыми правилами. Ассистенту отведен самый длинный раздел.

Бейдж для README

Исходный SKILL.md

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

# 网易云音乐 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。

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

Сообщить о проблеме