export DOUYIN_CHROMIUM_PATH="$HOME/Library/Caches/ms-playwright/chromium-1105/chrome-mac/Chromium.app/Contents/MacOS/Chromium"

{
  "data": {
    "original_video_url": "https://cdn.example.com/..."
  }
}

多平台视频下载 + 本地转录

功能特点

• - ✅ 纯浏览器下载（免费） — 抖音用 Playwright 无水印抓取，无需 API Key
• ✅ MLX Whisper — Apple Silicon 原生 Metal GPU 加速（Mac M系列首选）
• ✅ faster-whisper — CPU/CUDA 通用兜底（非 Apple Silicon 也能用）
• ✅ 短视频同步转录 — <5 分钟视频直接返回完整结果
• ✅ 长视频后台转录 — ≥5 分钟自动后台运行，返回 transcript_id 可查询
• ✅ 可检索 — 转录结果支持关键词查询相关片段 + 时间戳

支持的平台

平台	检测关键词	下载方式
B站	bilibili.com/video, b23.tv, BV号	yt-dlp
抖音

douyin.com, v.douyin.com | Playwright 浏览器抓取 或 TikHub | | TikTok | tiktok.com | TikHub | | YouTube | youtube.com, youtu.be | yt-dlp | | 小红书 | xiaohongshu.com, xhslink.com | TikHub | | 微博 | weibo.com, m.weibo.cn | TikHub | | 快手 | kuaishou.com, ksurl.cn | TikHub |

---

🔑 核心原则

所有平台统一两步走

获取下载链接 → curl/yt-dlp 下载 → mlx_whisper 转录

原因：

• - analyze_video 把下载+转录绑在一起，长视频容易超时
• 两步走每步都 <10秒，稳定可控
• 每步可单独排错

排错核心原则

当一个工具失败时，不要放弃！找替代方案。

---

初始化安装（首次使用）

抖音 Playwright Chromium 安装

bash

运行 setup.sh 自动安装

cd ~/.openclaw/workspace/skills/video-download-transcribe/douyin-mcp/
./setup.sh

setup.sh 会：

1. 1. 检测系统环境
2. 查找或安装 Chromium（使用国内 npmmirror 镜像）
3. 设置 DOUYINCHROMIUMPATH 环境变量
4. 测试浏览器抓取是否正常

手动安装（如果 setup.sh 失败）：
bash

方式 A：用 openclaw-media 的 playwright 安装 chromium

git clone https://github.com/openclaw/openclaw-media ~/openclaw-media 2>/dev/null || true
PLAYWRIGHTDOWNLOADHOST=https://npmmirror.com/mirrors/playwright \
~/openclaw-media/.venv/bin/playwright install chromium

方式 B：自行安装 playwright

pip install playwright PLAYWRIGHTDOWNLOADHOST=https://npmmirror.com/mirrors/playwright playwright install chromium

环境变量（运行 AI 助手前设置）：
bash
export DOUYINCHROMIUMPATH=$HOME/Library/Caches/ms-playwright/chromium-1105/chrome-mac/Chromium.app/Contents/MacOS/Chromium

---

工作流程（统一两步走）

第一步：获取下载链接

bash

========== 抖音 ==========

方式 A：douyin-analyzer 浏览器抓取（免费，需 Chromium）

mcporter call douyin-analyzer.getdouyindownloadlink sharelink:https://v.douyin.com/xxx/

方式 B：tikhub-douyin 获取实时 CDN 地址（更可靠，需 API Key）

mcporter call tikhub-douyin.douyinwebfetchvideohighqualityplayurl shareurl:https://v.douyin.com/xxx/

========== B站/YouTube/其他平台 ==========

用 yt-dlp 直接下载（会自动处理重定向和 Cookie）

yt-dlp -o /tmp/video.mp4 https://www.bilibili.com/video/BVxxx

========== TikTok/小红书/微博/快手 ==========

tikhub-douyin 获取下载链接

mcporter call tikhub-douyin.douyinwebfetchonevideobyshareurl shareurl:<链接>

第二步：下载 + 转录

bash

用 curl 下载（抖音/TikTok 获取的 CDN 地址）

curl -L -o /tmp/video.mp4 https://cdn.example.com/video.mp4

转录（本地 mlx_whisper）

python3 << PYEOF import os os.environ[HFHUBOFFLINE] = 1 import mlx_whisper result = mlx_whisper.transcribe( /tmp/video.mp4, pathorhf_repo=mlx-community/whisper-small-mlx, verbose=True ) for seg in result.get(segments, []): print(f[{seg[start]:.1f}s - {seg[end]:.1f}s] {seg[text]}) PYEOF

长视频（≥5分钟，后台转录）

bash

用 analyzevideo 获取 transcriptid（后台转录中）

mcporter call douyin-analyzer.analyze_video url:https://... --timeout 300000

等待 1-2 分钟后获取结果

mcporter call douyin-analyzer.gettranscript transcriptid:xxx

---

MCP 工具

douyin-analyzer（本地进程，免费）

bash

获取无水印下载链接（浏览器抓取）

mcporter call douyin-analyzer.getdouyindownloadlink sharelink:https://v.douyin.com/xxx/

解析视频基本信息

mcporter call douyin-analyzer.parsedouyinvideoinfo sharelink:https://v.douyin.com/xxx/

通用分析（仅用于获取 transcript_id，后台转录）

mcporter call douyin-analyzer.analyze_video url:https://... --timeout 300000

获取长视频后台转录结果

mcporter call douyin-analyzer.gettranscript transcriptid:xxx

检索转录内容

mcporter call douyin-analyzer.querytranscript transcriptid:xxx query:关键词 top_k:3

返回结构（getdouyindownload_link）：
json
{
video_id: xxx,
downloadurl: https://www.iesdouyin.com/aweme/v1/play/?videoid=xxx,
share_link: https://v.douyin.com/xxx/
}

⚠️ download_url 是 iesdouyin.com 重定向 URL，有时效性，建议立即使用。

tikhub-douyin（远程服务，需认证）

bash

获取视频信息+播放链接（所有平台通用）

mcporter call tikhub-douyin.douyinwebfetchonevideobyshareurl shareurl:<链接>

获取最高画质 CDN 地址（推荐，最可靠）

mcporter call tikhub-douyin.douyinwebfetchvideohighqualityplayurl shareurl:<链接>

返回字段：
json
{
data: {
originalvideourl: https://cdn.example.com/...
}
}

---

❗️ 排错流程

1. 1. 工具返回 error/失败

↓

1. 2. 抖音：换一个 MCP（douyin-analyzer ↔ tikhub-douyin）

B站/YouTube：检查 yt-dlp 是否支持 TikTok/其他：检查 tikhub-douyin 是否可用 ↓

1. 3. 抖音：检查 Chromium 是否安装 + DOUYINCHROMIUMPATH 是否设置

↓

1. 4. 如果都失败 → 找图文/文字版内容

常见问题

问题	原因	解决
downloadurl 为空	Playwright Chromium 未安装	运行 setup.sh 或手动安装
DOUYINCHROMIUMPATH 警告

环境变量未设置 | 设置 export DOUYINCHROMIUM_PATH=... | | curl 下载失败 | 抖音 URL 已过期 | 改用 TikHub 获取实时 CDN | | TikHub 返回 401 | API 认证失败 | 检查 mcporter.json 的 TikHub Token | | yt-dlp 下载失败（B站） | Cookie/地区限制 | 加代理或用 TikHub | | analyze_video 超时 | 视频较大 | 改用两步走 |

Chromium 安装（国内镜像