gequhai-music
搜索和下载歌曲海(gequhai.com)的音乐，支持搜索歌曲、获取下载链接（优先无损/高品质）， 并可一键下载到群晖NAS。当用户询问歌曲、搜索音乐、或想下载歌曲时使用此技能。
Best use case
gequhai-music is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
搜索和下载歌曲海(gequhai.com)的音乐，支持搜索歌曲、获取下载链接（优先无损/高品质）， 并可一键下载到群晖NAS。当用户询问歌曲、搜索音乐、或想下载歌曲时使用此技能。
Teams using gequhai-music should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/gequhai-music/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How gequhai-music Compares
| Feature / Agent | gequhai-music | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
搜索和下载歌曲海(gequhai.com)的音乐，支持搜索歌曲、获取下载链接（优先无损/高品质）， 并可一键下载到群晖NAS。当用户询问歌曲、搜索音乐、或想下载歌曲时使用此技能。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# 歌曲海 (Gequhai) 音乐搜索与下载技能
搜索歌曲海音乐，支持下载到群晖NAS。
## 功能
1. **搜索歌曲** - 按歌名/歌手搜索
2. **获取下载链接** - 优先无损/高品质，其次是标准品质
3. **排行榜** - 热门榜、新歌榜、飙升榜、抖音榜等
4. **下载到群晖** - 一键添加到群晖DownloadStation
## 网站信息
- 网站：https://www.gequhai.com/
- 特点：免费音乐搜索下载，支持高品质/无损音乐
## 下载链接类型
| 类型 | 说明 | 可下载到群晖 |
|------|------|-------------|
| 标准品质（API） | 通过API获取的直接mp3链接 | ✅ 可以 |
| 高品质（直接链接） | 页面上的直接mp3/flac链接 | ✅ 可以 |
| 高品质（网盘链接） | 夸克网盘等分享链接 | ❌ 需手动下载 |
**重要：** API请求需要带上 `X-Custom-Header: SecretKey` 才能成功！
## 使用方法
### 1. 搜索歌曲
```bash
python scripts/gequhai_crawler.py --search "青花瓷"
```
### 2. 获取歌曲详情和下载链接
```bash
python scripts/gequhai_crawler.py --detail 553
```
### 3. 搜索并下载
```bash
python scripts/gequhai_crawler.py --download "周杰伦 晴天"
```
### 4. Python脚本调用
```python
from scripts.gequhai_crawler import search_songs, get_download_url, download_song
# 搜索歌曲
songs = search_songs("青花瓷")
for s in songs[:5]:
print(f"[{s['id']}] {s['title']} - {s['artist']}")
# 获取下载链接
detail = get_download_url("553")
print(f"标题: {detail['title']}")
print(f"下载链接: {detail.get('url', detail.get('netdisk_url'))}")
print(f"品质: {detail.get('quality')}")
# 下载到群晖
result = download_song(detail, destination="download/音乐下载")
print(f"下载结果: {result}")
```
## 群晖下载配置
| 配置项 | 值 |
|--------|-----|
| 主机 | `192.168.123.223:5000` |
| 用户 | `xiaoai` |
| 默认下载目录 | `download/音乐下载` |
## 交互流程示例
用户问：**帮我下载周杰伦的青花瓷**
1. 搜索"青花瓷"
2. 获取第一首歌的下载链接
3. 如果是直接链接 → 添加到群晖下载
4. 如果是网盘链接 → 告知用户网盘地址
用户问：**最近有什么好听的歌？**
1. 获取热门歌曲列表
2. 展示给用户选择
3. 用户选择后下载
## 注意事项
1. **API验证**：必须带上 `X-Custom-Header: SecretKey` header，否则API返回403
2. **Session**：需要使用Session保持cookie，先访问播放页再请求API
3. **下载链接类型**：高品质版本通常是网盘链接，标准品质是直接mp3链接
4. **请求频率**：避免频繁请求，以免被封IP
## 关键代码
```python
# API请求必须带上这个header
api_headers = {
"X-Requested-With": "XMLHttpRequest",
"X-Custom-Header": "SecretKey", # 关键！
}
# 使用Session保持cookie
session = requests.Session()
# 先访问播放页面获取cookie
session.get(f"{BASE_URL}/play/{song_id}")
# 再请求API
session.post(f"{BASE_URL}/api/music", headers=api_headers, data={...})
```
## 错误处理
| 错误 | 原因 | 解决方案 |
|------|------|----------|
| 未找到歌曲 | 关键词不匹配 | 尝试其他关键词 |
| 没有下载链接 | 歌曲暂无资源 | 换一首歌 |
| 网盘链接 | 高品质版本在网盘 | 手动下载或使用标准品质 |Related Skills
ohyesai-music
Generate custom music tracks (vocal or instrumental) via OhYesAI asynchronously.
🎵 Play Music Skill
**Controlled music player with pause/resume/stop support**
home-music
Control whole-house music scenes combining Spotify playback with Airfoil speaker routing. Quick presets for morning, party, chill modes.
Music Playlist Generation (PlaylistGen)
LLM-powered playlist generation for your local music library that contains music audio files such as mp3, flac, m4a, etc. Integrate this skill with your Agents (e.g., OpenClaw) to enable natural language music discovery and playlist curation through conversation. Point it at your music folder, run the indexer once, and get a natural language playlist generator — accessible via web browser or API.
asmr-music
Provide professional ASMR music recommendations and playback services to help users achieve sleep aid, heart rate regulation, and focus enhancement through scientifically designed audio. Use when user wants to (1) relax, sleep, or fall asleep, (2) regulate heart rate or relieve anxiety, (3) improve focus and concentration for study or work, (4) find background white noise or ambient sounds, (5) practice meditation or deep breathing, (6) set up automatic daily reminders for ASMR listening. Keywords: sleep, relax, meditation, heart rate, anxiety, focus, concentration, white noise, ASMR, background music, calming, stress relief, daily reminder, nightly routine.
apple-music-dj
Ultimate personalization engine for Apple Music. Analyzes listening history, Apple Music Replay stats, library data, and taste patterns to create intelligent playlists directly in the user's Apple Music library via the MusicKit API. Supports deep cuts discovery, mood/activity playlists, trend scouting, constellation discovery ("surprise me"), playlist refresh/evolution, automated weekly curation via cron, taste DNA cards, compatibility scoring, listening insights, catalog gap analysis, album deep dives, artist rabbit holes, daily song drops, concert prep, and personalized new release radar. Use this skill whenever the user mentions Apple Music, playlists, music recommendations, listening habits, music taste, "what should I listen to", discovering new music, mood playlists, workout playlists, deep cuts, hidden gems, trending music, "surprise me", refreshing a playlist, or anything related to curating their music experience. Also trigger on: "DJ", "mix", "playlist for", "music for", "songs like", "similar to", "what's hot", "new releases for me", "taste DNA", "taste card", "compatibility", "how compatible", "year in review", "listening stats", "what have I missed", "album deep dive", "rabbit hole", "concert prep", "seeing [artist] live", "daily song", "what should I listen to right now", or OpenClaw in the context of music.
🎛️ CLAW.FM ACID TECHNO LIVE MUSICIAN
**Transform your OpenClaw AI agent into an autonomous acid techno producer crafting hyperpop-chaos bangers inspired by Le Wanski and Fred again...**
aimlapi-music
Generate high-quality music/songs via AIMLAPI. Supports Suno, Udio, Minimax, and ElevenLabs music models. Use when the user asks for music, songs, or soundtracks with specific lyrics or styles.
youtube-music-cast
Download music from YouTube/YouTube Music and stream to Chromecast via Home Assistant. Complete CLI toolset with web server integration, configuration wizard, and playback controls.
music-analysis
Analyze music/audio files locally without external APIs. Extract tempo, pocket/groove feel, pulse stability, swing proxy, section/repetition structure, key clarity, harmonic tension, timbre descriptors, temporal mood-energy journeys, and lyric-aware emotional reads where real Whisper lyrics can override the vibe when the words are clearly darker, warmer, or more intense than the arrangement alone suggests. Use when asked to 'listen to this', 'hear the music', audit tracks, compare mixes, inspect structure, or generate producer-facing notes from audio files.
desktop-music-launcher
检索本机已安装音乐软件，启动它，并根据用户需求推荐、搜索或播放歌曲；在 macOS 上可用 AppleScript 控制 Spotify 和 Apple Music，并为 Spotify 增加可选的精确点播链路。
music-manager
通用音乐下载管理器。支持从YouTube/Bilibili搜索下载音乐，自动转MP3，按分类存入本地音乐库