yinxiao-downloader
从 sounds-mp3.com → poppop.ai → mixkit.co 搜索并下载免费音效。全程自动匹配，直接返回最佳结果的下载链接，不询问用户选择。
核心规则
- 免费商用，无需署名
- 自动选最佳，直接返回链接，不列候选单
- 只返回链接，不下载到本地
- 中英文关键词均可，优先英文
来源站操作
1️⃣ sounds-mp3.com（优先）
搜索：GET https://sounds-mp3.com/search/{关键词}（空格用 +）
- 无结果 → 页面含 "Nothing found!"
- 有结果 → 页面列出多个音效条目，每个条目标题含 <a href="/i-...">
自动匹配规则（每种音效单独打开详情页提取 MP3 链接）：
1. 从搜索结果列表中找出标题最匹配的 3-5 个候选
2. 逐个打开详情页（/i-{slug}），获取下载链接（/mp3/{数字}.mp3）
3. 标题关键词匹配度打分：
- 用户关键词全部命中标题 → 4分
- 命中 2 个以上 → 3分
- 命中 1 个核心词 → 2分
- 只有弱关联 → 1分
4. 标题语境判断加分：
- 含 "engine" "roar" "rumble" "heavy" "powerful" "starting" "departure" 等描述动作/力度的词 → +1分
- 标题描述的场景与用户需求最接近 → +1分
5. 选最高分，若有并列则选文件编号较大的（通常质量更好）
6. MP3 直链：https://sounds-mp3.com/mp3/{数字}.mp3
2️⃣ poppop.ai
翻分类页面找目标音效，卡片下载按钮地址为 https://poppop.ai/api/sfx/{id}/download
自动匹配逻辑同上：找出分类中最匹配的音效，返回下载链接。
3️⃣ mixkit.co
分类页：GET https://mixkit.co/free-sound-effects/{分类名}/
- 匹配 data-audio-player-preview-url-value="/sfx/{ID}/{ID}-preview.mp3" 提取 ID
- 标题在 preview-url 附近，找到 <h2 class="item-grid-card__title"><span>标题</span>
- 标题匹配度打分规则同上
- 下载：https://assets.mixkit.co/active_storage/sfx/{ID}/{ID}.wav
mixkit 已知分类名（直接作为 URL 路径）：transition, blow, cinematic, glitch, impact, slide, spin, stomp, sweep, swish, swoosh, thud, whip, whoosh, woosh, zoom, sword, punch, metal, magic, horror, cartoon, hit, nature/, technology/, funny/, notification/, animals/, transport/
自动流程
- 解析需求 → 提取 1-3 个英文关键词
- 搜 sounds-mp3.com → 按打分规则自动选最佳 → 返回链接
- 无匹配 → 搜 poppop.ai → 自动选最佳 → 返回链接
- 无匹配 → 找 mixkit.co 相关分类 → 按打分规则自动选最佳 → 返回链接
- 全无匹配 → 告知用户并建议换关键词
最终输出格式： 直接给出下载链接 + 简短说明（来源 + 文件名），不做选择题。
