social-auto-upload:视频多平台一键分发工具
用浏览器自动化把一条视频分发到抖音、B 站、小红书、YouTube 等十一个平台,除 TikTok 外都已接入统一 CLI,可整包交给 AI agent 使用。
项目资料
GitHub Ecosystem- 许可证
- MIT
- 主语言
- Python
- 星标
- 15,399
- 核查时间
- 2026-10-11
以上快照资料以核查当日为准,可能随版本或运营策略变化。
同一条短视频要发到抖音、B 站和小红书,意味着三遍重复的登录、填标题、传文件。social-auto-upload 用 Python 和浏览器自动化接管了这套流程:驱动各平台网页端完成上传,不依赖官方 API。经过 2026 年 8 月的一轮密集重构,十一个支持的平台里十个已经统一到 sau 命令行,YouTube 也补齐了 CLI;仓库还内置一份「启动提示词」,把装环境、验平台的脏活整包交给 Claude Code、Codex 这类 agent。GitHubDaily 在 2025 年 4 月推荐过这款工具。

核心功能
- 十一个平台视频上传:国内九个——抖音、快手、小红书、B 站、视频号、微博、百家号、支付宝生活号、虎扑,加上 TikTok、YouTube。除 TikTok 仍走旧的 Chrome 示例脚本外,其余十个都接入了统一的
sauCLI。 - YouTube 的取巧:上传走浏览器自动化,README 把理由写得很直白——未经 Google 合规审核的 API 项目,传上去的视频会被强制锁为私享且无法改公开。CLI 支持
--playlist系列追更和--visibility三档可见性,上传会等进度到 100% 再点发布;YouTube 不可直连的地区在conf.py里配YT_PROXY。 - 图文与定时发布:抖音、小红书、快手支持图文笔记;抖音、B 站、小红书、快手、视频号、TikTok 支持定时发布。定时逻辑沿用作者「提前一天排第二天」的发布习惯,想立即发布要自己调整。
- AI agent 一条龙:
docs/agent-bootstrap.md提供一段整包启动提示词,连同仓库交给 OpenClaw、Codex、Claude Code 后,agent 会按uv加sau的主线装好环境,并逐一验证 bilibili、douyin、kuaishou、xiaohongshu 四个已验收平台的入口。 - 账号与验证码处理:每个
account_name绑定一份账号文件,支持按账号并发;抖音触发短信二次验证时,程序会读项目根目录的verify_code.txt,本地交互运行时也可以直接在终端输入。 - B 站免手动装 biliup:首次运行相关命令会自动下载
biliup,之后自动跟进上游更新;终端二维码显示不全时,可以直接扫工作目录下的qrcode.png。 - 各平台能力不齐整:微博标题上限 30 字、虎扑标题限 4–40 字,部分平台没有定时或图文能力;README 的能力矩阵逐项列出了每个平台的账号准备、CLI 与 skill 支持情况,选用前值得先看一眼。
典型使用场景
- 一条视频做完,用
sau批量分发到主要平台,省掉逐个手动上传的重复劳动。 - 矩阵运营:多账号各自维护配置,定时批量执行各自的发布任务。
- 把安装、登录、上传整条流水线交给 AI agent,人只负责产出内容。
快速上手
克隆仓库,用 uv 建好虚拟环境(详见仓库 docs/install.md):
git clone https://github.com/dreammis/social-auto-upload.git && cd social-auto-upload
uv venv && uv pip install -e . && patchright install chromium
cp conf.example.py conf.py
先登录账号,再执行上传:
sau douyin login --account <account_name>
sau douyin upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
不想自己装,就把仓库连同 docs/agent-bootstrap.md 里的启动提示词一起交给你的 agent 客户端。同类工具里想用图形界面的可以看 AiToEarn(覆盖 14 个平台、带 AI 生成),本项目胜在纯本地 Python CLI 和对 agent 的完整支持。
小结
适合短视频自媒体人、多账号矩阵运营者,以及想把上传流程交给 agent 的独立开发者。MIT 协议,可用于闭源商业软件。代价也要清楚:浏览器自动化意味着要用各平台真实账号扫码或 cookie 登录,平台一改版,对应的上传器就得跟着修——8 月那轮重构正是在追视频号改版和腾讯实名验证。重构仍在进行,patchright 驱动下的无头模式是当前主线,旧 Web 界面已停止维护;官方文档明确自述落后于代码,装不上时优先读仓库内的 docs/,或直接交给 agent。