SuperAPI AI 工具集

douyin-fetcher

测试与质量

查看项目

更新于 10-16 00:22

技能介绍

用途:下载抖音视频。该 skill 通过 Playwright 控制无头 Chromium 访问抖音视频页面,拦截 aweme/detail 接口响应,从 JSON 的 play_addr.url_list[0] 提取无水印视频直链,再用 requests 携带 Referer 下载。

主要能力:支持单个抖音视频下载;支持只抓取元数据;下载成功后输出标题、视频大小、保存路径与作者信息,并在同目录生成 .metadata.json,包含标题、作者、发布时间、时长、互动数据等精简元数据。

使用方式:先安装依赖(Python 3.9+、playwright、requests),Chromium 首次缺失时脚本会自动执行 python3 -m playwright install chromium。执行:

python3 douyin-fetcher/scripts/download.py "<抖音链接>" [输出路径]

可选参数:--metadata-only 只抓元数据不下载;--timeout 60 设置等待接口响应的秒数。默认保存到 ~/Downloads/douyin_<video_id>.mp4。支持格式包括 https://www.douyin.com/video/<id>、https://www.douyin.com/jingxuan?modal_id=<id> 等 douyin.com 视频 URL。

适用场景:需要获取无水印视频文件或视频元数据的场景。

限制:链接必须含有效 video_id,推荐页链接需转换为 /video/ 详情页;部分视频可能因版权或地区限制无法下载;该 skill 只负责抓视频与元数据,需要口播稿时另行调用 volc-asr 转写。