# Douyin Video Downloader

> 下载抖音（Douyin/TikTok中国）视频。支持短链接（v.douyin.com/xxx）和完整URL，自动解析视频信息，下载无水印版本。当用户提到"下载抖音"、"保存抖音视频"、"douyin download"、"抖音链接"、"v.douyin.com"或粘贴任何抖音视频链接时使用此skill。无需登录凭证或cookies。

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

---


# 抖音视频下载器

这个 skill 帮助用户下载抖音（中国版 TikTok）视频。

## 工作原理

抖音视频无需登录即可下载。方法如下：
1. 解析视频 URL 获取视频 ID
2. 使用移动端 User-Agent 获取分享页面
3. 从 HTML 中提取 `window._ROUTER_DATA` 或类似的 JSON 数据
4. 获取视频播放地址：
   - `play` = 无水印版本（推荐）
   - `playwm` = 带水印版本
5. 使用 curl 直接下载视频文件

## 支持的 URL 格式

- 短链接：`https://v.douyin.com/xxxxxxxx/`
- 分享链接：`https://www.douyin.com/video/xxxxxxxxx`
- 完整链接：包含 `aweme_id` 或视频 ID 的任何抖音 URL

## 使用步骤

### 1. 识别用户请求

当用户提到以下内容时触发：
- "下载抖音"、"保存抖音视频"、"抖音下载"
- "douyin download"、"download douyin video"
- 粘贴任何包含 `v.douyin.com` 或 `douyin.com` 的链接
- "把这个抖音视频保存下来"

### 2. 执行下载

使用 skill 目录中的 `scripts/download_douyin.py` 脚本：

```bash
python3 /Users/snail/.claude/skills/douyin-video-downloader/scripts/download_douyin.py "<视频URL>"
```

脚本会：
- 自动解析视频 ID
- 提取视频标题和作者信息
- 下载无水印版本到 `~/Downloads/抖音视频/`
- 清理文件名中的特殊字符
- 显示下载进度和结果

### 3. 报告结果

告诉用户：
- 视频标题
- 保存路径
- 文件大小
- 任何错误或警告

## 错误处理

如果下载失败，按以下顺序尝试：

1. **视频 ID 解析失败**：确认 URL 是有效的抖音链接
2. **页面数据获取失败**：可能需要稍后重试（抖音可能限流）
3. **视频 URL 提取失败**：该视频可能已被删除或设为私密

替代方案：
- 建议用户访问 https://douyin.wtf/ 在线解析
- 建议使用手机抖音 App 保存视频
- 建议使用浏览器插件（如"猫抓"）

## 输出文件格式

下载的文件命名格式：
```
<视频标题>_no_watermark.mp4
```

特殊字符会被替换为下划线，确保文件名有效。