Douyin
README.md
# 抖音链接转视频
> 贴一条抖音分享链接,直接落成能播放的 **mp4**;图集落成一批 **jpg**。不带水印。



同一个包,三种用法:**DSH 插件** / **命令行** / **标准 MCP server**。零依赖,不装任何 npm 包。
```bash
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
bash install.sh
```
它会先检查 Node、跑一遍自测,再按这台机器上有没有 `dsh` 决定装不装插件。
### 只想手动来
```bash
# 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/`
### 命令行
```bash
# 下载(默认存 ./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`,其他客户端有各自的位置):
```json
{
"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` 里写:
```yaml
- 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 }] }`。
---
## 六、自测
```bash
node test.mjs # 22 条纯逻辑,不联网
node test.mjs --net # 顺带打一次真链接
```
---
MIT。随便改,随便传。
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues