opub

opub 是一个强大的自动化工具，旨在帮助内容创作者和运营者高效地将视频内容一键发布到多个国内外主流社交媒体平台。项目实现了对 抖音、Bilibili、小红书、快手、视频号、百家号 以及 TikTok 等平台的视频上传、定时发布等功能。当前推荐通过 publish_config.ini 配置内容、素材、平台和账号，然后执行 opub 完成统一发布流程。

💎 赞助商

	ClawPower 是一家稳定可靠 AI 大模型中转服务商，提供 Claude、GPT、Gemini 60+ 大模型接入。无论是 OpenClaw、Hermes 智能体自动化场景，Claude Code、Codex 编程工具接入，还是公众号、小红书内容创作；都能获得稳定、顺滑、可长期使用的模型服务体验。低至官方价格的 30%，点击免费领取 5 刀现金体验券
	成为赞助商如果您有意赞助本项目，请扫描左侧微信二维码（添加时请注明来意：赞助）。

💡功能特性

平台	登录/账号准备	视频上传	图文上传	定时发布	CLI	Skill	说明
抖音	✅	✅	✅	✅	✅	✅	当前主线重构最完整
Bilibili	✅	✅	❌	✅	✅	✅	运行时自动准备 `biliup`
小红书（浏览器版）	✅	✅	✅	✅	✅	✅	浏览器自动化，CLI/Skill 已接入
快手	✅	✅	✅	✅	✅	✅	浏览器自动化，CLI/Skill 初版已接入
视频号	✅	✅	❌	✅	❌	❌	对应 `tencent_uploader`
百家号	✅	✅	❌	✅	❌	❌	浏览器自动化
TikTok	✅	✅	❌	✅	❌	❌	当前示例走 Chrome 版实现

AI这么强，为什么还需要这个项目

在你使用AI的能力，browser agent等等，每次都让 agent 重新解析网页、截图理解, 临场判断该项目经过大量验证，上传这种高频，重复，无聊的工作交给脚本和程序去执行

💾安装指南

自己上手使用

如果你只是普通用户，不准备借助 agent 客户端，直接看

安装、更新、环境准备已经统一收敛到文档：

AGENT

AI的发展毋庸置疑，希望你遇到这种安装和使用，不要再怯场，而是交给各种AI Agent来协助你

如果你准备把这个仓库直接交给 OpenClaw、Codex、Claude Code 来安装和使用

先把仓库给 agent，再把这份启动提示词一起发给它：

Agent Bootstrap Prompt

这份提示词会引导 agent：

优先按当前主线安装项目
优先使用 uv、publish_config.ini 和 opub
先验证统一发布入口是否可用，再按配置完成发布

补充说明：

CLI 使用请看：CLI 使用说明
如果你准备在 OpenClaw、Codex、Claude Code / cc 里使用本项目，先看：Agent Bootstrap Prompt
agent / skill 请看：opub CLI Skill
不再维护单平台独立 CLI skill，agent 统一走 opub
requirements.txt 目前主要用于历史兼容路径，普通用户不需要优先使用它
本项目不维护国际化文档，当前文档以中文优先。

📣近况说明

2026.03.24

最近我的重心一直都在创业上，而且手里还有一些项目没完全跑通，所以这个仓库前面有很长一段时间，我确实没有办法投入特别多精力去持续维护。

这个项目不知不觉已经 9k+ star 了，社群里也已经有 2000+ 小伙伴了。看到它真的在持续帮到大家，我心里还是挺开心的，也是真的很感谢大家一直以来的支持、反馈。

所以我想，决定先停一下，抽一段时间出来，把这个项目好好重构和优化一轮。

接下来这段时间，这个仓库应该会进入一个相对密集更新的阶段。我现在最想先做的事情主要有这几件：

使用更隐蔽、更稳定的自动化方案，尽量降低平台检测风险
补齐一些常用平台的图文能力，并逐步完成 CLI 化、Skill 化
陆续测试并上架到更多 skill 平台，让大家的龙虾、螃蟹、毛毛虫都能打通 AI 自媒体的最后一道关

所以如果你之前觉得这个项目更新有点慢，哈哈哈，后面大概率会快很多。也欢迎大家继续关注，最近应该会是一段持续修、持续更、持续重构的阶段。

🗂️重构计划

项目正在进行一轮整体重构，当前重构重点是：

各平台 uploader 的结构收敛
CLI 统一接入
面向 OpenClaw、Codex、 Claude Code 等工具的 skill 化
更换为 patchright 驱动，提升兼容性与隐蔽性
主线优先围绕无头模式推进

“无头模式（headless）”，指的是浏览器在后台运行，不弹出可见窗口，但自动化流程仍然会照常执行。这样更适合 CLI、服务端、自动任务和 agent 场景。

