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/myAgent

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.5	$0.00040	$0.00516
Sonnet 5.5	$0.00020	$0.00258
Haiku 4.5	$0.00010	$0.00129

Measured 1mo ago against content hash 320288737511, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 1mo 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.

1mo 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 2mo ago), licensed MIT. It adds 100 tokens to every session and 1,290 once invoked, about $0.0004 per session on Opus 5.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

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

chronicle

Analyze Copilot session history for standup reports, usage tips, session search, and session reindexing. Use when the user asks for a standup, daily summary, usage tips, workflow recommendations, wants to search or find past sessions by keyword/file/PR, wants to reindex their session store, or asks about deleting…

microsoft/vscode · 72 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

component-fixtures

Use when creating or updating component fixtures for screenshot testing or their shared infrastructure, or when designing UI components to be fixture-friendly. Covers fixture file structure, theming, service setup, CSS scoping, async rendering, validation, and common pitfalls.