tiktok-uploader 定时发布：一条命令排好一周的 TikTok 视频
【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader
想让 tiktok-uploader 定时发布替你接掉"每天卡点发视频"的活？它可以模拟真实浏览器操作 TikTok 网页版，自动完成选视频、填文案、设置发布时间、点击发布的全套动作。配合 TikTok 网页端原生的排期功能，你能把一周内容一次性排好，到点自动发出。这套 TikTok 视频自动化排期方案基于 Playwright 浏览器自动化实现，不依赖官方 API，也不需要开发者权限，装好就能用。
排期前必须记住的 3 条规则
先说规则，免得白忙活——下面任何一条不满足，该视频都会被直接跳过。这些校验写在 src/tiktok_uploader/upload.py 的_check_valid_schedule函数里：
- ⏰时间一律按 UTC 处理：你传什么时间，脚本就当它是 UTC，然后自动换算成浏览器所在时区，再填进 TikTok 的日期选择器。传了一个带非 UTC 时区的时间，这条视频会被跳过。
- ⏳提前至少 20 分钟，最远不超过 10 天：排期时间必须晚于当前时间至少 20 分钟，同时不能超过 10 天，两头都卡。
- 🕐分钟是 5 的倍数：TikTok 的排期控件以 5 分钟为粒度，脚本会自动把分钟向上取整——比如你写 12:03，实际会排到 12:05。
安装 tiktok-uploader 与获取登录凭证
两条命令完成安装：
pip install tiktok-uploader playwright install第一条装工具本体，第二条装 Playwright 的浏览器内核，建议用 Chrome，反检测效果最好。
想改源码、做二次开发的话，克隆仓库再装一遍环境：
git clone https://gitcode.com/gh_mirrors/ti/tiktok-uploader cd tiktok-uploader uv sync uv run playwright install然后准备登录凭证。用浏览器插件把 Cookie 导出成 NetScape 格式的cookies.txt，文件里至少要包含sessionid字段——它是 TikTok 识别登录状态的核心凭证。认证封装逻辑都在 src/tiktok_uploader/auth.py 里。
一条命令排期：用 -t 参数延迟发布
不想写代码的话，用-t（即--schedule）参数最省事，时间格式是年-月-日 时:分：
tiktok-uploader -v video.mp4 -d "今天的内容来啦" -c cookies.txt -t "2026-08-21 12:00"这条命令的含义很直白：上传video.mp4，文案填"今天的内容来啦"，并在 2026-08-21 12:00（UTC 时间）自动发布。
参数解析和校验逻辑在 src/tiktok_uploader/cli.py 中：parse_schedule负责把字符串转成 datetime 对象，validate_uploader_args会提前检查视频文件、封面文件是否存在，文件缺失会直接报错，不会跑到一半才失败。
Python 脚本方式：给 upload_video 传 schedule
想把排期嵌进自己的工作流（比如接剪辑脚本、内容管理系统），直接调 Python API，最小用法就三行，参考 examples/basic_upload.py：
import datetime from tiktok_uploader.upload import TikTokUploader schedule = datetime.datetime(2026, 8, 21, 12, 0) # UTC 时间 uploader = TikTokUploader(cookies="cookies.txt") uploader.upload_video("video.mp4", description="定时发布测试", schedule=schedule)schedule这个参数就是"立即发"变"定时发"的开关。还有个细节：TikTokUploader直到第一次上传才真正启动浏览器并注入 Cookie（懒加载机制），所以脚本启动很快，资源占用也小。
批量排期：一周的视频一次排完
把多个视频的路径、文案、排期时间各装进一个字典，汇成列表交给upload_videos依次处理，参考 examples/multiple_videos_at_once.py：
videos = [ {"path": "video1.mp4", "description": "第一条", "schedule": datetime.datetime(2026, 8, 21, 12, 0)}, {"path": "video2.mp4", "description": "第二条", "schedule": datetime.datetime(2026, 8, 22, 12, 0)}, ] uploader = TikTokUploader(cookies="cookies.txt") failed = uploader.upload_videos(videos)返回值是上传失败的视频列表，拿着它定位问题、单独重试即可。
视频一多的时候，建议用 Excel 表格管理，examples/series_upload.py 就是这个思路：视频路径、文案、是否已上传，全部记在表里；脚本每次取一行，只有上传成功才会把状态改成已上传，天然支持断点续传式的批量排期，很适合矩阵账号运营。
排期失败？先查这 3 个原因
- 🧭时间不合规：视频被跳过时，先确认时间是不是 UTC、是否落在"20 分钟之后、10 天之内"的窗口里、分钟是否为 5 的倍数。
- ⚠️触发了账号风控：作者明确提示，这个工具并非万无一失。短时间大量上传可能导致上传失败，等几个小时通常就恢复。请把它当定时发布器，而不是刷量工具。
- 🌐浏览器与运行模式：支持 chrome、chromium、firefox、edge、safari 五种，通过
browser参数指定，其中 Chrome 的反检测优化最好；在服务器上跑建议加headless=True，不弹浏览器窗口，更省资源。
现在就可以动手：先挑一条视频，用上面的 CLI 命令排个 20 分钟后的 UTC 时间测试一下。跑通单条之后，再把批量排期和 Excel 管理接上去。
【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
