多平台媒体下载技能

资源介绍

Qiaomu-download 是一项用于保存在线视频与音乐内容的 Agent 技能，适合需要收集视频素材、提取音频或保存字幕的用户。向 Agent 发送“下载这个：URL”或“保存这个：URL”即可触发；仅粘贴链接不会自动开始下载。它可处理 YouTube、B站、X、抖音、TikTok、小红书等链接，并内置微信视频号和 Spotify 单曲处理流程。下载后会检查文件大小、媒体流和时长，返回本地保存路径。对于需要登录、验证码或安全验证的平台，相关操作仍需由用户自行完成。

Skill 能力

一句话触发下载

用户在提供 HTTPS 链接时表达“下载”或“保存”意图即可触发处理，无需先说明链接属于视频或音乐。

多平台媒体保存

可通过 yt-dlp 动态探测并下载多类站点媒体，已列出 YouTube、Bilibili、X、抖音、TikTok、小红书、Instagram、Vimeo、Twitch、微博和 AcFun 等平台。

音频、字幕与信息提取

除视频下载外，还可将支持的媒体提取为 MP3、下载指定语言字幕，或只读取媒体信息而不下载文件。

Spotify 单曲匹配

针对 Spotify 单曲链接读取公开曲目信息，从公开视频源匹配音频并输出 MP3，同时写入标题、艺人和专辑标签；不提取 Spotify 加密音频。

微信视频号内置处理

安装包包含微信视频号适配器；需要本地连接时会提示用户手动打开并播放视频，不通过界面自动化控制微信。

下载结果验真

完成下载后使用 ffprobe 检查文件是否存在、是否包含预期音视频流及有效时长，再返回文件路径、编码、分辨率等结果。

资源配置

适用平台

通用 Agent

支持模型

模型无关

调用方式

自动触发命令调用Agent调用规则匹配手动调用

安装与调用

1. 01

   安装 Skill，并准备 Python 3.10+、yt-dlp、ffmpeg 和 ffprobe。

2. 02

   向 Agent 提供一个 HTTPS 链接，并明确说“下载这个”“保存这个”或提出提取 MP3、字幕、媒体信息等需求。

3. 03

   如需控制结果，可指定清晰度、字幕语言或保存目录；默认保存到 ~/Downloads。

4. 04

   等待任务完成后，根据返回的绝对路径获取已通过媒体检测的视频、音频或字幕文件。

使用案例

保存短视频素材

使用场景内容创作者需要收集公开短视频作素材整理。

发送“下载这个：https://v.douyin.com/...”，技能会解析链接并将可下载媒体保存到本地，完成后返回文件路径和媒体信息。

提取视频音频

使用场景用户希望把 YouTube 视频保存为音频文件，用于个人离线收听。

发送“把这个 YouTube 视频提取成 MP3：https://youtu.be/...”，技能会生成并验证 MP3 文件。

下载 Spotify 单曲

使用场景用户需要保存一首 Spotify 链接对应的公开音频版本。

发送“下载这首：https://open.spotify.com/track/...”，技能读取公开曲目信息并匹配公开视频音源，输出带曲目标签的 MP3。

包含内容

✓

qiaomu-download-source.zip

✓

README-中文安装说明.md

✓

LICENSE-MIT.txt

✓

SHA256.txt

常见问题

只发送一个链接会自动下载吗？

不会。该技能要求同时具备明确的下载或保存意图和一个 HTTPS 链接；单独粘贴 URL 不会触发下载。

下载文件默认保存在哪里？

默认保存到 ~/Downloads。可通过 --dir 参数或 QIAOMU_DOWNLOAD_OUTPUT 指定其他输出目录。

Spotify 链接会直接下载 Spotify 音频吗？

不会。该技能只读取 Spotify 公开页面的曲目信息，再匹配一个公开视频音源生成 MP3；不读取 Spotify 客户端缓存，也不绕过 DRM。

遇到登录、验证码或会员限制时会自动处理吗？

不会。技能不输入账号、密码、验证码或 2FA，也不绕过付费墙、DRM、地区限制及其他访问控制；用户需要自行完成必要的登录或验证。

微信视频号下载时为什么可能需要手动播放？

当本地连接需要页面媒体状态时，技能会要求用户在电脑微信中手动打开并播放一次视频，再继续下载；它不会通过 UI 自动化点击或控制微信。