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 指定其他数据目录。

快速开始

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

opub

如需临时覆盖配置：

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

publish_config.ini 是主要控制文件，用于配置内容、素材路径、启用平台、账号文件、定时发布和平台元数据。命令行参数只用于临时覆盖本次运行的配置。发布结束后会自动清空一次性任务字段，账号文件配置保留。

AI Agent 技能

Agent 的完整接口契约见 skills/opub-cli/SKILL.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.5.2

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.2
File	Size	Uploaded
opub-0.5.2.tar.gz	134.4 kB	Aug 20, 2026	Details

Built distribution (wheel)

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

Total release size: 259.8 kB

Release files / opub-0.5.2.tar.gz

Download URL	opub-0.5.2.tar.gz
Size	134.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`29eeb32c958fc06f2e0c18ffa673943304f45ae76f269f1cb9786c1dbeabd647`
BLAKE2b-256 checksum How to use checksums	`59baa7b9e4aebaa3548422c0f7ec6a484ea7a3ecf1d21dcb65aade2d66e10201`
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.2-py3-none-any.whl

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