Agent skill

Music Search

by freestylefly in freestylefly/wesight

Search cloud drives for downloadable music resources (songs, albums, lossless audio).

MITAuto-check: notes

Install Music Search

skills CLI
$ npx skills add freestylefly/wesight --skill music-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install freestylefly/wesight music-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/freestylefly/wesight.git skills-src && mkdir -p .claude/skills && cp -r skills-src/SKILLs/music-search .claude/skills/music-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
music-search
GitHub stars
946
Token cost
~880 tokens
SKILL.md length
159 words
Files
5 (incl. scripts)
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Search cloud drives for downloadable music resources (songs, albums, lossless audio).

  • Works in 5 steps: 用户说「帮我找 XXX 的音乐」→ 执行 search "XXX" → 解析返回的 JSON,提取网盘链接 → 按网盘类型和音频格式分组呈现给用户 → …
  • The user wants to download a specific song
  • SKILL.md covers 前置条件, 命令, Agent 使用流程 and 输出格式, plus 3 more sections
  • Runs JavaScript, PowerShell and Shell scripts from its folder; calls bash; reaches pan.quark.cn

What it does

Music Search is an agent skill from freestylefly/wesight. Search cloud drives for downloadable music resources (songs, albums, lossless audio). Use this skill when the user wants to download a specific song or album. Do NOT use for general music information, lyrics, or recommendations.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `scripts/music-search.js`, `scripts/music-search.sh` and `scripts/shared/deep-extract.js`).

The repository describes itself as: Open-source desktop AI agent workspace with one-click Claude Code, Codex, OpenClaw, Hermes Agent setup and custom LLM model routing. The licence is MIT.

When your agent uses it

  • The user wants to download a specific song
  • General music information
  • Recommendations

Example prompts

  • “/music-search”

Requirements

  • Node.js
  • A Bash shell
  • PowerShell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 用户说「帮我找 XXX 的音乐」→ 执行 search "XXX"
  2. 解析返回的 JSON,提取网盘链接
  3. 按网盘类型和音频格式分组呈现给用户
  4. 如果结果中有提取码 (extractCode),一并展示给用户
  5. 如果结果中有 pageUrl 但没有直接 url,用 resolve 命令获取真实地址

What it can do on your machine

