A tool for identifying songs from clues such as lyrics, melody descriptions, singer details, language, era, or cover versions. After the user confirms a match, it downloads the song as an MP3 or FLAC file.

Use it to find songs, identify original or cover versions, compare likely candidates, download confirmed tracks, and check their file format and metadata.

It helps when the song title or artist is unknown and memories may be incomplete or inaccurate. It searches several music databases and platforms, then checks possible matches against the clues.

song-finder — Skill for Claude Code and Codex by idea2realClaw

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add idea2realClaw/myAgent --skill song-finder

Clone the repo

git clone --depth 1 https://github.com/idea2realClaw/myAgent

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/idea2realclaw/myagent/song-finder/github.svg)](https://agentmods.dev/skills/idea2realclaw/myagent/song-finder)

Your own site

<a href="https://agentmods.dev/skills/idea2realclaw/myagent/song-finder"><img src="https://agentmods.dev/badge/skills/idea2realclaw/myagent/song-finder/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/idea2realclaw/myagent/song-finder"><img src="https://agentmods.dev/badge/skills/idea2realclaw/myagent/song-finder.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 100 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,290 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00100	$0.01290
Opus 5	$0.00050	$0.00645
Sonnet 5	$0.00020	$0.00258
Haiku 4.5	$0.00010	$0.00129

Measured 10d ago against content hash 320288737511, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

song-finder scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/download.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/song-finder/SKILL.md · 100 lines

How it starts

The opening of the file, as written. The whole thing — 100 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Song Finder — 找歌 & 下载

概述

根据用户的模糊线索找到歌曲，确认后下载高品质 MP3（优先 320kbps）。

依赖

Python 3.7+
已安装: pip install musicdl ffmpeg-python
系统工具: ffmpeg（用于格式转换）

工作流程

Phase 1: 线索分析与多源搜索

解析用户线索：提取关键词，识别以下维度：
- 歌名/歌词片段
- 歌手/乐队名称（含别名、外文名）
- 年代/时期
- 语言（中文/英文/其他）
- 音乐风格（和声、假声、摇滚、迪斯科等）
- 翻唱/原唱关系
- 专辑/磁带/黑胶等载体信息
多源搜索（按优先级依次尝试）：
- web_search 搜索：歌词+歌手+年代等组合关键词
- 豆瓣音乐、Discogs、SecondHandSongs 等数据库
- YouTube、B站等平台
交叉验证：将搜索结果与用户线索逐一比对，确认匹配度

Phase 2: 确认与深化

向用户呈现候选结果：列出最匹配的 2-3 个选项，附带：
- 歌手/乐队背景
- 所属专辑
- 翻唱关系（如适用）
- 与用户线索的匹配说明
用户确认后进入下载阶段；若都不匹配，根据用户新线索继续搜索

Phase 3: 下载

调用 scripts/download.py 完成搜索和下载：
```
python3 scripts/download.py --keyword "歌手 歌名" --output /path/to/save [--source SOURCE] [--quality 320] [--format mp3]
```
- --source: 可选 kugou/netease/qq/kuwo/migu，默认自动选择
- --quality: 128/320/1000(lossless)，默认 320
- --format: mp3/flac，默认 mp3
- 脚本输出 MP3 文件路径和元数据
验证文件：检查文件大小、格式、ID3标签
发送给用户：通过 deliver_attachments 发送 MP3 文件

关键经验

搜索策略

用户记忆可能有偏差（记混歌名、年代、语言等），先广后窄
中文歌名搜索不到时，尝试英文原名；反之亦然
"雪莉" 可能是 Sherry、Cheri Cheri Lady 等不同歌曲的中文翻译
台湾乐队在大陆引进时经常改名（如"印象合唱团"→"猛虎队"）
SecondHandSongs 是查翻唱关系的最佳数据库（但可能有反爬）

下载技术栈

musicdl (v2.11+): 核心下载库，支持 40+ 平台，2026 年仍在维护
- v2.11+ API 变更: 不再有 MusicClient 统一入口，需直接导入各源 Client
- 导入方式: from musicdl.modules.sources.kugou import KugouMusicClient
- 搜索: client = KugouMusicClient(); results = client.search(keyword='...')
- 下载: downloaded = client.download(song_infos=[results[0]])
- 返回 list[SongInfo]，不再是 dict
- SongInfo 属性: song_name, singers, album, ext, file_size, download_url, lyric, duration
- 下载后通过 downloaded[0].work_dir 找到下载目录
酷狗移动端 API 可直接搜索（不需要认证）：
- http://mobilecdnbj.kugou.com/api/v3/search/song?keyword=...&page=1&pagesize=20&platid=4
网易云 API（仅非 VIP 免费）：
- http://music.163.com/song/media/outer/url?id={ID}.mp3
ffmpeg 用于 FLAC→MP3 转换：ffmpeg -i input.flac -codec:a libmp3lame -b:a 320k output.mp3

Read the full file on GitHub · 100 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

scripts/download.py 8.5 KB runs code

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

10d ago First seen · 100 lines · 100 tokens per session scan A 320288737511

Subscribe to this mod's changes

song-finder is a skill published in the GitHub repository idea2realClaw/myAgent (2 stars, last pushed 21d ago), licensed MIT. It adds 100 tokens to every session and 1,290 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Creative and media

webgl-holographic-foil

A self-contained WebGL2 hero: thin-film interference over a crushed-foil surface whose palette shifts with the viewing angle; move the cursor to tilt the film.

nexu-io/open-design · 41 tokens

general-video

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated…

heygen-com/hyperframes · 92 tokens

html-ppt-hermes-cyber-terminal

OpenDesign + BYOK: choosing and wiring your own model, hands-on — cost, quality, and the routing decision. Built as a decision-grade AI literacy deck for engineers, IT, applied-AI teams.

nexu-io/open-design · 53 tokens

html-ppt-taste-brutalist

16:9 HTML deck in tactical-telemetry / CRT-terminal taste. Deactivated-CRT charcoal slides, white-phosphor monospace, hazard-red accent, scanline overlay, ASCII syntax, density over decoration. Distilled from Leonxlnx/taste-skill brutalist-skill (Tactical Telemetry mode).

nexu-io/open-design · 78 tokens

diagnostic-stem-delivery

Audio production with diagnostic analysis, timecode parsing from documents, and verified export workflow.

HKUDS/OpenSpace · 23 tokens

chengfeng-check-updates

An environment manager for a video-editing system. It checks whether its skills and runtime—the software needed to run them—are installed and compatible.

Agentchengfeng/chengfeng-videocut-skills · 120 tokens