TikTok 视频上传工具

使用 tiktok-uploader Python 库（基于 Playwright 的浏览器自动化，封装 TikTok 网页上传页面）上传、定时和批量管理 TikTok 视频。

安装

bash
pip install tiktok-uploader
playwright install

身份验证

用户必须提供以下其中一种方式。如果尚未配置，请询问用户：

方法	获取方式
Cookie 文件（推荐）	使用 Get cookies.txt LOCALLY 扩展程序从浏览器导出 cookies.txt。
Session ID

DevTools → Application → Cookies → .tiktok.com → 复制 sessionid 值。 |
| Cookie 列表 | 字典列表：[{name, value, domain, path}]。 |

会话 Cookie 会过期——如果上传因身份验证错误而失败，用户需要获取新的 Cookie。

操作

上传单个视频

python
from tiktok_uploader.upload import TikTokUploader

with TikTokUploader(cookies=cookies.txt, headless=True) as uploader:
success = uploader.upload_video(
filename=video.mp4,
description=看看这个 #fyp #viral @friend ,
visibility=everyone, # everyone | friends | only_you
comment=True,
stitch=True,
duet=True,
cover=thumbnail.png, # 可选
)
print(上传成功！ if success else 上传失败。)

定时发布视频

python
from datetime import datetime, timezone

with TikTokUploader(sessionid=abc123..., headless=True) as uploader:
uploader.upload_video(
filename=video.mp4,
description=即将发布！ #scheduled ,
schedule=datetime(2026, 3, 10, 14, 30, tzinfo=timezone.utc),
)

规则：必须为未来 20 分钟至 10 天之间；分钟数四舍五入到最近的 5 分钟。

批量上传

python
videos = [
{path: vid1.mp4, description: 第一个 #batch },
{path: vid2.mp4, description: 第二个, schedule: datetime(2026, 3, 10, 15, 0, tzinfo=timezone.utc)},
{path: vid3.mp4, description: 第三个, visibility: friends},
]

with TikTokUploader(cookies=cookies.txt, headless=True) as uploader:
failed = uploader.upload_videos(videos)
if failed:
print(f{len(failed)} 个视频上传失败)

使用封装模块

本技能提供了便捷的封装模块 scripts/tiktok_manager.py：

python
from scripts.tiktok_manager import TikTokManager

mgr = TikTokManager(cookies=~/cookies.txt)

上传

mgr.upload(video.mp4, description=你好 TikTok！ #fyp )

定时发布

mgr.upload(video.mp4, description=定时发布！, schedule=2026-03-10T14:30)

批量上传

mgr.upload_batch([
{path: v1.mp4, description: 第一个},
{path: v2.mp4, description: 第二个, schedule: 2026-03-10T15:00},
])

扫描目录中的可上传视频

videos = TikTokManager.scan_videos(~/Videos/tiktok, recursive=True)

重要提示

• - 标签与 @提及：包含在描述中，每个标签后跟一个空格。请验证它们是否存在。
• 描述限制：约 150 个字符。
• 频率限制：TikTok 会在多次上传后进行限制。请间隔上传；如果被限制，请等待数小时。
• 无头模式：设置 headless=False 可观察浏览器进行调试。
• 代理：传递 proxy={host: ..., port: ...}——仅限 Chrome。
• 支持的格式：.mp4、.mov、.avi、.wmv、.flv、.webm、.mkv、.m4v、.3gp、.3g2、.gif
• 脆弱性：浏览器自动化，非官方 API。TikTok UI 变更可能导致其失效。

故障排除

问题	解决方法
身份验证/登录错误	Cookie 过期 → 导出新的 cookies.txt
上传卡住

尝试 headless=False 查看具体情况 | | 被限制/频率限制 | 在批次之间等待数小时 | | 选择器错误 | tiktok-uploader 可能需要更新（pip install -U tiktok-uploader） |