抖音链接转视频
贴一条抖音分享链接,直接落成能播放的 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。
三种用法对照
| 用法 | 适合谁 | 要装什么 |
|---|---|---|
| DSH 插件 | 用 DeepSeek Harness 的 | 一条 dsh plugin add |
| 命令行 | 谁都能用,脚本也行 | 只要 Node 20+ |
| MCP server | Claude Desktop / Claude Code / Cline / Cherry Studio | 只要 Node 20+ |
零依赖:不装 npm 包,不加任何第三方库。
一、装
解压后进目录:
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 插件
装好重启后,在会话里直接贴链接就行。模型会自己走这条路:
douyin_info—— 先看你丢的是什么(标题、作者、时长、是不是图集)douyin_download—— 落成本地文件,回你绝对路径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,最后默认值。改完立即生效,不用重启。
| 环境变量 | 插件 config | 默认 | 说明 |
|---|---|---|---|
DOUYIN_OUTPUT_DIR |
outputDir |
工作区 douyin/ |
存哪儿。绝对路径。 |
DOUYIN_MAX_MB |
maxMB |
200 |
单个视频上限(MB),超了直接拒 |
DOUYIN_MAX_IMAGES |
maxImages |
20 |
图集最多下几张 |
DOUYIN_TIMEOUT_MS |
timeoutMs |
90000 |
解析超时 |
DOUYIN_DOWNLOAD_TIMEOUT_MS |
downloadTimeoutMs |
300000 |
下载超时 |
DOUYIN_KEEP_COVER |
keepCover |
false |
顺手存封面 |
DOUYIN_AUTO_HINT |
autoHint |
true |
要不要往每轮提示里塞「见到链接就调工具」 |
DOUYIN_EXTRA_APIS |
extraApis |
空 | 自己的解析接口,{url} 会在里面替换成链接,逗号分隔多个 |
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,都不好用。所以走两条第三方通道:
- 主通道
api.xingzhige.com——GET /API/douyin/?url=<链接>,免登录,约 1 秒出无水印直链 - 回落
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。随便改,随便传。
No comments yet. Be the first to write one.