tiktok-uploader 定时发布完整指南：10 分钟跑通排期，批量自动化一次讲清
【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader
每天卡着点等发布、手忙脚乱地操作上传，多账号运营时这种重复劳动尤其折磨人。tiktok-uploader 是一个基于 Playwright 浏览器自动化的 TikTok 视频自动上传器，它的定时发布功能可以用一条命令或几行脚本，把一周的视频全部排进队列，到点自动发布，实现真正的 TikTok 视频自动化排期。
不调官方 API，它凭什么能发视频？
第一反应往往是：TikTok 没开放公共上传接口，这工具是怎么做到的？
原理一句话：它不调接口，而是驱动一个真浏览器。工具把你的浏览器 Cookie 注入 Playwright 控制的 Chrome，TikTok 便认定该浏览器已登录，之后选视频、填文案、设排期、点发布，全是模拟点击，和人手动操作没有区别。
两块核心代码值得知道：认证封装在 src/tiktok_uploader/auth.py，负责把 Cookie 注进浏览器；上传与排期逻辑都在 src/tiktok_uploader/upload.py 的TikTokUploader类里。浏览器只在首次上传时才启动，脚本本身启动很快、占资源少。
第一次定时发布怎么跑通？
安装只需两步（macOS、Windows、Linux 通用）：
pip install tiktok-uploader playwright install第二行装 Playwright 的浏览器内核，Chrome 的反检测优化最好，推荐用它。
接着准备登录凭证：在浏览器登录 TikTok.com，用 Cookie 导出插件把cookies.txt（NetScape 格式）导出来，文件里必须包含sessionid字段，它是识别登录状态的核心凭证。插件导不出时，可以打开开发者工具（F12），在 Application > Cookies 里复制sessionid手动补进文件。
最后一条命令行搞定，-t参数用「年-月-日 时:分」格式，填UTC 时间：
tiktok-uploader -v video.mp4 -d "今天的内容" -c cookies.txt -t "2026-08-21 12:00"排期时间会被脚本自动换算成浏览器时区填进 TikTok 的日期选择器，不用自己换算。
什么样的排期时间会被拒绝？
时间进入表单前要先过 src/tiktok_uploader/upload.py 中_check_valid_schedule的三道校验，任何一条不满足，该视频会被直接跳过：
- 只认 UTC：不带时区的时间或带 UTC 时区的时间都可以，带其他时区的时间直接判非法
- 窗口：比当前时间晚至少 20 分钟，且不超过 10 天：留 20 分钟余量是为了让上传流程自己跑完
- 分钟必须是 5 的倍数：TikTok 排期控件以 5 分钟为粒度，脚本会自动向上取整，比如 12:03 变成 12:05
⚠️ 注意：分钟不合法时是"自动修正"，前两条不合法时是"直接丢弃"，不会帮你改时间。
几十条视频的批量上传排期怎么管？
单条视频走参数，批量则把多个视频放进列表，逐个给出path、description和各自的schedule，调用upload_videos依次排队。这个方法会返回上传失败的视频列表，方便定位后重试。
如果视频多到用列表也装不下，推荐参考 examples/series_upload.py 的做法：把视频路径、文案、是否已上传维护在一张 Excel 表里，脚本每次取第一条未完成记录去排期，只有上传成功才把状态标记为已上传。中断后重跑自动接着来，天然支持断点续传，很适合矩阵账号的日常内容排期。
出问题时我能做什么？会封号吗？
几个高频问题直接给答案：
- 短时间传多了传不动？作者明确说工具不是万无一失的，短时间大量上传会导致上传失败，等几个小时通常就能恢复。把它当排期器用，别当刷量机器人。
- 服务器上跑要弹浏览器窗口？构造
TikTokUploader时传headless=True，命令行默认就是无头模式，加--attach反而才显示窗口。 - 浏览器能用别的吗？支持 chrome、chromium、firefox、edge、safari，通过
browser参数切换，Chrome 最稳。 - 排期没生效？按"三条铁律"顺序排查——9 成问题出在时间上，先看 UTC，再看窗口，最后看分钟取整。
建议先用一条视频把"导出 Cookie → 排期 → 到点自动发"整条链路跑通，确认无误后再切到upload_videos做批量排期，并用 Excel 状态表兜底；批量之间多留几小时间隔，稳定比速度重要。
【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
