social-auto-upload README

The project's README from github.com/dreammis/social-auto-upload. As one markdown file: README.md.

social-auto-upload

social-auto-upload 是一个强大的自动化工具,旨在帮助内容创作者和运营者高效地将视频内容一键发布到多个国内外主流社交媒体平台。 项目实现了对 抖音、Bilibili、小红书、快手、视频号、百家号、支付宝生活号、微博、虎扑、TikTok 以及 YouTube 等平台的视频上传、定时发布等功能。 结合各平台 uploader 模块,您可以轻松配置和扩展支持的平台,并通过示例脚本快速上手。

tiktok show

💎 赞助商

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

目录

💡功能特性

平台 登录/账号准备 视频上传 图文上传 定时发布 CLI Skill 说明
抖音 ✅ ✅ ✅ ✅ ✅ ✅ 当前主线重构最完整
Bilibili ✅ ✅ ❌ ✅ ✅ ✅ 运行时自动准备 biliup
小红书(浏览器版) ✅ ✅ ✅ ✅ ✅ ✅ 浏览器自动化,CLI/Skill 已接入
快手 ✅ ✅ ✅ ✅ ✅ ✅ 浏览器自动化,CLI/Skill 初版已接入
视频号 ✅ ✅ ❌ ✅ ✅ ❌ 浏览器自动化,对应 tencent_uploader
百家号 ✅ ✅ ❌ ❌ ✅ ❌ 浏览器自动化
支付宝生活号 ✅ ✅ ❌ ❌ ✅ ❌ 浏览器自动化,支持生活号视频
微博 ✅ ✅ ❌ ❌ ✅ ❌ 浏览器自动化,标题最多 30 字
虎扑 ✅ ✅ ❌ ❌ ✅ ❌ 浏览器自动化,标题 4–40 字
TikTok ✅ ✅ ❌ ✅ ❌ ❌ 当前示例走 Chrome 版实现
YouTube ✅ ✅ ❌ ❌ ✅ ❌ 浏览器自动化(Studio),支持加入播放列表/可见性

AI这么强,为什么还需要这个项目

在你使用AI的能力,browser agent等等,每次都让 agent 重新解析网页、截图理解, 临场判断 该项目经过大量验证,上传这种 高频,重复,无聊的工作交给脚本和程序去执行

💾安装指南

自己上手使用

如果你只是普通用户,不准备借助 agent 客户端,直接看

安装、更新、环境准备已经统一收敛到文档:

AGENT

AI的发展毋庸置疑,希望你遇到这种安装和使用,不要再怯场,而是交给各种AI Agent来协助你

如果你准备把这个仓库直接交给 OpenClaw、Codex、Claude Code 来安装和使用

先把仓库给 agent,再把这份启动提示词一起发给它:

这份提示词会引导 agent:

补充说明:

📣近况说明

2026.03.24

最近我的重心一直都在创业上,而且手里还有一些项目没完全跑通,所以这个仓库前面有很长一段时间,我确实没有办法投入特别多精力去持续维护。

这个项目不知不觉已经 9k+ star 了,社群里也已经有 2000+ 小伙伴了。看到它真的在持续帮到大家,我心里还是挺开心的,也是真的很感谢大家一直以来的支持、反馈。

所以我想,决定先停一下,抽一段时间出来,把这个项目好好重构和优化一轮。

接下来这段时间,这个仓库应该会进入一个相对密集更新的阶段。我现在最想先做的事情主要有这几件:

  1. 使用更隐蔽、更稳定的自动化方案,尽量降低平台检测风险
  2. 补齐一些常用平台的图文能力,并逐步完成 CLI 化、Skill 化
  3. 陆续测试并上架到更多 skill 平台,让大家的龙虾、螃蟹、毛毛虫都能打通 AI 自媒体的最后一道关

所以如果你之前觉得这个项目更新有点慢,哈哈哈,后面大概率会快很多。也欢迎大家继续关注,最近应该会是一段持续修、持续更、持续重构的阶段。

🗂️重构计划

项目正在进行一轮整体重构,当前重构重点是:

“无头模式(headless)”,指的是浏览器在后台运行,不弹出可见窗口,但自动化流程仍然会照常执行。这样更适合 CLI、服务端、自动任务和 agent 场景。

Web 端相关代码仍然保留,但已经不是当前主线,不保证可直接运行,也不保证与当前 uploader/CLI 完全同步。

🏁快速开始

方式 1:使用 CLI

当前抖音、快手、小红书、Bilibili、视频号、百家号、支付宝生活号、微博和虎扑已经接入 CLI:

sau douyin login --account <account_name>
sau douyin check --account <account_name>
sau douyin upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
sau douyin upload-note --account <account_name> --images videos/1.png videos/2.png --title "图文标题" --note "图文正文"

sau kuaishou login --account <account_name>
sau kuaishou check --account <account_name>
sau kuaishou upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
sau kuaishou upload-note --account <account_name> --images videos/1.png videos/2.png videos/3.png --title "图文标题" --note "图文正文"

sau xiaohongshu login --account <account_name>
sau xiaohongshu check --account <account_name>
sau xiaohongshu upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
sau xiaohongshu upload-note --account <account_name> --images videos/1.png videos/2.png videos/3.png --title "图文标题" --note "图文正文"

