视频下载工具

---

name: personal-video-dl

description: 视频下载工具，支持YouTube、Bilibili、抖音等数千个网站。触发词："下载视频"、"视频下载"

version: 1.0.0

---

# 视频下载工具

基于 yt-dlp 的强大视频下载工具，支持数千个视频网站。

功能特性

触发方式

下载视频 https://www.youtube.com/watch?v=xxxxx
视频下载 "B站链接" --audio-only
帮我下载这个视频：抖音链接

使用方法

命令行使用

# 下载单个视频（最佳质量）
python3 video_downloader.py "https://www.youtube.com/watch?v=xxxxx"

# 仅下载音频（MP3）
python3 video_downloader.py "URL" --audio-only

# 指定下载目录
python3 video_downloader.py "URL" -o ~/Desktop/Videos

# 下载带字幕
python3 video_downloader.py "URL" --subtitle

# 批量下载（从文件）
python3 video_downloader.py -f urls.txt

批量下载文件格式

创建 `urls.txt` 文件：

# 这是注释
https://www.youtube.com/watch?v=xxxxx
https://www.bilibili.com/video/xxxxx
https://v.douyin.com/xxxxx

参数说明

| 参数 | 说明 | 示例 |

|------|------|------|

| `url` | 视频链接 | `"https://..."` |

| `-f, --file` | 批量下载文件 | `-f urls.txt` |

| `-o, --output` | 下载目录 | `-o ~/Videos` |

| `-q, --quality` | 视频质量 | `-q best` |

| `-a, --audio-only` | 仅音频 | `--audio-only` |

| `-s, --subtitle` | 下载字幕 | `--subtitle` |

| `-p, --playlist` | 下载播放列表 | `--playlist` |

支持的平台

前置依赖

# 安装 yt-dlp
pip install -U yt-dlp

# 或使用脚本安装
python3 video_downloader.py --install

输出

故障排除

| 问题 | 解决方案 |

|------|----------|

| yt-dlp 未安装 | 运行 `pip install -U yt-dlp` |

| 下载失败 | 检查网络连接，部分网站需要代理 |

| 格式不支持 | 尝试更新 yt-dlp: `pip install -U yt-dlp` |

| 权限错误 | 检查下载目录写入权限 |

技术说明

文件结构

skills/video-downloader/
├── SKILL.md              # 本说明文件
└── video_downloader.py   # 主脚本

---

*Created: 2026-03-08*