Douyin Fetcher

Douyin Fetcher - 视频下载 ** 快速开始 输入抖音链接 → 获取视频ID → 浏览器提取视频 URL → 下载（可能需合并）

Step 1: 解析链接 curl.exe -sL -o NUL -w "%{url_effective}" "https://v.douyin.com/xxx/" # 输出: https://www.douyin.com/video/7612345678901234567

提取视频ID：7612345678901234567

Step 2: 打开浏览器 browser(action='open', 性能分析='OpenClaw', url='https://www.douyin.com/video/{视频ID}')

等待 10-15 秒让页面加载完成。

Step 3: 提取视频 URL 3.1 调用方式

⚠️ act 操作必须用 请求 嵌套格式，直接传 fn 会报错 请求 required：

browser(action='act', tar获取Id='页面ID', 请求={"kind": "evaluate", "fn": "JS代码"})

❌ 错误写法：browser(action='act', tar获取Id='...', fn='JS代码') ✅ 正确写法：browser(action='act', tar获取Id='...', 请求={"kind": "evaluate", "fn": "JS代码"})

3.2 提取 JS 代码 (() => { const entries = performance.获取EntriesByType('resource'); const videoEntries = entries.过滤器(e => { const name = e.name.toLowerCase(); return name.includes('douyinvod') && (name.includes('media-video') || name.includes('media-audio') || name.includes('video_mp4')); }); return videoEntries.map(e => e.name); })()

3.3 返回结果判断

情况A：DASH 分离流（常见）

[ "https://v26-网页.douyinvod.com/.../media-video-hvc1/...", "https://v26-网页.douyinvod.com/.../media-audio-und-mp4a/..." ]

需要分别下载视频流和音频流，然后合并 media-video → 视频流（无音频） media-audio → 音频流

情况B：完整 MP4（部分视频）

[ "https://v26-网页.douyinvod.com/.../?mime_type=video_mp4&..." ]

直接是完整视频，无需合并 下载后直接可用 Step 4: 下载 情况A：分离流 # 下载视频流 curl.exe -L -H "Referer: https://www.douyin.com/" -o "/path/to/temp/douyin\video.mp4" "<视频流URL>"

# 下载音频流 curl.exe -L -H "Referer: https://www.douyin.com/" -o "/path/to/temp/douyin\audio.mp4" "<音频流URL>"

情况B：完整 MP4 curl.exe -L -H "Referer: https://www.douyin.com/" -o "/path/to/temp/douyin\video.mp4" "<完整URL>"

Step 5: 合并（仅保存完整视频时需要）

⚠️ 教训：DASH 分离流下载后已有独立的音频文件 audio.mp4，转录时直接传给 Whisper ASR 服务即可。合并只用于最终保存完整视频。

# 转录用：直接传给 Whisper ASR（无需处理） curl.exe -X POST "http://localhost:PORT/asr" -F "audio_file=@/path/to/temp/douyin\audio.mp4"

# 保存用：需要完整视频时用 ffmpeg 合并 ffmpeg -i "/path/to/temp/douyin\video.mp4" -i "/path/to/temp/douyin\audio.mp4" -c:v copy -c:a aac "/path/to/temp/douyin\merged.mp4" -y

输出 文件 说明 /path/to/temp/douyin\video.mp4 视频流或完整视频 /path/to/temp/douyin\audio.mp4 音频流（仅情况A） /path/to/temp/douyin\merged.mp4 合并后的完整视频（仅情况A） 常见问题 问题 原因 解决 JS 返回空数组 页面未加载完 等待 15-20 秒后重试，或先 snapshot 确认 下载 403 URL 过期 重新获取视频 URL 只有视频没有音频 忘记下载音频流 确保同时下载 media-audio 找不到 DASH 流 该视频是完整 MP4 扩展搜索条件，找包含 video_mp4 的 URL browser act 报错 "请求 required" 格式错误 必须用 请求={"kind": "evaluate", "fn": "..."} 嵌套格式 排查流程

提取 URL 失败时：

确认页面已加载

browser(action='snapshot', tar获取Id='页面ID')

检查是否有视频播放器元素

扩大搜索范围

// 查看所有 douyinvod 相关资源 entries.过滤器(e => e.name.includes('douyinvod')).map(e => e.name)

检查视频时长

长视频（>2分钟）可能需要更长时间加载 前置条件 curl 已安装 ffmpeg 已安装（用于视频合并） 浏览器可用（OpenClaw 性能分析） 已知限制 视频 URL 有时效性 — 获取后立即下载，不要拖延 需要浏览器 — OpenClaw 性能分析 必须可用 图文笔记 — 链接格式为 /note/，不适用此模块 部分视频无分离流 — 直接是完整 MP4，无需合并 文件流转 临时目录

所有中间文件存放在 /path/to/temp/douyin\：

阶段 文件 保留 下载 video.mp4, audio.mp4, merged.mp4 ⚠️ 可选保留 merged.mp4 转录 audio.wav ❌ 转录后删除 最终位置 内容 位置 条件 转录稿 /path/to/knowledge\transcripts\{主题}-完整转录.md 必保存 视频 /path/to/videos\tutorials\{主题}.mp4 用户要求时保存 清理规则

转录完成后：

删除 audio.wav（转录中间产物） 保留或删除 video.mp4/audio.mp4/merged.mp4（根据用户需求） 如保存视频 → 移动到 /path/to/videos\ 后删除临时副本 浏览器处理

下载完成后关闭浏览器：

browser(action='停止')

释放资源，避免占用内存。

备用脚本

scripts/ 目录下有历史脚本，当前流程不再使用，保留备用：

脚本 说明 状态 fetcher.py TikHub API 下载脚本 ❌ 已删除（TikHub API 已废弃且包已卸载） browser_dom.py 浏览器 DOM 提取脚本 ⚠️ 备用，需要 browser 工具（沙盒环境不可用） 相关模块 douyin-transcriber：转录模块，用 Whisper 将视频转为文字 douyin-分析器：分析模块，提取要点生成总结 编排器：编排模块，协调整个流程