多平台视频下载器 · Universal Video Downloader

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

用 yt-dlp 一键下载各大平台视频（YouTube、B站/Bilibili、抖音/Douyin、小红书/Xiaohongshu、Twitter/X、快手等），支持单条与批量、无水印原画质、自动合并音视频。覆盖分享链接解析、登录态 cookies、批量下载与故障排查。强制遵循「Cookie 隔离铁律」：下载用 cookies 必须来自独立浏览号，严禁复用 MCP/互动账号 cookies（会触发 AI 托管封号）。 Use when the user provides a video URL fr

多平台视频下载器 · Universal Video Downloader

功能概述

多平台视频下载器 · Universal Video Downloader是一项面向实际任务的技能，主要用于用 yt-dlp 下载各大平台的视频——不止小红书，YouTube、B站、抖音、Twitter/X、快手等都能下；支持单条分享链接下载、批量下载、无水印原画质、自动合并音视频流；

核心要点

底层就是 yt-dlp，它原生支持上千个站点；
本技能把「单条/批量下载 + 登录态 + 故障排查」打包成开箱即用的工作流。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

多平台视频下载器 · Universal Video Downloader

用 yt-dlp 下载各大平台的视频——不止小红书，YouTube、B站、抖音、Twitter/X、快手等都能下。支持单条分享链接下载、批量下载、无水印原画质、自动合并音视频流。

底层就是 yt-dlp，它原生支持上千个站点。本技能把「单条/批量下载 + 登录态 + 故障排查」打包成开箱即用的工作流。

⚠️ Cookie 隔离铁律（必读，违规会封号）

下载用的 cookies 必须来自【独立的浏览号】（你自己日常刷对应平台的那个浏览器账号）。 绝对禁止把任何 MCP / 互动自动化账号的 cookies 用于 yt-dlp 下载。

原因与惨痛教训见 references/cookie-isolation.md：同一账号的下载 bot 行为会被风控关联到发帖/互动行为，判定为「AI 托管」直接封号，且可能永久。

正确做法（二选一）：

推荐：yt-dlp --cookies-from-browser chrome（读本地浏览器的 cookies，与互动号物理隔离）
或导出浏览号 cookies 文件：yt-dlp --cookies /path/to/browsing_account_cookies.txt

绝不这样做： 把 MCP 互动号的 cookies.json 传给 yt-dlp。

Prerequisites（前置依赖）

yt-dlp 必须已安装。未装则任选一种：

pip install -U yt-dlp        # 推荐，保持最新（各平台风控常变，旧版易失效）
brew install yt-dlp           # macOS
# 或下载二进制：https://github.com/yt-dlp/yt-dlp#installation

关于「直下是否还有效」：YouTube/B站大多可免登录直下；但小红书、抖音等风控已升级，无 cookies 的纯公开访问对多数视频会失效（报 Unable to download webpage）。请按上方铁律提供浏览号 cookies 再下这些平台。
可选：ffmpeg（合并音视频流时需要，yt-dlp 会自动调用）。

Workflow（工作流）

Step 1 · 接收视频链接

用户给出任意平台链接，例如：

YouTube：https://www.youtube.com/watch?v=xxxx / https://youtu.be/xxxx
B站：https://www.bilibili.com/video/BVxxxx / https://b23.tv/xxxx
抖音：https://www.douyin.com/video/xxxx（App 分享短链需先展开）
小红书：https://www.xiaohongshu.com/explore/xxxx / discovery/item/xxxx
Twitter/X：https://x.com/user/status/xxxx
快手、微博、TikTok 等 yt-dlp 支持的站点同理。

Step 2 · 预检（不下载，先试解析）

yt-dlp --simulate "视频URL" --cookies-from-browser chrome

能返回标题/格式即说明可下；失败先把 cookies 准备好（尤其小红书/抖音）。

Step 3 · 下载

单条（默认模板，无水印原画）：

yt-dlp "视频URL" --cookies-from-browser chrome -o "%(title)s.%(ext)s"

指定输出目录：

yt-dlp "URL" --cookies-from-browser chrome -o "~/Downloads/%(title)s.%(ext)s"

批量（每行一个 URL 的文本文件）：

yt-dlp -a urls.txt --cookies-from-browser chrome -o "%(title)s.%(ext)s" -i

或直接用附带脚本：

bash scripts/download_video.sh urls.txt ~/Downloads      # 读文件批量
bash scripts/download_video.sh "URL" ~/Downloads         # 单条
python3 scripts/batch_download.py -i urls.txt -o ./downloads

Step 4 · 校验

ls -lh ""

确认文件存在且大小非 0。

Step 5 · 回报用户

告知：下载位置、文件名、大小、时长（如有）。

常用参数速查

-f best 最佳画质；-f "bestvideo+bestaudio" 最佳音视频（需 ffmpeg 合并）
-r 1M 限速；-R 50 重试次数；--retry-sleep 5 重试间隔
--write-info-json 顺带保存元数据；--no-warnings 静默警告
--restrict-filenames 文件名仅 ASCII（避免中文/特殊字符问题）
完整参数见 references/yt-dlp-options.md；各平台结构与要点见 references/supported-platforms.md

故障排查

ERROR: Unable to download webpage → 多半是未登录/风控（尤其小红书、抖音）。先加 --cookies-from-browser chrome；仍失败换最新 yt-dlp（yt-dlp -U）或换新分享链接。
... Unsupported URL → 链接格式变了或 yt-dlp 过旧，更新后重试；也可 yt-dlp --list-extractors | grep -i <平台> 确认有对应提取器。
giving up after N retries → 网络不稳，加 -R 50 --retry-sleep 5。
部分视频提示私有/已删 → 该视频已被作者设为私密或删除，无法下载。