Read from SKILL.md and the folder at commit c913cd9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (JavaScript, PowerShell and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • pan.quark.cn

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Music Search loads about 880 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 159 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~880

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:131
    编辑 `music-search/.env` 可自定义偏好:

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from freestylefly/wesight at commit c913cd9, republished under its MIT licence (© freestylefly). 159 words, ~880 tokens.

Download SKILL.mdSave it as .claude/skills/music-search/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
music-search
description
Search cloud drives for downloadable music resources (songs, albums, lossless audio). Use this skill when the user wants to download a specific song or album. Do NOT use for general music information, lyrics, or recommendations.
official
false
version
1.0.2

Music Search Skill

搜索音乐资源(歌曲、专辑、无损音乐),通过实时爬虫深度抓取资源页面,从各网盘平台获取公开分享的资源链接。

前置条件

  • web-search skill(必需,用于搜索发现资源页面)
  • Node.js >= 18(应用内置,无需额外安装)

命令

搜索资源
bash
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" search "关键词" [选项]

选项:

参数说明默认值
--pan <type>筛选网盘类型: quark, baidu, aliyun, uc, allall
--format <f>筛选音频格式: flac, ape, wav, dsd, hires, mp3, aac, allall
--limit <n>每个平台最大结果数5
--engine <e>搜索引擎: deep, webdeep

引擎说明:

  • deep(默认,推荐)— web-search 搜索发现资源页面 + JavaScript 深度页面抓取提取网盘链接和提取码,结果最准确
  • web — 仅从 web-search 搜索引擎摘要中提取链接(速度快,但准确率较低,不做深度抓取)

示例:

bash
# 搜索所有平台的音乐资源(默认使用深度搜索)
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" search "周杰伦 范特西"

# 只搜夸克网盘 FLAC 资源
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" search "周杰伦 范特西" --pan quark --format flac

# 搜索 Hi-Res 高解析音乐
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" search "邓紫棋 光年之外" --format hires

# 限制结果数量
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" search "林俊杰 她说" --limit 10

# 使用浅层搜索(不深度抓取页面)
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" search "陈奕迅 十年" --engine web

Windows 系统使用 PowerShell 脚本:

powershell
powershell -File "$SKILLS_ROOT/music-search/scripts/music-search.ps1" search "周杰伦 范特西" --pan quark
热门推荐
bash
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" hot "2025年热门专辑"

本质上是以推荐类关键词调用搜索,返回相关网盘资源。

解析跳转链接
bash
bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" resolve "https://example.com/goto/xxx"

当搜索结果中的链接需要二次跳转时,用此命令解析出真实网盘地址。

Agent 使用流程

  1. 用户说「帮我找 XXX 的音乐」→ 执行 search "XXX"
  2. 解析返回的 JSON,提取网盘链接
  3. 按网盘类型和音频格式分组呈现给用户
  4. 如果结果中有提取码 (extractCode),一并展示给用户
  5. 如果结果中有 pageUrl 但没有直接 url,用 resolve 命令获取真实地址

示例对话:

用户:帮我找一下周杰伦范特西专辑的无损资源,要FLAC格式

Agent:

  1. 执行 search "周杰伦 范特西" --format flac
  2. 从 JSON 结果中取出匹配项
  3. 返回:标题 + 格式 + 网盘链接 + 提取码(如有)

输出格式

所有命令输出 JSON,结构如下:

json
{
  "success": true,
  "data": {
    "query": "周杰伦 范特西",
    "total": 5,
    "results": [
      {
        "title": "资源标题",
        "pan": "quark",
        "url": "https://pan.quark.cn/s/xxx",
        "format": "FLAC",
        "extractCode": "ab12",
        "source": "deep-search",
        "pageUrl": "https://example.com/resource/123"
      }
    ]
  }
}

字段说明:

  • pan: 网盘类型 — quark(夸克), baidu(百度), aliyun(阿里), uc(UC), magnet(磁力)
  • format: 检测到的音频格式 — FLAC, APE, WAV, DSD, Hi-Res, AIFF, MP3, AAC, OGG, 空字符串表示未检测到
  • source: 结果来源 — deep-search(深度抓取), web-search(搜索摘要)
  • url: 网盘分享链接(可直接访问)
  • extractCode: 提取码/密码(如果检测到)
  • pageUrl: 结果来源页面 URL

配置

编辑 music-search/.env 可自定义偏好:

bash
# 偏好的网盘类型(逗号分隔,排在前面的优先展示)
MUSIC_SEARCH_PREFERRED_PAN=quark,aliyun,baidu,uc

# 深度搜索开关(推荐开启)
MUSIC_SEARCH_DEEP_ENABLED=true

# 每次搜索最多访问的结果页面数
MUSIC_SEARCH_DEEP_MAX_PAGES=6

# 并发抓取页面数
MUSIC_SEARCH_DEEP_CONCURRENCY=4

注意事项

  • 搜索建议使用中文歌手名+专辑名或歌曲名,效果最好
  • 深度搜索(--engine deep)比浅层搜索多 2-3 秒,但结果准确得多
  • 深度搜索需要 web-search skill 启用
  • 网盘分享链接可能随时失效,建议尽快使用

免责声明

本工具仅供个人学习和研究使用。不托管、不分发、不提供任何版权内容,仅聚合搜索引擎上公开可访问的链接。请遵守所在地区的法律法规。

© freestylefly, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in SKILLs/music-search of freestylefly/wesight.

  • SKILL.md
  • scripts/music-search.js
  • scripts/music-search.ps1
  • scripts/music-search.sh
  • scripts/shared/deep-extract.js

Open the folder on GitHubat commit c913cd9

Compare with similar skills

Music Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Music Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Music Search this skillfreestylefly/wesight946—~880Automated safety check: NotesMIT
AI Music Albumnexu-io/open-design100k—~328Automated safety check: PassApache-2.0
MiniMax Music Generationbytedance/deer-flow84k—~717Automated safety check: PassMIT
Music to Videoheygen-com/hyperframes60k3 repos~4.7kAutomated safety check: NotesApache-2.0
Venice Audio Musicnexu-io/open-design100k—~297Automated safety check: PassApache-2.0
Music Generation Studiosickn33/agentic-awesome-skills47k1 repos~3.1kAutomated safety check: PassMIT-0

Similar skills

  • AI Music Album

    nexu-io/open-design

    Full-lifecycle AI music album production — concept, lyric drafting, track sequencing, and export.

    100k GitHub stars~328 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • MiniMax Music Generation

    bytedance/deer-flow

    Generates songs, jingles or instrumental tracks as MP3 files from a style prompt and optional lyrics through the MiniMax music API.

    84k GitHub stars~717 tokensUpdated today
    Media & CreativeAuto-check passed
  • Music to Video

    heygen-com/hyperframes

    Turns a music track into a beat-synced HyperFrames video such as a lyric video, slideshow or kinetic promo, with any supplied images or clips cut onto the beat grid.

    60k GitHub starsUsed in 3 repos~4.7k tokens
    Media & CreativeAuto-check: notes
  • Venice Audio Music

    nexu-io/open-design

    Music generation queueing, retrieval, and completion endpoints via Venice.ai.

    100k GitHub stars~297 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Music Generation Studio

    sickn33/agentic-awesome-skills

    Install and use the official AI Music Generator package, pinned by digest, for paid hosted work on the Beatra service.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    Media & CreativeAuto-check passed
  • Video Downloader

    nexu-io/open-design

    Download videos from YouTube and other platforms for offline viewing, editing, or archival with support for various formats and quality options.

    100k GitHub stars~339 tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from freestylefly/wesight

All 17 skills in this repo
  • Develop Web Game

    freestylefly/wesight

    A skill your agent uses when Codex is building or iterating on a web game (HTML/JS) and needs a reliable development + testing loop: implement small changes, run a Playwright-based test script with…

    946 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Web Search

    freestylefly/wesight

    Real-time web search using Playwright-controlled browser. An agent skill from freestylefly/wesight.

    946 GitHub starsUsed in 1 repo~4k tokens
    Auto-check: notes
  • Technology Search

    freestylefly/wesight

    Search tech blogs, developer forums, and IT media (TechCrunch, Hacker News, 36氪, etc.) for software and hardware industry updates with heat ranking and EN↔CN translation.

    946 GitHub stars~3.3k tokensUpdated 9 days ago
    Auto-check passed
  • Content Planner

    freestylefly/wesight

    WeChat Official Account topic planning and content calendar management.

    946 GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check passed
  • Films Search

    freestylefly/wesight

    Search cloud drives for downloadable film and TV resources (movies, TV series, anime).

    946 GitHub stars~825 tokensUpdated 9 days ago
    Auto-check: notes
  • Create Plan

    freestylefly/wesight

    Create a concise plan. An agent skill from freestylefly/wesight.

    946 GitHub starsUsed in 4 repos~611 tokens
    Auto-check passed

Questions about Music Search

What does Music Search do?

Search cloud drives for downloadable music resources (songs, albums, lossless audio). Music Search is an agent skill from freestylefly/wesight. Search cloud drives for downloadable music resources (songs, albums, lossless audio).

When should I use Music Search?

Music Search fits situations like: the user wants to download a specific song; general music information; recommendations.

How do I install Music Search in Claude Code?

Run `npx skills add freestylefly/wesight --skill music-search -a claude-code`. Or copy the skill folder (SKILLs/music-search in freestylefly/wesight) into .claude/skills/music-search in your project. Claude Code loads it when a task matches its description.

How do I install Music Search in Codex?

Run `npx skills add freestylefly/wesight --skill music-search -a codex`. Or copy the skill folder (SKILLs/music-search in freestylefly/wesight) into .agents/skills/music-search in your project. Codex loads it when a task matches its description.

Can I use Music Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add freestylefly/wesight --skill music-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/music-search, .gemini/skills/music-search, .github/skills/music-search and .opencode/skills/music-search in your project.

What does Music Search need to run?

Going by SKILL.md and its folder, Music Search needs JavaScript, PowerShell and a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: Node.js; A Bash shell; PowerShell.

Does Music Search access the network?

SKILL.md names 1 domain. In commands or code: pan.quark.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Music Search safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Music Search use?

Music Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Music Search use?

About 880 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Music Search?

Skills that share tags, products or a category with Music Search: AI Music Album (nexu-io/open-design, 100k stars), MiniMax Music Generation (bytedance/deer-flow, 84k stars), Music to Video (heygen-com/hyperframes, 60k stars) and Venice Audio Music (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Music Search?

freestylefly (a GitHub user) maintains it in freestylefly/wesight, which has 946 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 1, 2026.

Source: freestylefly/wesight on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.