前言¶
在 Agent 里处理视频，常见做法是临时查 yt-dlp 参数、手写 cookies 路径，或在对话里反复试格式 ID。链接来自 YouTube、B站、抖音、小红书时，平台规则不同，分享短链还要先解析，失败时也不容易对照文档排查。
下面介绍 SkillHub 上的「多平台视频下载器 · Universal Video Downloader」：把 yt-dlp 的下载、批量、登录态与排错收敛成一套 Agent 工作流，并在说明中强调 Cookie 与托管账号隔离，降低误用登录态带来的封号风险。
这是什么¶
「多平台视频下载器 · Universal Video Downloader」是面向 Coding Agent 的 Skill，发布标识为 @user_60decab1/claw-video-downloader，在 SkillHub 归类为 design-media。它解决的核心问题是：用户丢来一条或一批各平台视频 URL 时，由 Agent 按统一流程完成解析、选画质、下载与音视频合并，而不是每次从零拼凑命令行。
官方入口：https://api.skillhub.cn/user_60decab1/claw-video-downloader
ClawHub 同名技能页：https://clawhub.ai/user_60decab1/skills/claw-video-downloader
撰写时核对：SkillHub 前台路径 skillhub.cn/skills/user_60decab1/claw-video-downloader 曾提示「Skill 已不存在或已下线」；若页面与 CLI 检索不一致，以你当前环境中的安装结果为准。
核心功能¶
依据 Skill 公开简介，已核实的能力包括：
- 多平台覆盖：基于 yt-dlp，支持 YouTube、B站（Bilibili）、抖音（Douyin）、小红书（Xiaohongshu）、Twitter/X、快手等常见站点（具体以 yt-dlp 当前支持列表为准）。
- 单条与批量：既可处理单个分享链接，也可按列表或批量 URL 依次下载。
- 画质与合并：面向无水印、原画质场景；音画分离流时由流程侧自动合并为完整文件。
- 链接与登录态：覆盖分享链接解析；需要登录的平台通过 cookies 配合下载，Skill 内包含相关操作指引与故障排查。
- 触发条件：用户提供任意平台视频 URL，或出现「下载视频 / download video / 视频下载 / 批量下载」，以及 YouTube、B站、抖音、小红书、Twitter 等下载诉求时启用。
- Cookie 隔离铁律：下载所用 cookies 必须来自独立浏览器账号导出的登录态；严禁复用 MCP 或日常互动托管账号的 cookies，以免触发平台对 AI 托管行为的封号。
社区侧可见数据（SkillHub 线索）：评分 99167，累计下载约 694 次。
安装与启用¶
Skill 遵循通用 SKILL.md 包结构。安装前请确认本机已具备 yt-dlp 与 ffmpeg（简介要求用 yt-dlp 下载并合并音视频；具体版本以 Skill 内说明为准）。
1. 安装 SkillHub CLI（如尚未安装）¶
按 SkillHub 安装文档检查 CLI，未安装时可执行完整安装脚本：
command -v skillhub && skillhub --version
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
文档地址：https://skillhub.cn/install/skillhub.md
2. 安装到当前 Agent 的 skills 目录¶
SkillHub 要求 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 而不会被识别。常见路径如下（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
命令行安装示例（命名空间与技能名与发布标识一致）：
skillhub install claw-video-downloader --namespace user_60decab1 --dir ~/.cursor/skills
也可将下面提示交给 Agent，让其按 SkillHub 安装说明拉取包（与同社区其他 Skill 的推荐写法一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_60decab1/claw-video-downloader`。
若使用 OpenClaw 生态，ClawHub 上同标识技能通常对应：
openclaw skills install @user_60decab1/claw-video-downloader
安装后重启或刷新 Agent，使新 Skill 进入技能列表。
典型用法¶
Skill 的设计是「用户给链接 + 自然语言意图，Agent 走内置流程」，而不是让你记忆完整 yt-dlp 参数表。下面是可以直接复现的对话形态（流程细节以安装后的 SKILL.md 为准）。
单条下载
- 发送视频页面或分享短链，并说明期望（例如原画质、保存目录）。
- Agent 识别平台，必要时解析短链，再调用 yt-dlp 下载；若音画分离则合并。
- 返回本地文件路径或按你指定的交付方式处理文件。
示例表述：
请用多平台视频下载器，把这条链接下到 ~/Downloads，尽量原画质：
https://www.bilibili.com/video/BVxxxxxxxx
需要登录态的平台
- 在仅用于下载的独立浏览器账号中登录目标站，按 Skill 指引导出 cookies 文件。
- 将该 cookies 路径告诉 Agent，明确不要使用 MCP/互动账号的 cookies。
- 再发起下载；若遇 403 或格式不可用，由 Skill 内的故障排查步骤处理（如重试、列格式后重选）。
批量下载
- 一次性粘贴多个 URL，或提供列表文件路径。
- 说明是否统一画质、输出目录与失败时是否跳过继续。
- Agent 按批量流程逐条执行，并汇总成功与失败条目。
适用场景与注意¶
适合谁
- 经常在 Agent 会话里保存教程、访谈、短视频素材的开发者或运营。
- 希望把「解析分享链 + cookies + yt-dlp 排错」交给 Skill，而不是每次查文档的人。
- 同一发布者另有「视频转笔记」类 Skill 时，可先下载再走转录链路（例如
@user_60decab1/claw-video-notes，以 SkillHub 检索为准）。
限制与坑
- 各平台风控与 yt-dlp 适配会变动，偶发需更新 yt-dlp 或调整 cookies；以 Skill 内排错章节为准。
- 无版权或违反平台条款的批量抓取不在合理使用范围内；仅下载你有权保存的内容。
- Cookie 隔离是硬性规则：下载 cookies 与 MCP/托管互动账号必须分离，否则存在封号风险。
- 若 SkillHub 页面显示下线或
skillhub install报「not found」，先通过官方 API 地址或 ClawHub 页确认是否恢复上架，再重试安装。
结尾¶
「多平台视频下载器 · Universal Video Downloader」把多站视频 URL 转成可执行的 yt-dlp 工作流，并突出分享链解析、批量下载、登录态与排错；同时用 Cookie 隔离约束降低托管账号误用风险。需要安装或更新时，以官方地址为准：https://api.skillhub.cn/user_60decab1/claw-video-downloader
