A small agent-native content-operations CLI for NetEase Cloud Music.
The write path delegates to the authenticated official @music163/ncm-cli@0.1.6 command registry. It does not replay browser cookies or the old /api/playlist/* write endpoints.
The project follows the CLI-Anything harness layout and agent-safe conventions, but is a small custom Click application rather than the official CLI-Anything runtime.
这是一个面向网易云音乐的自动化内容运营 CLI。当前先解决最核心的内容发布链路:把一份经过策划和校验的场景化 100 首歌单 manifest,发布成真实网易云歌单,并回读验证结果。
- 使用官方
@music163/ncm-cli@0.1.6完成登录检查、创建歌单、批量加歌、排序、修改标题/简介/标签和上传封面; - 使用 JSON manifest 管理歌单内容;
- 发布前支持
--dry-run; - 校验标题、简介、标签、封面,以及 100 首唯一加密歌曲 ID;
- 发布后同时通过 CLI 和匿名公开接口回读歌单数量与元数据;
- 不重放浏览器 Cookie,也不把凭证写入项目。
标题使用:
主题名|并列音乐类别
例如:
褪色的夜行|爵士嘻哈 梦泡 硬地 ACG
竖线前是场景和情绪,竖线后是音乐类别。城市漂流、夜间陪伴等词属于策展场景,不冒充音乐类型。简介按以下顺序写:情绪钩子 → 选歌逻辑 → 音乐科普。
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
npm install -g @music163/ncm-cli@0.1.6
ncm-cli login --check --output json先预览,再发布:
cli-anything-ncm-playlist --json playlist publish \
--manifest scenario-100.json \
--dry-run
cli-anything-ncm-playlist --json playlist publish \
--manifest scenario-100.json项目内的可复用规则见 skills/netease-content-ops/SKILL.md。当前范围是可靠的歌单内容发布,暂不自动化评论、刷播放/收藏或定时营销。
- check the exact CLI login session;
- search public songs through the read client;
- create/add/manage playlists through official
ncm-clicommands; - publish a validated scenario playlist as one content package;
- support
--dry-runbefore external writes; - read back the playlist through both CLI and anonymous public API.
The current vertical slice is playlist content publishing. It deliberately does not automate comments, artificial engagement, or scheduling.
python3 -m venv .venv
. .venv/bin/activate
pip install -e .Install and authenticate the official CLI separately:
npm install -g @music163/ncm-cli@0.1.6
ncm-cli login --check --output jsonIf ncm-cli is not on PATH, set its exact executable:
export NCM_CLI_BIN="$HOME/.npm-global/bin/ncm-cli"
cli-anything-ncm-playlist --json auth statusThe project does not store or print CLI credentials.
- Python 3.10+ — CLI and content-manifest validation
- Click — command-line interface and
--dry-runflow - Requests — public NetEase search and anonymous playlist readback
- Node.js/npm — installs the official
@music163/ncm-cli@0.1.6 - Official ncm-cli — authenticated playlist creation, track writes, reordering, metadata and cover updates
- JSON manifests — portable content packages for scenarioized 100-track playlists
- pytest — local regression tests
A scenarioized 100-track playlist uses this title shape:
主题名|并列音乐类别
The left side is a short emotional/editorial theme. The right side contains at least two actual music categories, for example:
褪色的夜行|爵士嘻哈 梦泡 硬地 ACG
城市漂流 belongs in the theme or description, not as if it were a music genre.
The description should stay short and human:
- one emotional hook for the listening scene;
- the selection logic and boundary;
- concise music-history / genre context.
The reusable project skill is documented in skills/netease-content-ops/SKILL.md.
Manifest shape (schematic; tracks must contain exactly 100 unique encrypted IDs):
{
"name": "褪色的夜行|爵士嘻哈 梦泡 硬地 ACG",
"description": "情绪钩子。\n\n选歌逻辑。\n\n音乐科普。",
"tags": ["说唱", "电子", "另类/独立"],
"cover": "./cover.jpg",
"tracks": [
{"encrypted_id": "<official ncm-cli song id>"}
]
}Preview first:
cli-anything-ncm-playlist --json playlist publish \
--manifest scenario-100.json \
--dry-runPublish and verify:
cli-anything-ncm-playlist --json playlist publish \
--manifest scenario-100.jsonThe command validates the title shape, description, 1–3 tags, 100 unique tracks, and JPEG/PNG cover. It then uses the official CLI to create, add, reorder, update metadata/cover, and read back the result. A successful output includes the numeric playlist URL and both CLI/public track counts.
cli-anything-ncm-playlist --json auth status
cli-anything-ncm-playlist --json search song --keyword 'Nujabes' --limit 5
cli-anything-ncm-playlist --json playlist create --name '褪色的夜行|爵士嘻哈 梦泡 硬地 ACG' --dry-run
cli-anything-ncm-playlist --json playlist add \
--playlist-id '<encrypted playlist id>' \
--encrypted-track-id '<encrypted song id>' \
--dry-runDo not pass ordinary numeric song IDs to playlist add; the official write command requires encrypted IDs. Resolve and review search results before adding.
python -m pytest -q
python -m cli_anything.ncm_playlist --help
python -m cli_anything.ncm_playlist self-checkCurrent scope: reliable playlist content publishing. Add scheduling, public content calendars, analytics, or other operations only when there is a concrete workflow and a real readback/rollback story. Never automate fake plays, collections, comments, or follows.
MIT