前言¶
在 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
