← Back to Skills Marketplace
263
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install music-router
Description
Automatically converts music sharing links across Chinese and major international platforms, extracting song details and album artwork for seamless multi-pla...
README (SKILL.md)
Music Router Skill
This skill solves the problem of incompatible music sharing links between different platforms. It provides direct links for Chinese platforms and automatically resolves all major international platforms via the Odesli (song.link) API.
Features
- Auto-Identification: Automatically identifies the platform of the input music sharing link.
- Precise Extraction: Automatically extracts song name, artist information, and album artwork.
- Multi-Platform Resolution:
- Chinese Platforms: Direct links for Netease Cloud Music and QQ Music.
- International Platforms: Resolves direct links for Spotify, Apple Music, YouTube, YouTube Music, Amazon Music, Tidal, Deezer, and SoundCloud.
- Optional Logging: Conversion details can be recorded in
music-router/data/converter.logvia a command-line flag.
Agent Usage Guide
1. Basic Call (Link Only)
The Agent can pass the sharing link directly.
python3 music-router/scripts/converter.py "https://y.music.163.com/m/song?id=1988907896"
2. Precise Call (Link + Song/Artist)
If the Agent already knows the song name and artist, it can be passed as the second argument to improve matching accuracy for Chinese platforms.
python3 music-router/scripts/converter.py "https://open.spotify.com/track/315aBOUD3xtj7sUMXtRgMV" "In The Stars Benson Boone"
3. Enabling Logs (Optional)
To enable detailed logging for debugging, add the --log flag. Logging is disabled by default.
python3 music-router/scripts/converter.py "https://open.spotify.com/track/123" --log
Output Example (JSON)
{
"original_platform": "Spotify",
"detected_song": "In The Stars Benson Boone",
"thumbnail": "https://m.media-amazon.com/images/I/31OJGk6XaLL.jpg",
"conversions": {
"网易云音乐": "https://music.163.com/#/song?id=1941928009",
"QQ音乐": "https://y.qq.com/n/ryqq/songDetail/001Paon617ueUC",
"Apple Music": "https://geo.music.apple.com/us/album/_/1621221545?i=1621221910...",
"YouTube": "https://www.youtube.com/watch?v=ZLck_PSMNew",
"Amazon Music": "https://music.amazon.com/albums/B0B5FKVB4P?trackAsin=B0B5FK4MM1",
"Tidal": "https://listen.tidal.com/track/226476015",
"song.link (Aggregation)": "https://song.link/s/315aBOUD3xtj7sUMXtRgMV"
}
}
Supported Platforms
- Direct Resolution: Netease Cloud Music, QQ Music.
- International Resolution: Spotify, Apple Music, YouTube, YouTube Music, Amazon Music, Tidal, Deezer, SoundCloud.
Notes
- Odesli (song.link): This skill uses the Odesli API to resolve international links and fetch album artwork, ensuring high accuracy and a rich visual experience.
Usage Guidance
This skill is coherent with its purpose, but exercise basic caution: (1) Review the full converter.py before running — the provided manifest snippet appears truncated near the end (an undefined variable 'r' in the truncated output suggests you should confirm the real file is complete and correct). (2) Test with non-sensitive public links first — user-provided URLs and search queries will be sent to song.link and platform search APIs. (3) Avoid enabling logging (--log) if you don't want conversion details persisted on disk. (4) Run the script in a sandboxed environment if you want to limit network or filesystem exposure. If you want, provide the complete converter.py file (not a truncated listing) and I can re-check for bugs or hidden behavior.
Capability Analysis
Type: OpenClaw Skill
Name: music-router
Version: 1.0.0
The Music Router skill is a legitimate tool designed to convert music sharing links between various international and Chinese platforms. The core logic in `scripts/converter.py` uses the Odesli (song.link) API and direct platform searches (Netease, QQ Music) to resolve links, which is consistent with the stated purpose. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found in the code or documentation (SKILL.md, AGENT_GUIDE.md).
Capability Assessment
Purpose & Capability
The name/description (convert music links, fetch artwork) aligns with the included code and instructions: the script uses Odesli (song.link) for international resolutions and queries Netease/QQ endpoints for Chinese platforms. There are no unrelated environment variables, binaries, or install steps requested.
Instruction Scope
SKILL.md and AGENT_GUIDE instruct the agent to call the included Python script with the user-supplied link (and optionally song/artist and --log). That is scoped to the stated purpose. Important: the script issues HTTP requests to the provided URL and to third-party APIs (song.link, music.163.com, c.y.qq.com, etc.), and optional logging will write conversion details to music-router/data/converter.log. This means user-supplied links and derived metadata will be transmitted to external services and may be persisted locally when --log is used.
Install Mechanism
No install spec or external downloads are present; the skill is instruction-only plus an included Python script. No archive downloads or third-party installers are invoked.
Credentials
The skill requests no environment variables or credentials, which is appropriate. Caveat: it transmits user-supplied URLs and derived queries to remote APIs (song.link, Netease/QQ search endpoints). If users supply private or pre-release links, those will be sent to external services. Logging (--log) will persist details to the skill's data directory.
Persistence & Privilege
always is false and the skill does not request elevated privileges. The only persistent effect is optional creation of music-router/data/converter.log within the skill directory when logging is enabled; no modifications to other skills or system-wide settings are indicated.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install music-router - After installation, invoke the skill by name or use
/music-router - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Music Router Skill.
- Automatically identifies the source platform of music sharing links.
- Extracts song name, artist, and album artwork.
- Provides direct conversion for Netease Cloud Music and QQ Music.
- Resolves international links using the Odesli (song.link) API, covering Spotify, Apple Music, YouTube, Amazon Music, Tidal, Deezer, and SoundCloud.
- Optional logging feature via command-line flag for conversion records.
Metadata
Frequently Asked Questions
What is MusicRouter?
Automatically converts music sharing links across Chinese and major international platforms, extracting song details and album artwork for seamless multi-pla... It is an AI Agent Skill for Claude Code / OpenClaw, with 263 downloads so far.
How do I install MusicRouter?
Run "/install music-router" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is MusicRouter free?
Yes, MusicRouter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does MusicRouter support?
MusicRouter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created MusicRouter?
It is built and maintained by leo7723 (@leo7723); the current version is v1.0.0.
More Skills