Web 端相关代码仍然保留，但已经不是当前主线，不保证可直接运行，也不保证与当前 uploader/CLI 完全同步。

快速开始

编辑 publish_config.ini，配置内容、素材路径、启用平台和账号文件。
执行统一发布入口：

opub

如需临时覆盖配置：

opub --platforms douyin,weibo --video videos/demo.mp4 --title "标题"

opub 会自动完成运行环境预检、账号登录校验、发布和结果汇总。

publish_config.ini 是主要控制文件，用于配置内容、素材路径、启用平台、账号文件、定时发布和平台元数据。命令行参数只用于临时覆盖本次运行的配置。

examples

examples/ 目录里同时存在两类脚本：

当前主线 CLI 包装示例
历史直连 uploader 示例

对抖音、快手、小红书、Bilibili 和微博来说，当前主线只推荐使用上面的统一发布入口。下面这些脚本主要是历史直连 uploader 示例或调试入口：

examples/upload_to_douyin.py
examples/upload_video_to_bilibili.py
examples/upload_to_kuaishou.py
examples/upload_video_to_tencent.py
examples/upload_video_to_baijiahao.py
examples/upload_video_to_tiktok.py
examples/upload_video_to_xiaohongshu.py

🐇项目背景

该项目最初是我个人用于自动化管理社交媒体视频发布的工具。我的主要发布策略是提前一天设置定时发布，因此项目中很多定时发布相关的逻辑是基于“第二天”的时间进行计算的。

如果您需要立即发布或其他定制化的发布策略，欢迎研究源码或在社区提问。

📃详细文档

已落后，目前在快速重构该项目，当下，你需要做的是把这个仓库，发给你的AI agent：qwen code，codex cc，openclaw等等，让他们帮你安装和使用

更详细的文档和说明，请查看：social-auto-upload 官方文档

🐾交流与支持

☕ Donate as u like - 如果您觉得这个项目对您有帮助，可以考虑赞助。

如果您也是独立开发者、技术爱好者，对 #技术变现 #AI创业 #跨境电商 #自动化工具 #视频创作等话题感兴趣，欢迎加入社群交流。

Creator

_{微信公众号}
💻
关注公众号，后台回复 `上传` 获取加群方式

_{交流群 (通过公众号获取)}
📖
如果您觉得项目有用，可以考虑打赏支持一下

Active Core Team

_{Edan Lee}
💻 📖
封装了 api 接口和 web 前端管理界面
（请注明来意：进群、学习、企业咨询等）

🤝贡献指南

欢迎各种形式的贡献，包括但不限于：

提交 Bug报告和 Feature请求。
改进代码、文档。
分享使用经验和教程。

如果您希望贡献代码，请遵循以下步骤：

Fork 本仓库。
创建一个新的分支 (git checkout -b feature/YourFeature 或 bugfix/YourBugfix)。
提交您的更改 (git commit -m 'Add some feature')。
Push到您的分支 (git push origin feature/YourFeature)。
创建一个 Pull Request。

🙏致谢

本项目的 Bilibili 上传能力基于开源项目 biliup 的能力进行接入与封装。感谢 biliup 项目及其贡献者提供的基础能力：

https://github.com/biliup/biliup

📜许可证

本项目暂时采用 MIT License 开源许可证。

⭐Star-History

如果这个项目对您有帮助，请给一个 ⭐ Star 以表示支持！

Community

LINUX DO - The New Ideal Community

Release files for opub 0.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opub 0.5.1
File	Size	Uploaded
opub-0.5.1.tar.gz	138.3 kB	Aug 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for opub 0.5.1
File	Interpreter	ABI	Platform	Reset
opub-0.5.1-py3-none-any.whl 128.8 kB Aug 20, 2026	Python 3	none	any	Details

Total release size: 267.0 kB

Release files / opub-0.5.1.tar.gz

Download URL	opub-0.5.1.tar.gz
Size	138.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`a1a6843c0b098aec4d385d3dbf8b96188560dcf210fff3d66f082b005906ab2a`
BLAKE2b-256 checksum How to use checksums	`4dc91535b3a7f6b19d9a0d758868a799bc0112a8de708cc5a3e2a59e8eefe45f`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.7`

Release files / opub-0.5.1-py3-none-any.whl

Download URL	opub-0.5.1-py3-none-any.whl
Size	128.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fb8aa2cfc6d75a9e66c3ca08f402a0921054fe01caa79fd629fa118f5d60713a`
BLAKE2b-256 checksum How to use checksums	`89f8490045f4ccbb376da7af128f5415dc06d9681b960855c24ae7f83e37dc36`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.7`