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。opub 自身不设账号。购买时无需提前注册爱发电；请使用你自己的手机号或邮箱完成验证，首次购买时爱发电会自动生成账号。付款后复制爱发电发放的激活码；请勿向 Agent 提供验证码或账号密码。激活码首次兑换后绑定一个设备；许可不迁移、不解绑、不提供换机重置，新电脑重新购买。该许可覆盖 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 重构而来，感谢原作者及贡献者。
许可证
1 maintainer
Release files for opub 0.8.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| opub-0.8.2.tar.gz | 170.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| opub-0.8.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 306.9 kB
Release files / opub-0.8.2.tar.gz
| Download URL | opub-0.8.2.tar.gz |
|---|---|
| Size | 170.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8dcc7b801f0019201ba998f255203b6a861aa28ee029bc9ffd02e8aa463dc6a4
|
|
BLAKE2b-256 checksum How to use checksums |
e17afe61f132cc9a7ec8040e1726537246b934a5efd49136adebba819a0cf9d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / opub-0.8.2-py3-none-any.whl
| Download URL | opub-0.8.2-py3-none-any.whl |
|---|---|
| Size | 136.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b69687c744ac6a5d3d738403e41dfa171eeb67e2cc52072a4ab2cbf62e5d2a2b
|
|
BLAKE2b-256 checksum How to use checksums |
cd932a6dedecee9a4cc365af45ad5a63b2d0933cc720aaeb635f3e089f5a2edb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
