social-auto-upload 多平台视频批量上传实操指南
【免费下载链接】social-auto-upload自动化上传视频到社交媒体：抖音、小红书、视频号、tiktok、youtube、bilibili项目地址: https://gitcode.com/GitHub_Trending/so/social-auto-upload
social-auto-upload 是一个基于浏览器自动化的社交媒体发布工具，覆盖抖音、小红书、Bilibili、快手、视频号等 17 个平台，登录、状态检查、发布都通过sau命令行完成。它面向需要多平台分发内容的创作者和运营团队，省掉逐个打开各平台创作者中心、粘贴标题、手动上传同一条视频的流程。
这篇文章的写法是：先装好环境，把"登录 → 检查 → 上传"的通用流程跑通一遍，之后遇到具体平台再查差异表即可。
环境准备 ⚙️
从克隆到可用，Linux/macOS 下共 7 行命令：
git clone https://gitcode.com/GitHub_Trending/so/social-auto-upload.git cd social-auto-upload uv venv source .venv/bin/activate # Windows: .venv\Scripts\activate uv pip install -e . PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright" patchright install chromium cp conf.example.py conf.pyuv pip install -e .会注册sau命令，装完直接sau --help验证- 浏览器驱动用
patchright驱动 Chromium，镜像前缀是给国内网络用的，能直连官方源可以去掉 conf.py里有LOCAL_CHROME_HEADLESS、DEBUG_MODE、YT_PROXY等开关，按需修改- 不确定某平台支持哪些参数时，
sau <platform> --help的输出比文档更实时
通用工作流 🔄
每个平台都是同三步：先login登录一次保存本地会话，再check确认会话有效，最后执行upload-video或upload-note发布。--account是本地取的名字，一个名字对应一个账号文件，同一条命令链里保持一致即可。
以抖音为完整示例：
sau douyin login --account creator sau douyin check --account creator sau douyin upload-video --account creator --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags 运动,训练其他平台只需替换平台名，参数大体不变。下图是抖音创作者中心的自动化发布页面，标题、简介、话题都会由程序填入：
当前各平台能力一览：
| 平台 | sau 参数 | 视频 | 图文 | 定时 | CLI |
|---|---|---|---|---|---|
| 抖音 | douyin | ✅ | ✅ | ✅ | ✅ |
| 快手 | kuaishou | ✅ | ✅ | ✅ | ✅ |
| 小红书 | xiaohongshu | ✅ | ✅ | ✅ | ✅ |
| Bilibili | bilibili | ✅ | - | ✅ | ✅ |
| 视频号 | tencent | ✅ | - | ✅ | ✅ |
| 百家号 | baijiahao | ✅ | - | - | ✅ |
| TikTok | tiktok | ✅ | - | ✅ | - |
TikTok 没有 CLI 子命令，走 Chrome 版上传器；更多平台（微博、虎扑、YouTube、Facebook、Instagram、知乎、雪球等）的能力以仓库 README 表格为准。
平台差异速查 🔍
与通用流程不同的地方集中在下面这张表，遇到对应平台再查：
| 平台 | 注意点 |
|---|---|
| Bilibili | 必须传--tid分区 ID（249 为体育-足球）；首次运行自动下载并更新biliup，无需手动安装 |
| 抖音 | 上传过程可能触发短信二次验证；程序优先读取项目根目录verify_code.txt，交互式终端也可直接输入 |
| 小红书 | 图文至少 1 张图传给--images；视频可用--thumbnail指定封面 |
| 微博 / 虎扑 | 标题字数限制：微博 ≤30 字，虎扑 4–40 字 |
| Facebook / Instagram | 默认走系统网络直连；需要代理时加--proxy |
| TikTok | Chrome 版上传器实现，参考 examples 里的示例脚本 |
进阶用法 📈
定时发布：多数平台支持--schedule "YYYY-MM-DD HH:MM"，到点由平台自动发出。大鱼号限制更严：须在 2 小时后至 7 天内，且分钟为 5 的倍数。
sau douyin upload-video --account creator --file video.mp4 --title "定时视频" --desc "描述" --schedule "2026-06-01 18:00"批量处理：用 shell 或 Python 脚本遍历视频文件夹，逐个调用 CLI 即可；仓库里examples/upload_video_to_bilibili.py是现成参考。
多账号管理：多个账号各用一个--account名字，不同账号的上传任务可以并行跑。
文章发布：大鱼号、雪球、知乎支持upload-article，正文来自 HTML/Markdown/TXT 文件，图片写在原稿对应位置，雪球还支持长文封面。
排障速查 🛠
sau命令找不到
- 现象：终端提示
sau: command not found - 原因：虚拟环境未激活，或漏跑
uv pip install -e . - 解法：激活
.venv后重新执行安装命令
Chromium 下载卡住或失败
- 现象：
patchright install chromium长时间无输出 - 原因：直连官方源慢
- 解法：安装前加镜像前缀
PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"
Bilibili 登录二维码显示不完整
- 现象：终端里二维码渲染成马赛克
- 原因：终端渲染限制
- 解法：直接打开当前目录下的
qrcode.png扫码
check提示会话失效、cookie 无效
- 现象：
sau <platform> check --account ...报错 - 原因：平台 cookie 过期
- 解法：重新执行
<platform> login --account ...登录
抖音登录卡住，或在无图形界面的远程服务器
- 现象：登录步骤无法完成交互
- 原因：远程环境没有浏览器可扫码
- 解法：手动登录抖音创作者中心后，执行
bash export_douyin_cookie.sh --account <name>导出 cookie，再check验证
项目结构速览 🗂
- sau_cli.py：CLI 主入口，负责组装各平台子命令
- sau_commands/：各平台参数定义与执行逻辑
- uploader/：各平台发布实现，如
douyin_uploader、xiaohongshu_uploader、bilibili_uploader - examples/：可运行的上传、图文、获取 cookie 示例脚本
- skills/：供 Codex、Claude Code 等 Agent 使用的各平台 Skill 入口
如果只维护两三个平台，先把通用工作流跑到登录和检查都通过，再逐步加定时与批处理。参数拿不准时，sau <platform> --help是最贴近当前版本的参考。
【免费下载链接】social-auto-upload自动化上传视频到社交媒体：抖音、小红书、视频号、tiktok、youtube、bilibili项目地址: https://gitcode.com/GitHub_Trending/so/social-auto-upload
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
