多平台视频下载器 · 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。
• 部分视频提示私有/已删 → 该视频已被作者设为私密或删除，无法下载。

Resources

• scripts/download_video.sh — 单条/批量下载 bash 脚本
• scripts/batch_download.py — 带进度与错误统计的 Python 批量下载器
• references/yt-dlp-options.md — yt-dlp 命令行参数全表
• references/supported-platforms.md — 各主流平台链接格式与下载要点
• references/cookie-isolation.md — ⚠️ Cookie 隔离铁律（封号教训）

Note: 需 yt-dlp 已安装。下载前务必确认 cookies 来自独立浏览号（见铁律）。下载完成后请校验文件再向用户回报。