# Yt Dlp Downloader

> 下载视频和音频的通用工具。支持 YouTube、Bilibili、Twitter/X、抖音、快手等数千个网站。当用户提供视频链接时自动下载到 ~/Downloads 文件夹。

- Skill: `azure12355/yt-dlp-downloader` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add azure12355/yt-dlp-downloader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/azure12355/yt-dlp-downloader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: azure12355 (https://skillmd.com/u/azure12355)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/azure12355/yt-dlp-downloader

---


# yt-dlp 视频下载器

## 功能概述

使用 yt-dlp 下载视频和音频，支持数千个网站：
- **视频平台**: YouTube, Bilibili, 抖音, 快手, Twitter/X, Instagram, TikTok, Vimeo
- **社交媒体**: 微博, 小红书, Facebook, Reddit
- **其他**: TED,Coursera, 各种新闻网站等

## 默认下载位置

所有下载默认保存到: `~/Downloads/`

## 使用方式

### 基础视频下载
当用户提供视频链接时，自动下载最佳质量的视频：

```bash
yt-dlp -o "~/Downloads/%(title)s.%(ext)s" "<VIDEO_URL>"
```

### 下载选项

#### 1. 最佳质量视频（默认）
```bash
yt-dlp -f "bestvideo+bestaudio/best" \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"
```

#### 2. 仅下载音频（MP3）
```bash
yt-dlp -x --audio-format mp3 \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"
```

#### 3. 下载字幕
```bash
yt-dlp --write-subs --write-auto-subs --sub-lang zh-Hans,zh,en \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"
```

#### 4. 下载整个播放列表
```bash
yt-dlp -o "~/Downloads/%(playlist_title)s/%(title)s.%(ext)s" \
  "<PLAYLIST_URL>"
```

#### 5. 查看可用格式
```bash
yt-dlp -F "<VIDEO_URL>"
```

#### 6. 下载特定格式
```bash
yt-dlp -f "137+140" \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"
```

## 常用参数说明

| 参数 | 说明 |
|------|------|
| `-o` | 输出文件名模板 |
| `-f` | 格式选择 |
| `-F` | 列出所有可用格式 |
| `-x` | 仅提取音频 |
| `--audio-format` | 音频格式 (mp3, m4a, etc.) |
| `--write-subs` | 下载字幕 |
| `--write-auto-subs` | 下载自动生成的字幕 |
| `--sub-lang` | 字幕语言 |
| `--no-playlist` | 不下载播放列表 |
| `--playlist-items` | 下载播放列表中的特定项 |
| `--limit-rate` | 限制下载速度 |
| `--proxy` | 使用代理 |

## 文件名模板变量

| 变量 | 说明 |
|------|------|
| `%(title)s` | 视频标题 |
| `%(id)s` | 视频ID |
| `%(ext)s` | 文件扩展名 |
| `%(uploader)s` | 上传者 |
| `%(upload_date)s` | 上传日期 |
| `%(duration)s` | 时长（秒） |
| `%(resolution)s` | 分辨率 |
| `%(playlist_title)s` | 播放列表标题 |

## 工作流程

当用户提供视频链接时：

1. **解析链接**: 确认网站类型和视频可用性
2. **询问需求**: 是否需要特定格式或质量
3. **执行下载**: 使用合适的参数下载
4. **返回结果**: 告知下载位置和文件名

## 示例交互

**用户**: 下载这个视频 https://www.youtube.com/watch?v=xxxxx

**助手**: 正在下载视频...
```bash
yt-dlp -f "bestvideo+bestaudio/best" \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "https://www.youtube.com/watch?v=xxxxx"
```
下载完成！文件保存在: ~/Downloads/视频标题.mp4

---

**用户**: 只要音频

**助手**: 正在提取音频...
```bash
yt-dlp -x --audio-format mp3 \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "https://www.youtube.com/watch?v=xxxxx"
```
下载完成！文件保存在: ~/Downloads/视频标题.mp3

## 注意事项

1. 某些网站可能需要登录或 cookies
2. 部分地区可能需要代理
3. 下载受版权保护的内容请遵守当地法律
4. Bilibili 等国内网站可能需要额外配置