SuperAPI AI 工具集

music-search

通用与其它

查看项目

更新于 10-16 08:53

技能介绍

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

用途

该技能主要帮助用户从多个网盘平台查找音乐资源链接,覆盖夸克网盘、百度网盘、阿里云盘、UC网盘等,可搜索歌曲、专辑及无损音乐,并支持按音频格式筛选。

主要能力

  • 搜索音乐资源,返回网盘分享链接,并尽可能提供提取码与来源页面地址。
  • 按网盘类型筛选:quark、baidu、aliyun、uc、all(默认 all)。
  • 按音频格式筛选:flac、ape、wav、dsd、hires、mp3、aac、all(默认 all)。
  • 提供两种搜索引擎:
    • deep(默认,推荐):通过 web-search 搜索发现资源页面,并使用 cloudscraper 深度抓取提取网盘链接和提取码,结果最准确。
    • web:仅从 web-search 搜索引擎摘要中提取链接,速度快但准确率较低,不做深度抓取。
  • 支持限制每个平台的最大结果数(--limit,默认 5)。
  • 提供 hot 命令,以推荐类关键词调用搜索,返回相关网盘资源。
  • 提供 resolve 命令,当搜索结果中的链接需要二次跳转时,解析出真实网盘地址。
  • 所有命令输出结构化 JSON,便于程序或 Agent 解析处理。

前置条件

  • web-search skill(必需,用于搜索发现资源页面)。
  • Python 3(必需,用于 cloudscraper 深度页面抓取。依赖首次运行时自动安装到 .venv)。

使用方式

搜索资源:

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

示例:

搜索所有平台的音乐资源(默认使用深度搜索)

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 -File "$SKILLS_ROOT/music-search/scripts/music-search.ps1" search "周杰伦 范特西" --pan quark

热门推荐:

bash "$SKILLS_ROOT/music-search/scripts/music-search.sh" hot "2025年热门专辑"

解析跳转链接:

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 命令获取真实地址。

输出格式

所有命令输出 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 可自定义偏好:

偏好的网盘类型(逗号分隔,排在前面的优先展示)

MUSIC_SEARCH_PREFERRED_PAN=quark,aliyun,baidu,uc

深度搜索开关(推荐开启)

MUSIC_SEARCH_DEEP_ENABLED=true

每次搜索最多访问的结果页面数

MUSIC_SEARCH_DEEP_MAX_PAGES=6

并发抓取页面数

MUSIC_SEARCH_DEEP_CONCURRENCY=4

适用场景

  • 用户需要查找某首歌曲或某张专辑的网盘资源链接时。
  • 用户希望获取特定格式(如 FLAC、Hi-Res)的无损音乐时。
  • Agent 需要在对话中替用户检索音乐资源并返回链接与提取码时。
  • 需要解析二次跳转链接以获取真实网盘地址时。

限制与注意事项

  • 搜索建议使用中文歌手名+专辑名或歌曲名,效果最好。
  • 深度搜索(--engine deep)比浅层搜索多 2-3 秒,但结果准确得多。
  • 首次使用时会自动安装 Python cloudscraper 到 .venv(需要 Python 3)。
  • 深度搜索需要 web-search skill 启用,首次搜索可能需要等待浏览器启动。
  • 网盘分享链接可能随时失效,建议尽快使用。
  • 本工具仅供个人学习和研究使用。不托管、不分发、不提供任何版权内容,仅聚合搜索引擎上公开可访问的链接。请遵守所在地区的法律法规。

费用、价格、平台支持范围等更多信息暂未提供。