opub

opub 是一个 Python 工具包，把视频/图文一键发布到国内主流社交媒体平台，支持定时发布。

已支持 抖音、小红书、快手、Bilibili、视频号、百家号、微博 共 7 个平台。项目以 AI Agent 技能（skill）为核心使用形态，也可以直接作为 CLI 使用。

功能特性

平台标识	名称	视频上传	图文上传	定时发布	说明
`douyin`	抖音	✅	✅	✅
`xiaohongshu`	小红书	✅	✅	✅	浏览器自动化
`kuaishou`	快手	✅	✅	✅	浏览器自动化
`bilibili`	B站	✅	❌	✅	运行时自动准备 `biliup`，自动抓取BV号
`tencent`	视频号	✅	❌	✅	分享短链通过 API 自动抓取
`baijiahao`	百家号	✅	❌	✅	浏览器自动化
`weibo`	微博	✅	❌	✅	单账号自动发现

所有平台通过统一入口 opub 调用，自动完成运行环境预检、账号登录校验、发布和结果汇总。

安装

pip install opub

系统依赖：

# 浏览器驱动（首次发布时会自动检查并尝试自动安装，失败时按提示手动执行）
PLAYWRIGHT_CHROMIUM_DOWNLOAD_HOST="https://cdn.playwright.dev" patchright install chromium

# ffmpeg（仅"图文转视频"功能需要）
# macOS: brew install ffmpeg
# Ubuntu/Debian: sudo apt-get install ffmpeg

首次运行会自动在 ~/.opub/ 创建数据目录（cookies 等）。可用环境变量 SAU_HOME 指定其他数据目录。

快速开始

opub 是无状态命令,全部配置通过命令行参数传入。每个平台只自动发现一个规范账号文件；未发现账号时，发布流程会引导扫码并写入对应上传器目录的 account.json。

# 视频发布(必填:--platforms + --video)
opub --platforms douyin,weibo --video videos/demo.mp4 --title "标题" --tags "标签1,标签2"

# 图文发布
opub --platforms xiaohongshu --note --images img1.jpg,img2.jpg --title "标题"

# 图文转视频(视频号/百家号等不支持图文的平台)
opub --platforms tencent --note --images img1.jpg --convert-to-video --video-duration 5

# 定时 / 断点续传 / 强制重新生成
opub --platforms weibo --video videos/demo.mp4 --schedule "2026-08-21 12:00" --start-from 2 --force

opub --version                        # 查看已安装版本
opub --help                           # 全部参数说明

AI Agent 技能

Agent 的完整接口契约见 skills/opub-cli/SKILL.md，安装、配置、调用、读取结果所需信息全部在其中。

付费许可

opub 0.x 创始版售价 ¥9.90，在爱发电商品页购买：https://afdian.com/item/69bf71f0a9f511f1bc065254001e7c00。爱发电发放的激活码首次兑换后绑定一个设备，不需账号；许可不迁移、不解绑、不提供换机重置，新电脑重新购买。该许可覆盖 0.x，已安装的 0.x 版本可永久离线使用；未来大版本需要单独购买。支付方式由用户在爱发电页面选择。公开 Python 包是诚实用户门禁，属于非强 DRM。

opub --license-status
opub --activate
opub --activate --code OPUB0-ABCDE-FGHJK-MNPQR-STVWX-YZ234-56789

交互运行 opub --activate 会打开购买页并提示输入激活码；Agent 应保留已经确认的发布输入，激活成功后自动继续同一个发布任务，不重复问参数。不要在输出或 internal log 中展示完整激活码或设备 hash。

错误码	含义	建议
`LIC-001`	尚未激活	执行激活命令
`LIC-002`	损坏签名	联系支持并提供错误码
`LIC-003`	许可属于其他设备	新电脑重新购买
`LIC-004`	稳定设备标识不可用	联系支持并提供错误码
`LIC-011`	服务不可用	稍后重试
`LIC-013`	激活码无效	检查激活码后重新激活
`LIC-014`	激活码已绑定其他设备	当前电脑重新购买
`LIC-015`	当前客户端版本不适用	升级或切换到 opub 0.x 后重试

完整 CLI 说明见 docs/CLI.md。

技能与运行时分发相互独立：Agent 平台安装技能时即获得 SKILL.md，运行时依赖由 Agent 按 SKILL.md 指引自行动 pip install opub 安装。

从源码运行（开发）：

git clone https://github.com/huanggenghg/opub.git
cd opub
uv venv && source .venv/bin/activate
uv pip install -e .

贡献指南

Fork 本仓库。
创建一个新的分支（git checkout -b feature/YourFeature）。
提交您的更改（git commit -m 'Add some feature'）。
Push 到您的分支并创建 Pull Request。

致谢

Bilibili 上传能力基于开源项目 biliup 接入与封装。
本项目基于 dreammis/social-auto-upload 重构而来，感谢原作者及贡献者。

许可证

MIT License

Release files for opub 0.8.0

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.8.0
File	Size	Uploaded
opub-0.8.0.tar.gz	170.4 kB	Sep 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for opub 0.8.0
File	Interpreter	ABI	Platform	Reset
opub-0.8.0-py3-none-any.whl 138.1 kB Sep 8, 2026	Python 3	none	any	Details

Total release size: 308.5 kB

Release files / opub-0.8.0.tar.gz

Download URL	opub-0.8.0.tar.gz
Size	170.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`809bd7e83b4aef617b35c88079e8cb55aa9caabb5ef67e8165747176decc4a1e`
BLAKE2b-256 checksum How to use checksums	`af5378a7a97b77788b7d77aa923d52202ee06214bdfe1142c238d58bf8b478ae`
Upload date	Sep 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

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

Download URL	opub-0.8.0-py3-none-any.whl
Size	138.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4eedba70fd277480af49fce15291d85fa07c6da4d23513019062df8ec5b4c974`
BLAKE2b-256 checksum How to use checksums	`8fdfbb0e282c4fa944fb2e01f0957524d4dbabbcfed7391b54bddb6d9b4430a9`
Upload date	Sep 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`