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 脚本：

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

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