Video Download

This is your canonical entry point for downloading videos from Chinese and Western social platforms. It handles Douyin, Xiaohongshu, Bilibili, TikTok, YouTube, Twitter, and Instagram through a unified interface that picks the right engine automatically: Playwright for Chinese platforms, CDP with tikwm fallback for TikTok, yt-dlp for everything else. The Bilibili flow is thoughtful, it checks login status first since you need auth for anything above 480p, then walks you through browser login if needed. TikTok gets special treatment with CDP priority and detailed metadata output including validation flags. If you're batch processing Lark tables with mixed social URLs, this keeps you from writing七个 different download implementations.

skills.sh installs: 208
GitHub stars: 4
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add csfuwwc/md-skills --skill video-download --agent claude-code

Installs into .claude/skills of the current project.

Files

视频下载（视频号 / 抖音 / 小红书 / B站 + YouTube / Twitter 等）

统一入口原则（重要）

本 skill 是社媒视频下载的唯一入口。
当任务来自飞书多维表格（Base）/表格批处理时，下载动作也必须调用本 skill 的 scripts/download.py，不要在业务脚本里另写直连下载器。
需要正文/点赞/收藏时，可以在业务脚本里各自抓取；但“视频文件获取”必须复用本 skill 的下载链路与校验能力。

从分享链接下载视频到本地。视频号使用用户配置的自托管解析器取得临时直链；B站优先使用 yt-dlp，失败后回退 Playwright；抖音/小红书优先使用 Playwright，抓流失败后回退 yt-dlp；TikTok 优先使用真实浏览器 CDP 抓流。

下载流程

重要：下载 B站视频前，必须先检查登录状态（未登录只能获取 480p）。

先进入 skill 根目录后再执行以下命令（命令均使用相对路径）：

cd <your-skill-root>/video-download

步骤 1：检查登录状态（B站必须）

python3 ./scripts/download.py check-login bilibili

退出码 0（输出 LOGIN_OK）→ 直接跳到步骤 3 下载
退出码 2（输出 LOGIN_REQUIRED）→ 需要执行步骤 2 登录

步骤 2：交互式登录（需要时）

当 check-login 返回退出码 2 时，按以下流程操作：

后台启动登录浏览器（设置 block_until_ms: 0）：

python3 ./scripts/download.py login bilibili --signal-file /tmp/video_dl_login_done

立即向用户展示确认按钮，使用 AskQuestion 工具：
- 提示：「已打开 B站登录页面，请在浏览器中完成登录，完成后点击下方确认按钮。」
- 选项 A：「已完成登录」
- 选项 B：「跳过登录（使用低画质）」
用户点击确认后：
- 选择 A：创建信号文件 touch /tmp/video_dl_login_done，等待登录脚本退出，然后继续下载
- 选择 B：终止登录脚本进程，直接下载（低画质）
兜底：如果用户直接关闭了浏览器窗口，登录脚本会自动检测到并保存 cookie，无需信号文件。