用途:通过抖音号查询账号近期作品,逐条解析无水印视频/图文下载直链,并批量下载到本地 output/ 目录(可自定义)。
主要能力:作品拉取(标题、互动数据、作品链接);链接解析获取无水印直链;批量下载视频与图文;Markdown 表格或 JSON 双格式输出;支持翻页与按发布时间筛选;内置请求间隔以降低触发限流的概率。
使用方式:先前往 redfox.hk 获取 API Key,配置环境变量 REDFOX_API_KEY(Windows PowerShell 用 $env:REDFOX_API_KEY="ak_你的密钥"),并安装依赖 pip3 install requests。基础命令示例:python3 "$SKILL_PATH/scripts/douyin_video_downloader.py" --account "Fish688688";加 --download 下载文件,--output-dir 指定目录,--json 输出 JSON,--accounts 支持多账号逗号分隔,--count 控制数量(默认10,最多50),--page 翻页,--date-start/--date-end 按日期筛选,--rate-limit 设置请求间隔。
限制与注意事项:必须提供抖音展示 ID(uniqueName,如 Fish688688),仅提供中文昵称会因重名无法精准查询;同一抖音号 6 小时内累计 5 次 API 调用失败后会被拒绝,失败计数持久化于 ~/.qoder/douyin_video_downloader_failures.json,空数据不计入失败;接口限流(code=3108)时可增大 --rate-limit;图文作品自动下载首张无水印图片。费用、平台支持范围等资料暂未提供。