← 返回 Skills 市场
264
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install yandex-music
功能描述
Inspect Yandex Music via the MarshalX yandex-music library. Use when the user wants Yandex Music search, current track lookup, liked tracks, playlists, or a...
使用说明 (SKILL.md)
Yandex Music Control
Use the bundled helper script for deterministic operations instead of rewriting API snippets.
First use
- Read
references/token-and-control.md. - Check whether the token is already available via
YM_TOKENor the workspace config file. - If the token is missing, ask the user for a token or guide them to provide one; do not invent an extraction flow.
- Validate the token with:
scripts/ymctl.py auth-check
Runtime
Prefer the skill-local virtualenv interpreter when present:
./.venv/bin/python scripts/ymctl.py ...
If .venv is missing, create it and install the library:
python3 -m venv .venv
./.venv/bin/pip install yandex-music
Save token
./.venv/bin/python scripts/ymctl.py auth-set \x3CTOKEN>
./.venv/bin/python scripts/ymctl.py auth-set \x3CTOKEN> --device '\x3Cdevice-id>'
./.venv/bin/python scripts/ymctl.py auth-where
./.venv/bin/python scripts/ymctl.py auth-clear
Default config path:
/root/.openclaw/workspace/.openclaw/yandex-music-control/config.json
Common commands
Search tracks:
./.venv/bin/python scripts/ymctl.py search 'кино группа крови'
./.venv/bin/python scripts/ymctl.py search 'масло черного тмина' --type artist
Current track:
./.venv/bin/python scripts/ymctl.py now-playing
Likes and playlists:
./.venv/bin/python scripts/ymctl.py likes --limit 20
./.venv/bin/python scripts/ymctl.py playlists
./.venv/bin/python scripts/ymctl.py like 'shortparis страшно'
./.venv/bin/python scripts/ymctl.py unlike 'shortparis страшно'
Behavior rules
- This skill is read/search oriented: do not claim live transport control.
now-playinguses a local Ynison websocket probe for modern clients.- Do not echo secrets back into chat.
- Keep token handling local to env vars or the workspace config file.
Files
- Helper script:
scripts/ymctl.py - Control/token notes:
references/token-and-control.md
安全使用建议
This skill appears to do what it says: it uses a bundled Python helper to call Yandex Music APIs and Ynison websocket endpoints. Before installing, consider: (1) you must provide a Yandex Music token (YM_TOKEN or via auth-set), and that token will be saved in the workspace config file under the skill directory (config file is created with 0600 permissions). (2) The skill will create a local virtualenv and pip-install the 'yandex-music' package from PyPI — if you prefer, run these steps manually in an isolated environment. (3) The script opens websocket/HTTP connections to Yandex hosts (expected for now-playing queries). (4) If you have concerns, review the bundled scripts (scripts/ymctl.py and references/token-and-control.md) yourself; the SKILL.md explicitly warns not to echo secrets and not to implement automated extraction flows.
功能分析
Type: OpenClaw Skill
Name: yandex-music
Version: 1.0.0
The skill provides a legitimate interface for Yandex Music using the MarshalX yandex-music library. The helper script (scripts/ymctl.py) implements standard API interactions and a WebSocket-based 'Ynison' probe for retrieving current playback status. Security best practices are followed, including restricting config file permissions to 0600, redacting tokens in output, and providing explicit instructions in SKILL.md and references/token-and-control.md to prevent the AI agent from leaking secrets or performing unauthorized token extraction.
能力评估
Purpose & Capability
Name/description, SKILL.md, and the included helper script (scripts/ymctl.py) all implement Yandex Music inspection (search, now-playing via Ynison, likes, playlists, token storage). Required capabilities (websocket/API calls to Yandex) match the stated purpose.
Instruction Scope
Runtime instructions are specific: prefer a skill-local .venv, install the official yandex-music package, use YM_TOKEN or workspace config, validate tokens, and avoid echoing secrets. The script reads/writes a workspace-local config file and opens websockets/HTTP connections to Yandex endpoints (ynison/music.yandex.ru), which is appropriate for now-playing queries. Note: SKILL.md explicitly instructs not to implement any secret-extraction automation and to ask the user for tokens.
Install Mechanism
No global install spec in the registry (instruction-only), but SKILL.md tells the agent to create a local Python venv and pip-install the 'yandex-music' package from PyPI. This is a reasonable, proportional approach for a Python helper script. No downloads from untrusted URLs are present.
Credentials
The skill does not declare required env vars in registry metadata, but both SKILL.md and the script use/accept YM_TOKEN as an environment source and allow persisting a token to the workspace config. That mismatch is minor but worth noting: supplying a YM_TOKEN is expected to use the skill, and tokens will be stored locally at the skill's workspace config path (written with mode 0600).
Persistence & Privilege
Skill is not always-enabled and can be invoked by the user. It stores its own workspace-local config file (no evidence it modifies other skills or global agent settings). It needs runtime network access to Yandex services to function, which is appropriate for its purpose.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install yandex-music - 安装完成后，直接呼叫该 Skill 的名称或使用
/yandex-music触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of the Yandex Music control skill using the MarshalX yandex-music library.
- Provides search, current track lookup, liked tracks, and playlists lookup via bundled helper script.
- Adds workflow for Yandex Music token setup, validation, and storage using scripts/ymctl.py.
- Emphasizes deterministic script use instead of ad-hoc API snippets.
- Keeps token management local and never exposes secrets in chat.
- Clear, command-based interface for common Yandex Music queries and actions.
元数据
常见问题
Yandex Music 是什么？
Inspect Yandex Music via the MarshalX yandex-music library. Use when the user wants Yandex Music search, current track lookup, liked tracks, playlists, or a... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 264 次。
如何安装 Yandex Music？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install yandex-music」即可一键安装，无需额外配置。
Yandex Music 是免费的吗？
是的，Yandex Music 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Yandex Music 支持哪些平台？
Yandex Music 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Yandex Music？
由 prtolem（@prtolem）开发并维护，当前版本 v1.0.0。
推荐 Skills