sau bilibili login --account <account_name>
sau bilibili check --account <account_name>
sau bilibili upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tid 249

sau tencent login --account <account_name>
sau tencent check --account <account_name>
sau tencent upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2

sau baijiahao login --account <account_name>
sau baijiahao check --account <account_name>
sau baijiahao upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2

sau alipay login --account <account_name>
sau alipay check --account <account_name>
sau alipay upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2

sau weibo login --account <account_name>
sau weibo check --account <account_name>
sau weibo upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2

sau hupu login --account <account_name>
sau hupu check --account <account_name>
sau hupu upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2

sau youtube login --account <account_name>
sau youtube check --account <account_name>
sau youtube upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags tag1,tag2 --playlist "我的系列" --visibility public

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 不吃系统代理,需显式指定)。

补充说明:

方式 2:使用 examples

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

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

🐇项目背景

该项目最初是我个人用于自动化管理社交媒体视频发布的工具。我的主要发布策略是提前一天设置定时发布,因此项目中很多定时发布相关的逻辑是基于“第二天”的时间进行计算的。

如果您需要立即发布或其他定制化的发布策略,欢迎研究源码或在社区提问。

📃详细文档

已落后,目前在快速重构该项目,当下,你需要做的是把这个仓库,发给你的AI agent:qwen code,codex cc,openclaw等等,让他们帮你安装和使用

更详细的文档和说明,请查看:social-auto-upload 官方文档

🐾交流与支持

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

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

Creator

NasDaddy公众号
微信公众号

💻
关注公众号,后台回复 `上传` 获取加群方式
赞赏码/入群引导
交流群 (通过公众号获取)

📖
如果您觉得项目有用,可以考虑打赏支持一下

🤝贡献指南

欢迎各种形式的贡献,包括但不限于:

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

  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 发布。提交第三方代码时,请同时说明来源及其适用的许可证。

主要贡献者

🙏致谢

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

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

📜许可证

本项目采用 MIT License 开源许可证。除第三方组件外,本项目代码可以在遵守该许可证条款的前提下用于商业软件,包括闭源软件。

⭐Star-History

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

Star History Chart

social-auto-upload (dreammis/social-auto-upload)

wechat
Searching Database…

What is this?It's a Python automation tool that publishes your videos to major Chinese and international platforms — Douyin, Bilibili, Xiaohongshu, Kuaishou, WeChat Channels, Weibo, TikTok, YouTube and more — with support for scheduled posting.
So is it a web app, a CLI tool, or a library I'd code against?Primarily a CLI: the sau CLI is the current mainline, and the project also ships skills for AI agents. An older web interface still exists in the code, but it's no longer the mainline and isn't guaranteed to run.
What's involved in installing and running it?Install, update and environment prep are consolidated in the repo's docs, and the recommended path uses uv plus the sau CLI. If you use an agent client, you can hand it the repo together with the project's Agent Bootstrap Prompt and it handles setup for you.
Do I need to install anything besides Python itself?Almost nothing: requirements.txt is only kept for legacy paths, and the Bilibili uploader (biliup) is downloaded and auto-updated on first run. The TikTok flow runs through the Chrome browser.
What should I watch out for in its current state?It's mid-refactor: the detailed docs lag the code, the legacy web UI isn't guaranteed to work, and coverage is uneven — TikTok has no CLI yet, and image-text posts only work on Douyin, Xiaohongshu and Kuaishou. Scheduled-posting logic was also written around next-day timing.
Will it run on my machine, or is it tied to one OS?It's Python plus browser automation, so it runs wherever Python and a browser do — Windows, macOS and Linux. There's also a Dockerfile in the repo for containerized runs.
Which platforms are fully covered, and which are missing features like scheduling or image posts?All eleven platforms handle login and video upload, but the matrix is uneven: image-text posts only work on Douyin, Xiaohongshu and Kuaishou; scheduled publishing covers Douyin, Bilibili, Xiaohongshu, Kuaishou, WeChat Channels and TikTok; and TikTok is the only platform without a CLI path yet. Douyin is described as the most complete mainline implementation, while Bilibili uploads build on the biliup project.
Can it run headless on a server without popping up a browser window?Headless mode is the mainline focus of the ongoing refactor: the browser runs in the background while the automation flow continues, aimed at CLI, server-side, scheduled-task and agent scenarios. The project is also switching to the patchright driver to improve compatibility and make automation harder for platforms to detect.
Why does YouTube uploading go through a browser instead of YouTube's official API?Because API projects that haven't passed Google's compliance audit get their uploads force-locked to private with no way to make them public, which is impractical for personal channels. Driving YouTube Studio in a browser lifts that restriction, adds --playlist and --visibility options, and waits for the upload to reach 100% before publishing. In regions where YouTube is blocked, you set an explicit YTPROXY in conf.py.
Why not just have a browser agent upload each video manually?An agent has to re-parse the page, take screenshots and improvise on every single run, while this project encodes each upload flow into scripts that were validated once and then repeat deterministically. The author's point: high-frequency, repetitive, boring work belongs to scripts. Agents aren't excluded, though — the repo ships per-platform upload skills so Claude Code, Codex and OpenClaw can drive it.
Creator
dreammis
Size
23.8 MB
Stars
15.6K
Age
2y
Commits · 90 Days