抖音链接转视频

贴一条抖音分享链接，直接落成能播放的 mp4；图集落成一批 jpg。不带水印。

同一个包，三种用法：DSH 插件 / 命令行 / 标准 MCP server。零依赖，不装任何 npm 包。

git clone https://github.com/wlq6dfup20090104/dsh-douyin-video.git
cd dsh-douyin-video
node test.mjs                      # 22 条自测，不联网
node cli.js "https://v.douyin.com/xxxxx/"

不想 clone 就下 zip：右上角 Code → Download ZIP。

三种用法对照

零依赖：不装 npm 包，不加任何第三方库。

Related MCP server: Wanyi Watermark Remover

一、装

解压后进目录：

bash install.sh

它会先检查 Node、跑一遍自测，再按这台机器上有没有 dsh 决定装不装插件。

只想手动来

# 1) DSH 插件（装完要重启 DSH 才生效）
dsh plugin --profile web add "link:/你解压的路径/dsh-douyin-video"

# 2) 命令行，随便用
node /你解压的路径/dsh-douyin-video/cli.js "https://v.douyin.com/xxxxx/"

# 3) 想全局敲 douyin-video
cd /你解压的路径/dsh-douyin-video && npm link

二、用

DSH 插件

装好重启后，在会话里直接贴链接就行。模型会自己走这条路：

1. douyin_info —— 先看你丢的是什么（标题、作者、时长、是不是图集）

2. douyin_download —— 落成本地文件，回你绝对路径

3. present —— 把文件列出来，点开就能看

两个工具也能手动指定：

• douyin_info({ text }) —— 只解析，不下载

• douyin_download({ text, dir? }) —— 下载，dir 不填就存到当前工作区的 douyin/

命令行

# 下载（默认存 ./douyin/）
node cli.js "https://v.douyin.com/xxxxx/"

# 整段分享文案，带口令那种也行
node cli.js "7.43 复制打开抖音，看看【某某的作品】... https://v.douyin.com/xxxxx/ 复制此链接"

# 指定目录
node cli.js "https://v.douyin.com/xxxxx/" --out ~/视频

# 只看信息，不下载
node cli.js "https://v.douyin.com/xxxxx/" --info

# 输出 JSON，接自己脚本
node cli.js "https://v.douyin.com/xxxxx/" --json

# 从管道读
echo "https://v.douyin.com/xxxxx/" | node cli.js -

# 一段文字里有好几条，最多处理 3 条
node cli.js "<一堆链接>" --max 5

MCP server

claude_desktop_config.json（Claude Code 用 claude mcp add，其他客户端有各自的位置）：

{
  "mcpServers": {
    "douyin": {
      "command": "node",
      "args": ["/你解压的路径/dsh-douyin-video/mcp-server.js"]
    }
  }
}

工具名和 DSH 那边一样：douyin_info、douyin_download。

三、配置

环境变量优先，其次插件 config，最后默认值。改完立即生效，不用重启。

DSH 插件改 config 就在 cordis.patch.yml 里写：

- insert:
    - id: douyin-video
      name: dsh-douyin-video
      config:
        maxMB: 300
        outputDir: /root/视频

四、它是怎么做到的

抖音官方接口现在全被 ArgusSecurityPlugin 风控（403），分享页 SSR 里的 video_layout 是 null，yt-dlp 又缺 ttwid，都不好用。所以走两条第三方通道：

1. 主通道 api.xingzhige.com —— GET /API/douyin/?url=<链接>，免登录，约 1 秒出无水印直链

2. 回落 api.douyin.wtf —— 登录 demo 账号 → POST /api/v1/parse（202 异步）→ 轮询 /api/v1/tasks/{id}，内容在 data.data

拿到直链后带 iPhone UA + Referer: https://www.douyin.com/ 直接下 mp4，落盘前校验 ftyp 头（防止拿到防盗链 HTML 冒充视频）。

同一个作品重复下不会重下：文件名用 contentId，已存在且非空直接复用。

五、常见问题

解析失败 / 资源id获取失败 链接本身可能失效（作品删了、私密、或者只是作者主页）。换一条正常的分享链接再试。接口挂了就跑 node test.mjs --net 看是哪条通道死了。

视频太大（xx MB，上限 200MB） 改 DOUYIN_MAX_MB。抖音一般几十 MB，200 够用。

图集只下了一部分 默认上限 20 张，改 DOUYIN_MAX_IMAGES。

想先看看是什么再决定下不下 用 --info（或者 douyin_info）。它只解析，不占流量。

节点/代理环境 插件走的是 fetch，不吃系统代理。要走代理自己设 HTTPS_PROXY，或者用 extraApis 换成你能访问的接口。

给别的程序用 --json 输出是稳定结构：{ ok, dir, items: [{ ok, kind, title, author, videoPath, videoBytes, images, error }] }。

六、自测

node test.mjs          # 22 条纯逻辑，不联网
node test.mjs --net    # 顺带打一次真链接

MIT。随便改，随便传。