social-auto-upload

一次制作，全平台分发——这款GitHub超万星的开源工具正在改变内容创作者的发布方式

在AI内容生成井喷的2026年，创作者面临的新痛点不再是"如何生产内容"，而是"如何高效分发"。social-auto-upload（简称SAU）正是为解决这一痛点而生的开源利器——一个让你一条命令把视频发到七个平台的自动化上传工具。

截至2026年8月，该项目已获得 14,595 颗 GitHub Star，社区活跃度持续攀升。本文将为你全面解析这款工具的核心功能、完整安装教程、实战使用指南及运营建议。

一、项目概述：什么是 social-auto-upload？

social-auto-upload 是一个基于 Playwright/Patchright 浏览器自动化框架的开源工具，旨在帮助内容创作者和运营者将视频内容一键发布到多个国内外主流社交媒体平台。它通过模拟真实用户行为（点击、输入等），绕过API限制，实现"无痕上传"。

项目主页：官方文档 https://sap-doc.nasdaddy.com/ ｜ GitHub https://github.com/dreammis/social-auto-upload

支持平台一览

此外，项目还支持 微博、虎扑、支付宝生活号、YouTube 等平台的上传扩展。

二、核心功能特性

1. 跨平台内容矩阵

在信息爆炸的时代，多平台内容分发是创作者成功的关键。SAU帮你构建内容分发矩阵，在多个社交平台同步发布，接触更广泛受众群体，实现内容价值最大化。

2. AI时代高效创作

在AI内容创作的新时代，SAU解放你的创作精力，让自动化工具处理繁琐的发布流程，让你专注于创造优质内容。

3. 智能发布调度

支持定时发布、智能排队和流量高峰期调度，根据平台算法特性自动选择最佳发布时间，提升内容触达效果。

4. Agent-First 设计理念

项目采用"Agent-First"理念，将平台交互标准化为少数几个动词（login、check、upload-video、upload-note），AI智能体可像调用统一API一样操作。目前已与 OpenClaw 等AI智能体完美集成。

5. 统一 CLI 工具

提供统一的 sau 命令行工具，支持所有平台的操作。

三、完整安装教程

前置要求：Python 3.10+、Git、Node.js v16+（部分功能依赖）

步骤 1：克隆仓库

git clone https://github.com/dreammis/social-auto-upload.git
cd social-auto-upload

步骤 2：创建虚拟环境并安装依赖

项目已过渡到 CLI-First 架构，推荐使用 uv 进行环境管理：

# 使用 uv（推荐）
uv venv
# Windows PowerShell
.venv\Scripts\activate
# Linux / macOS
source .venv/bin/activate

uv pip install -e .

或使用传统 pip 方式：

conda create -n social-auto-upload python=3.10
conda activate social-auto-upload
pip install -r requirements.txt

国内用户可添加清华镜像加速：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

步骤 3：安装浏览器驱动

项目使用 Patchright（Playwright 的防检测分支）进行浏览器自动化：

# 国内用户推荐使用镜像加速
# Windows
$env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"; patchright install chromium
# Linux/macOS
PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright" patchright install chromium

💡 Bilibili 平台使用独立的 biliup 二进制文件，系统会在首次运行时自动下载和更新。

步骤 4：配置文件

复制示例配置文件：

cp conf.example.py conf.py

关键配置参数

步骤 5：验证安装

sau --help
sau douyin --help
sau bilibili --help
sau kuaishou --help

四、实战使用教程

1. 账号登录与Cookie管理

每个平台需要先在真实浏览器中登录一次，导出Cookie后复用：

# 抖音登录
sau douyin login --account <账号名称>

# 检查登录状态
sau douyin check --account <账号名称>

⚠️ 重要提示：社交平台的反爬虫机制（如抖音的指纹检测）可能导致Cookie失效，定期刷新Cookie 是保持稳定运行的关键。

2. 上传视频

sau douyin upload-video --account <账号名称> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"

3. 多平台一键分发

# 使用示例脚本批量上传到多个平台
python sau_cli.py upload --platform douyin --video video.mp4 --title "我的视频"

4. 定时发布

集成 Cron 调度，支持批量定时发布数百个视频，特别适合 KOL 或 MCN 团队。

5. API 接口调用

项目提供后端 API 接口：

• /upload：上传文件，返回唯一ID
• /postVideo：发布视频，传入文件ID和账号列表

五、实用建议与最佳实践

1. Cookie 管理策略

• 建议为每个平台单独维护一个浏览器 profile
• 设置定期（如每周）手动刷新Cookie
• 使用数据库记录Cookie有效期和上传日志

2. 代理配置

• YouTube 等国际平台需配置 YT_PROXY
• 多账号运营建议使用代理池，降低关联风险

3. 内容格式适配

• 不同平台对视频尺寸、时长、格式有不同要求，建议在上传前做好格式转换
• 小红书和快手同时支持视频和图文内容

4. 安全使用提醒

• 工具模拟人类行为（含随机延迟），请合理使用，避免高频操作
• 建议将日发布量控制在平台正常创作者范围内
• 关注各平台政策变化，及时更新上传策略

5. 社区与生态

• 已有社区开发者基于原项目开发了 Web UI 版本（千帆云递/QianFan Sync），提供了更友好的可视化界面
• 项目支持 Agent Skill 系统，可与 OpenClaw 等 AI 框架无缝集成
• 欢迎加入项目交流群探讨技术变现、AI创业等话题

六、总结

social-auto-upload 是 2026 年内容创作者和运营团队不可多得的开源效率工具。它解决了"内容生产自动化后分发仍靠手动"的最后一公里问题，让创作者可以：

• 节省 80% 的分发时间
• 覆盖 7+ 主流平台
• 一次制作，全平台触达

无论你是个人创作者、MCN机构还是企业内容团队，SAU都值得纳入你的内容工作流。从克隆仓库到第一条视频自动上传，全程不超过30分钟——现在就开始你的自动化分发之旅吧！