social-auto-upload 多平台视频批量上传实操指南

2026/11/2 15:14:17

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.py

uv 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是最贴近当前版本的参考。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

social-auto-upload 多平台视频批量上传实操指南