抖音视频批量采集下载

要解决的问题

把某位抖音博主的主页视频批量抓到本地，听起来简单，实际有两道坎：

• 接口封顶：抖音 web 接口（aweme/post）对部分账号有服务端硬上限。主页上写着 515 条，实际翻页最多拿到约 108 条。这是平台限制，不是脚本 bug，但你得知道自己到底缺了多少。
• 状态不透明：跑了一半断掉、哪些已经下过、每个账号跑到哪一条，散落在命令行输出里，没法一眼对账。

核心能力

技能把采集拆成配置、下载、对账三块：

• 配置驱动：账号与目标写在 config.toml，脚本里没有硬编码，跑完分享出去也不会残留个人账号信息或本地路径。
• 并发下载：concurrency 参数控制线程池大小，默认 4。已存在的 mp4 自动跳过，中断后直接重跑即可续传。
• 封顶检测：在配置里填上 declared_count（主页声明的视频数），仪表盘自动计算 实际采集数 与声明数的差值，并标注「疑似 web 封顶」。
• 统一仪表盘：一次运行生成一个 HTML，汇总所有账号的采集数、缺口、最后运行时间。

关键步骤

1. 填好 config.toml，声明目标账号与 declared_count。
2. 运行采集脚本，并发拉取主页视频。
3. 打开生成的 HTML 仪表盘，对照声明数看缺口。

适用边界

• declared_count 要自己填，工具无法凭空知道你主页到底有多少条；缺口检测的准确性完全取决于这个输入。
• 封顶是抖音服务端的行为，工具只能发现并标注，不能绕过。
• 核心只依赖 Python 标准库，如果你的环境里没有任何第三方包，它照样能跑；反过来也别指望它集成额外的下载器或转码工具。