扩展 tiktok-uploader 的 5 种方式二次开发自定义上传行为指南【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploadertiktok-uploader 是一个基于 Playwright 浏览器自动化的 TikTok 视频自动上传工具它通过复用你的浏览器 Cookies 完成免扫码登录再自动完成选文件、填描述、加话题、定时发布等一整套操作。很多用户用着用着就会发现默认行为不够用——想在上传后发通知、想按表格批量发视频、想换代理换浏览器。这篇文章就为你整理 tiktok-uploader 二次开发的 5 种实用方式帮你自定义上传行为把自动上传能力真正变成自己的。tiktok-uploader 到底能做什么先看架构在动手扩展之前先花 30 秒理解它的核心结构。tiktok-uploader 的核心类是TikTokUploader定义在src/tiktok_uploader/upload.py中围绕它有三个关键模块模块职责文件上传核心视频上传、表单填写、定时发布src/tiktok_uploader/upload.py认证读取 Cookies、登录、校验 sessionidsrc/tiktok_uploader/auth.py浏览器启动 Chrome/Firefox 等、反检测伪装src/tiktok_uploader/browsers.py配置全部默认参数与页面选择器src/tiktok_uploader/config.toml所有可自定义的行为几乎都从这四类文件入手。下面 5 种方式由浅入深你可以按需取用。方式一用 on_complete 回调钩子让上传结果即时可知 最轻量、零侵入的扩展方式就是使用upload_videos()自带的on_complete回调参数。它的作用非常直观每上传完一个视频就调用一次你写的函数。比如你想在上传成功后自动发送一条通知或者把结果写入日志只需这样写from tiktok_uploader.upload import TikTokUploader def notify(video): print(f已处理: {video[path]}描述: {video.get(description, )}) uploader TikTokUploader(cookiescookies.txt) failed uploader.upload_videos(videos[...], on_completenotify)这个回调由upload.py中的upload_videos方法在每个视频处理结束后触发无论成功失败都会执行非常适合接消息推送、写数据库、统计发布进度等场景。它不需要修改任何源码是二次开发最安全的起点。方式二修改 config.toml不动代码也能自定义行为 ⚙️如果你只是想调整等待时间、支持的文件类型甚至适配 TikTok 页面改版后的新选择器直接改配置文件就够了。src/tiktok_uploader/config.toml是项目的“总控台”常见可改项包括等待时间implicit_wait、explicit_wait、uploading_wait网速慢可以调大文件类型supported_file_types默认支持 mp4、mov、avi 等可按需增删描述长度max_description_length默认 150 字符页面选择器[selectors]下的 XPath当 TikTok 改版导致上传失败时这里就是修复入口。配置文件由settings.py中的load_config()加载并通过 pydantic 做严格校验——改错了会直接报错而不是静默出错这点对二次开发非常友好。想深入理解每个字段可以对照src/tiktok_uploader/settings.py里的模型定义。方式三编写批量上传脚本用表格驱动整个发布流程 默认 CLI 一次只能传一个视频但很多人的真实需求是“照着表格批量发”。项目自带了一个极好的参考范例examples/series_upload.py。它的思路很聪明用 Excel/CSV 记录每个视频的文件路径、描述、是否已上传每次只取第一条未上传的记录执行成功后才把它标记为“已上传”。这样即使中途失败下次重跑也不会重复发布。frame pd.read_excel(INFO) # 读取视频清单 video_info frame.iloc[index] # 取第一条未上传记录 success uploader.upload_video(video_info[file_path], video_info[description]) if success: video_info[KEY] True # 成功才标记 frame.to_excel(INFO)你完全可以在这个基础上扩展加一列schedule做定时发布、加一列product_id挂商品链接、加一列visibility控制可见范围。上传方法本身支持这些参数表格驱动只是把“人肉调用”变成了“数据驱动”。方式四自定义浏览器、代理与反检测参数 如果你的运营场景需要多账号、多 IP那么浏览器和代理的定制就是刚需。TikTokUploader构造函数直接暴露了这些能力浏览器选择browser参数支持 chrome、edge、chromium、firefox、safari其中 Chrome 是官方推荐反检测优化最好代理设置proxy参数传入{host, port}字典支持带账号密码的代理无头模式headlessTrue可隐藏浏览器窗口适合服务器部署会话注入除了 cookies 文件还能直接传sessionid或cookies_list多账号轮换很方便。如果你需要更深层的定制比如修改 User-Agent、屏蔽 webdriver 特征可以查看src/tiktok_uploader/browsers.py中的get_browser()函数和src/tiktok_uploader/auth.py中的认证逻辑。注意自定义浏览器参数时保持反检测脚本不被破坏是关键这也是官方默认 Chrome 的原因。方式五继承 TikTokUploader 类打造你的专属上传器 最彻底、也最能体现“二次开发”价值的是直接继承TikTokUploader类进行扩展。它支持上下文管理器with语法和延迟初始化——浏览器在第一次上传时才启动这让子类扩展非常干净。一个典型的扩展场景上传前自动生成描述、上传后自动记录到数据库。from tiktok_uploader.upload import TikTokUploader class MyUploader(TikTokUploader): def upload_video(self, filename, description, **kwargs): # 自定义逻辑例如自动追加话题标签 description f{description} #fyp #auto return super().upload_video(filename, descriptiondescription, **kwargs) with MyUploader(cookiescookies.txt) as uploader: uploader.upload_video(video.mp4, description我的第一条自动视频)如果你想深入理解上传的每一个步骤选文件、填描述、加话题、设可见性、点发布可以直接阅读upload.py中的complete_upload_form()函数——它是整个上传流程的“流水线”读懂它你就能精准定位任何自定义上传行为应该加在哪一步。二次开发前必须知道的 3 个安全提醒 ⚠️控制频率项目官方明确指出它更适合做“定时发布器”而不是“刷量机器人”高频上传会导致发布失败甚至账号风险批量脚本务必加合理的间隔与重试验证话题与 用户描述中的#话题和用户需要你自行确认存在上传工具不会帮你校验Cookies 有效期sessionid 是免登录的关键过期后需要重新导出 cookies建议在脚本里加上失效检测。总结从“能用”到“好用”的进阶路线 你的需求推荐方式改动成本上传后发通知 / 记日志方式一on_complete 回调极低调整等待时间 / 支持格式方式二改 config.toml极低按表格批量发布方式三表格驱动脚本低多账号多 IP 运营方式四浏览器 代理中深度改造上传流程方式五继承扩展较高这 5 种扩展方式覆盖了从“配置级”到“代码级”的全部分层你可以根据自己的技术水平灵活组合。想从源码开始实践二次开发可以 clone 仓库后运行uv sync与uv run tiktok-uploader快速上手仓库地址为https://gitcode.com/gh_mirrors/ti/tiktok-uploader。希望这份 tiktok-uploader 二次开发指南能帮你把自动上传能力真正变成自己的生产力工具。动手试试你的第一个自定义上传器很快就能跑起来【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考