social-auto-upload

social-auto-upload 是一个面向内容创作者和运营者的多平台发布工具，提供统一 CLI 和供 Codex、OpenClaw、Claude Code 等 Agent 使用的 Skill。

支持的视频、文章、图文发布平台及对应入口见下表。

CLI 命令按平台维护在 sau_commands/，发布流程位于 uploader/。日常变更记录见 CHANGELOG.md，稳定版本通过 GitHub Release 发布。

💎 赞助商

	感谢 DolOffer 对本项目的支持！对于做内容矩阵、多平台分发和 AI 自动化运营的创作者来说，ChatGPT、Claude、YouTube Premium、Spotify、Apple Music、Notion、Office 等数字工具往往是长期成本。DolOffer 提供 AI、视频、音乐和效率工具相关的订阅与充值服务，帮助用户更低成本地配置常用数字产品。更多说明可查看 DolOffer Guide。使用优惠码 AI8888 可额外享受 9 折优惠，具体价格和服务规则以官网为准。
	轻视AI：一句话生产MG动画，适合知识，科普，讲解，教程，介绍等类型视频的低成本制作，视频矩阵，养号等，成本只有seedance等1%。现在注册送1500积分
	ClawPower 是一家稳定可靠 AI 大模型中转服务商，提供 Claude、GPT、Gemini 60+ 大模型接入。无论是 OpenClaw、Hermes 智能体自动化场景，Claude Code、Codex 编程工具接入，还是公众号、小红书内容创作；都能获得稳定、顺滑、可长期使用的模型服务体验。低至官方价格的 30%，点击免费领取 5 刀现金体验券
	成为赞助商 如果您有意赞助本项目，请扫描左侧微信二维码（添加时请注明来意：赞助）。

---

目录

• 💡 功能特性
• 💾 安装指南
• 🤖 AI Agent
• 🏁 快速开始
• 📝 更新日志
• 📃 详细文档
• 🐾 交流与支持
• 🤝 贡献指南
• 📜 许可证
• ⭐ Star History

💡功能特性

平台	登录/账号准备	视频	文章	图文	定时发布	CLI	Skill	说明
抖音	✅	✅	-	✅	✅	✅	✅	视频与图文发布
Bilibili	✅	✅	-	-	✅	✅	✅	视频发布；运行时自动准备 biliup
小红书（浏览器版）	✅	✅	-	✅	✅	✅	✅	视频与图文发布
快手	✅	✅	-	✅	✅	✅	✅	视频与图文发布
视频号	✅	✅	-	-	✅	✅	✅	视频发布
百家号	✅	✅	-	-	-	✅	✅	视频发布
大鱼号	✅	✅	✅	-	✅	✅	✅	视频发布；文章发布支持 HTML/Markdown/TXT、正文图片和封面
支付宝生活号	✅	✅	-	-	-	✅	✅	视频发布
微博	✅	✅	-	-	-	✅	✅	视频标题最多 30 字
虎扑	✅	✅	-	-	-	✅	✅	视频标题 4–40 字
TikTok	✅	✅	-	-	✅	-	✅	Chrome 版实现；没有 sau CLI
雪球	✅	-	✅	-	-	✅	✅	长文与配图：支持 HTML/Markdown/TXT、正文图片和封面
YouTube	✅	✅	-	-	开发中	✅	✅	视频发布
知乎	✅	✅	✅	-	实验性	✅	✅	文章与视频发布，文章支持正文位置配图
Facebook	✅	✅	-	✅	-	✅	✅	支持作品查询、移至回收站及永久删除
Facebook Page	✅	✅	-	✅	✅	✅	✅	支持视频与图文定时发布、查询和取消定时
Instagram	✅	✅	-	✅	-	✅	✅	支持 Reels、单图与轮播

✅ 表示支持，- 表示不适用或未提供；开发中、实验性 不计入稳定能力。文章正文可以包含图片，与独立图文发布分列。

按内容形态

内容形态	平台与入口
视频	抖音、快手、小红书、Bilibili、视频号、百家号、大鱼号、知乎、YouTube 等；CLI 示例见下方和CLI 使用说明
文章	大鱼号文章发布、雪球长文与配图、知乎文章发布
图文	抖音、快手、小红书、Facebook、Facebook Page、Instagram；CLI 示例见CLI 使用说明

文章主题预览及 Markdown 转 HTML：见 文章文件与主题渲染。内置 default/grace/simple/modern/plain 主题；大鱼号可直接接收 Markdown，并将主题转换为保留文字颜色、背景和近似字号的兼容排版，圆角和精确间距等效果可能与本地预览不同。

💾安装指南

自己上手使用

普通用户可按以下文档安装和更新：

• 安装说明
• 更新说明

AI Agent

若使用 OpenClaw、Codex 或 Claude Code 安装和操作本项目，可将仓库与启动提示词一并交给 Agent：

• Agent Bootstrap Prompt

它会引导 Agent：

• 优先按当前主线安装项目
• 优先使用 uv、sau CLI 和 skills/
• 先验证 bilibili、douyin、kuaishou、xiaohongshu 四个平台入口是否可用

