**douyin-download**

Skill 使用说明

抖音视频一键下载工具 \| 无需登录 \| 720p 高清

1\. 技能概述

douyin-download 是一个 WorkBuddy
Skill，允许你直接在对话中发送抖音短链接，由 AI
自动完成视频解析与下载，无需手动操作浏览器、无需安装额外软件、无需登录抖音账号。

  ----------------------- -----------------------------------------------
       **功能特性**                          **说明**

       支持链接格式           v.douyin.com/xxx 短链接 / iesdouyin.com
                                             完整链接

         下载画质                       720p（高清带水印）

       是否需要登录                    无需登录，无需 Cookie

         保存位置             \~/Downloads/ 目录，文件名使用视频标题

         下载速度             通常 10-15 MB/s，100MB 视频约 10 秒完成
  ----------------------- -----------------------------------------------

2\. 安装方式

将提供的 douyin-download.zip 解压后放入 WorkBuddy 的 Skills 目录即可：

1.  下载 douyin-download.zip 文件

2.  解压到路径：\~/.workbuddy/skills/douyin-download/

3.  重启 WorkBuddy 或刷新 Skill 列表即可使用

Skill 目录结构

  ----------------------------------- -----------------------------------
            **文件 / 目录**                        **说明**

               SKILL.md                         技能主说明文件

       references/douyin_api.md              抖音 API 端点参考文档

               scripts/                      （可选扩展脚本目录）
  ----------------------------------- -----------------------------------

3\. 使用方法

3.1 基本用法

在 WorkBuddy 对话框中直接粘贴抖音分享文本或链接，告诉 AI 下载即可：

+-----------------------------------------------------------------------+
| **示例 1 - 分享卡片文本：**                                           |
|                                                                       |
| 下载此视频：8.25 VLW:/ 那些年我们一起幻想的以后 #AI短片               |
| https://v.douyin.com/xxx/                                             |
|                                                                       |
| **示例 2 - 纯链接：**                                                 |
|                                                                       |
| 下载这个抖音视频到本地：https://v.douyin.com/agkCl1Jbz0k/             |
+-----------------------------------------------------------------------+

3.2 工作流程（自动完成）

技能被触发后，AI 将自动执行以下步骤：

  ---------- ------------------ ---------------------------------------------
   **步骤**       **操作**                        **说明**

      1          解析短链接             curl 重定向获取 19 位视频 ID

      2        抓取移动端页面       访问 iesdouyin.com 提取内部 video_id

      3         构造下载地址         使用 snssdk 播放接口生成 720p 链接

      4           下载视频          保存到 \~/Downloads/\<视频标题\>.mp4

      5           验证结果              输出文件大小、格式、保存路径
  ---------- ------------------ ---------------------------------------------

4\. 常见问题

  ------------------------- ------------------ ----------------------------
          **问题**               **原因**              **解决方案**

      下载返回 403 错误       IP 短暂被限流           稍等几秒后重试

   下载文件很小（\<10KB）    接口返回错误页面   重新发送链接让 AI 重新解析

      视频带有抖音水印       playwm 接口特性    已知限制，去水印需额外处理

       yt-dlp 下载失败       需要登录 Cookie         此 Skill 不依赖
                                                      yt-dlp，可绕过
  ------------------------- ------------------ ----------------------------

5\. 技术说明

关键 API 端点

  ----------------------------------- --------------- -----------------------
               **端点**                  **水印**            **用途**

   iesdouyin.com/share/video/\<ID\>/        无             提取 video_id

      snssdk.com/aweme/v1/playwm/           有          720p 下载（本 Skill
                                                              使用）

       snssdk.com/aweme/v1/play/            无         无水印下载（需签名）
  ----------------------------------- --------------- -----------------------

必需请求头

以下请求头是下载成功的关键，缺失会返回 403：

  ------------------ ----------------------------------------------------
      **请求头**                            **值**

      User-Agent     Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS
                                   X) AppleWebKit/605.1.15

       Referer                     https://www.douyin.com/
  ------------------ ----------------------------------------------------

本文档由 WorkBuddy AI 自动生成 \| Skill 版本: v1.0 \| 2026-05