相关入口：

• CLI 使用说明
• Agent Bootstrap Prompt
• 跨平台总入口：social-auto-upload
• 各平台 Skill：抖音、Bilibili、小红书、快手、视频号、百家号、大鱼号、支付宝生活号、微博、虎扑、TikTok、雪球、YouTube、知乎、Facebook、Facebook Page、Instagram
• 历史 Web 版本说明

Skill 分发与市场

仓库提供跨平台总入口和各平台独立 Skill。skills.sh 已收录抖音 Skill；各市场收录、上架方式和新增平台检查清单见Skill 分发渠道与发布状态。

Skill 目录可从 GitHub 安装到兼容 Agent。安装单个 Skill：

npx skills add dreammis/social-auto-upload --skill douyin-upload

将 douyin-upload 换成总入口或其他平台目录名。各目录对应关系、市场上架方式和状态见 Skill 分发说明；sau skill install 不是本项目提供的命令。

🏁快速开始

方式 1：使用 CLI

先按上方平台能力表确认支持范围，再选择下面的内容类型。视频、文章和图文分别使用独立发布命令；文章中的配图仍属于文章正文。

账号准备

每个平台先登录一次，再检查会话。--account 是你给本地会话取的名字，例如 creator，用于区分多个账号。

sau douyin login --account creator
sau douyin check --account creator
# 换成 dayu、xueqiu、zhihu 等平台名称即可；具体登录要求见对应文档。

视频

按平台选择 upload-video：

平台	平台参数	发布说明
抖音、快手、小红书	douyin、kuaishou、xiaohongshu	CLI 参数
Bilibili、视频号	bilibili、tencent	CLI 参数
百家号、大鱼号	baijiahao、dayu	大鱼号视频、CLI 参数
支付宝生活号、微博、虎扑	alipay、weibo、hupu	CLI 参数
YouTube	youtube	CLI 参数
知乎	zhihu	文章与视频发布
Facebook、Facebook Page、Instagram	facebook、facebook-page、instagram	CLI 参数

sau douyin upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
sau kuaishou upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
sau xiaohongshu upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
sau bilibili upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tid 249
sau tencent upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2
sau baijiahao upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2
sau alipay upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2
sau weibo upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2
sau hupu upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2
sau youtube upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2 --playlist "我的系列" --visibility public
sau zhihu upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --originality original --category "教育" --video-mark "内容无需标注"
sau facebook upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags Facebook,测试
sau facebook-page upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --page "我的 Page"

文章

文章使用 upload-article，正文来自文件，图片应写在原稿对应段落中。支持平台分别如下：

平台	正文与说明
大鱼号	HTML / Markdown / TXT、正文插图及封面，见文章发布
雪球	HTML / Markdown / TXT、正文原位置配图及独立封面，见长文发布
知乎	HTML / Markdown / TXT、正文原位置配图，见文章发布

sau dayu upload-article --account creator --title "如何阅读作品数据面板" --content-file examples/dayu_article.html --source "无需标注" --cover-indices 1
sau xueqiu upload-article --help
sau zhihu upload-article --account creator --title "文章标题" --content-file examples/article.md

图文

图文指独立图片帖、轮播或图片笔记，使用 upload-note；支持抖音、快手、小红书、Facebook、Facebook Page 和 Instagram。

sau douyin upload-note --account <account_name> --images videos/1.png videos/2.png --title "图文标题" --note "图文正文"
sau kuaishou upload-note --account <account_name> --images videos/1.png videos/2.png videos/3.png --title "图文标题" --note "图文正文"
sau xiaohongshu upload-note --account <account_name> --images videos/1.png videos/2.png videos/3.png --title "图文标题" --note "图文正文"
sau facebook-page upload-note --account <account_name> --images images/1.jpg --title "Page 图文" --note "正文" --page "我的 Page" --schedule "2026-10-21 10:30" --result .local/page-result.json
sau facebook upload-note --account creator --images images/1.jpg images/2.jpg --title "图片帖" --note "正文"
sau instagram upload-note --account creator --images images/1.jpg images/2.jpg --title "图片轮播" --note "正文"

知乎的 --account 是本地会话别名，不要求和展示名一致；登录时程序直接读取页面当前身份并保存绑定信息。

Facebook、Facebook Page 和 Instagram 默认使用系统网络直连。网络环境需要代理时，给对应命令显式添加 --proxy "代理地址"，或设置 SAU_FACEBOOK_PROXY、SAU_FACEBOOK_PAGE_PROXY、SAU_INSTAGRAM_PROXY；传 --proxy "" 可忽略环境变量并直连。

YouTube 说明：登录是交互式的（Google 账号，浏览器里完成，无二维码）。这里走浏览器自动化而不是官方 API， 是因为未通过 Google 合规审核的 API 项目上传的视频会被强制锁为私享、无法改公开，对个人/单频道不实用； 浏览器自动化没有此限制，可直接发布公开视频，也与本项目其它平台的 cookie 方案一致。 --playlist 适合连载/系列追更；--visibility 可选 public/unlisted/private。 上传会等进度到 100% 再点发布（浏览器上传靠窗口开着传，传一半就发布会被掐断卡在中途）。 youtube.com 被墙的地区：在 conf.py 设 YT_PROXY = "http://127.0.0.1:7890"（chromium 不吃系统代理，需显式指定）。

Markdown 主题文章首次使用需要 Node.js 22+，先准备渲染依赖，再发布：

sau article setup
sau article render --content-file examples/article.md --theme modern --output output/article.html
sau dayu upload-article --account <account_name> --title "如何阅读作品数据面板" --content-file examples/article.md --theme modern --source "无需标注" --cover-indices 1

sau article render 只生成本地 HTML；sau dayu upload-article 会实际发表，平台确认发表后即返回成功，不等待审核。HTML/TXT 输入不需要 Node.js，也不使用 --theme。大鱼号视频参数和文章格式限制分别见 视频说明、文章说明。

补充说明：

• creator 之类的名字只是示例值，真正含义是 account_name
• 一个 account_name 对应一个账号文件，可以准备多个账号，也可以按账号名并发执行任务
• 抖音视频发布若触发短信二次验证，程序会优先读取项目根目录下的 verify_code.txt；如果你是在本地交互式终端手动运行 CLI，也可以直接按终端提示输入验证码
• 浏览器平台统一约定：
• 视频使用 title + desc + tags
• 抖音、快手、小红书的图片笔记使用 title + note + tags
• 大鱼号文章使用 title + content-file + source，正文保存在 HTML、Markdown 或 TXT 文件中
• Bilibili CLI 不要求用户手动安装 biliup
• 首次运行相关命令时，程序会自动下载 biliup
• 后续运行会自动检查上游 release 并更新
• Bilibili 登录建议由用户自己在本地真实终端里执行；如果终端二维码显示不完整，可以直接打开当前目录下的 qrcode.png 扫码

方式 2：使用 examples

examples/ 目录里同时存在两类脚本：

• 当前主线 CLI 包装示例
• 历史直连 uploader 示例

对抖音、快手、小红书、Bilibili 来说，当前主线优先使用上面的 sau ... CLI。 下面这些脚本主要是历史直连 uploader 示例或调试入口：

• examples/upload_to_douyin.py
• examples/upload_video_to_bilibili.py
• examples/upload_to_kuaishou.py
• examples/upload_video_to_tencent.py
• examples/upload_video_to_baijiahao.py
• examples/get_alipay_cookie.py
• examples/test_alipay_upload.py
• examples/upload_video_to_tiktok.py
• examples/upload_video_to_xiaohongshu.py

📃详细文档

安装、更新和平台参数见仓库内对应文档：安装说明、更新说明、CLI 使用说明。产品介绍与社区信息见 social-auto-upload 文档站。

🐾交流与支持

☕ Donate as u like - 如果您觉得这个项目对您有帮助，可以考虑赞助。

如果您也是独立开发者、技术爱好者，对 #技术变现 #AI创业 #跨境电商 #自动化工具 #视频创作 等话题感兴趣，欢迎加入社群交流。

Creator

微信公众号 💻 关注公众号，后台回复 `上传` 获取加群方式

交流群 (通过公众号获取) 📖 如果您觉得项目有用，可以考虑打赏支持一下

🤝贡献指南

欢迎各种形式的贡献，包括但不限于：

• 提交 Bug报告 和 Feature请求。
• 改进代码、文档。
• 分享使用经验和教程。

如果您希望贡献代码，请遵循以下步骤：

1. Fork 本仓库。
2. 创建一个新的分支 (git checkout -b feature/YourFeature 或 bugfix/YourBugfix)。
3. 提交您的更改 (git commit -m 'Add some feature')。
4. Push到您的分支 (git push origin feature/YourFeature)。
5. 创建一个 Pull Request。

提交代码或常规文档前，请确认您有权提交相关内容，并同意这些贡献按照本项目的 MIT License 发布。skills/ 下的 Skill 按各自 frontmatter 声明为 MIT-0；提交第三方内容时，请同时说明来源及其适用的许可证。

新增或修改平台时，请在同一个 PR 更新 CLI 能力表、对应平台 Skill 和分发目录；缺少 CLI 的平台也要说明实际调用入口。GitHub PR 模板包含逐项检查清单，避免实现完成后漏掉 Skill 发布材料。

主要贡献者

🙏致谢

本项目的 Bilibili 上传能力基于开源项目 biliup 的能力进行接入与封装。 感谢 biliup 项目及其贡献者提供的基础能力：

• https://github.com/biliup/biliup

本项目依赖的第三方组件和运行时工具仍受其各自许可证约束。下游发行或集成本项目时，请同时检查并保留相关第三方组件要求的版权、许可证和 NOTICE 声明。

📜许可证

仓库主体采用 MIT License。纳入版本控制的 Agent Skills 按各自 SKILL.md frontmatter 中声明的许可证发布；当前 18 个产品 Skill 为 MIT-0，以便在要求该许可证的平台分发。该范围不改变仓库其余代码的 MIT License。

⭐Star-History

如果这个项目对您有帮助，请给一个 ⭐ Star 以表示支持！