dreammis/social-auto-upload

What it does

social-auto-upload is a Python tool for content creators and operators who publish the same material across many platforms. It provides a unified sau CLI plus per-platform Agent Skills for Codex, OpenClaw and Claude Code. Supported targets include Douyin, Kuaishou, Xiaohongshu, Bilibili, WeChat Channels, Baijiahao, Dayu, Alipay Life Account, Weibo, Hupu, TikTok, Xueqiu, YouTube, Zhihu, Facebook, Facebook Page and Instagram. Video, article and image-note publishing are separate commands; some platforms also support scheduled posting and content management such as listing or deleting posts.

The project is organized as CLI wrappers in sau_commands/ and publishing flows in uploader/. Bilibili support builds on the biliup project biliup.

Quick start

Installation and updates are documented separately: see the installation guide and update guide. Python 3.10–3.12 is the stated range.

Log in to a platform once, then verify the saved session. creator is an example local account alias, which you choose yourself:

sau douyin login --account creator
sau douyin check --account creator

Then publish a video. Replace <account_name> with the alias used above:

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

For a Bilibili video, the channel parameter is required:

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

Image notes use upload-note with one or more images:

sau xiaohongshu upload-note --account <account_name> --images videos/1.png videos/2.png --title "图文标题" --note "图文正文"

Articles use upload-article with a content file; Dayu and Zhihu are the documented examples CLI documentation. Markdown themes require Node.js 22+ and a one-time setup step:

sau article setup

Operational constraints

• Each platform requires an initial interactive login; sessions are stored per --account alias and can run concurrently.
• TikTok is Chrome-based and has no sau CLI entry. YouTube login is interactive through a Google account and uses browser automation rather than the official API. The README explains this is because unverified API projects would lock uploads as private.
• YouTube and some overseas platforms need an explicit proxy; for YouTube set YT_PROXY in conf.py, and for Facebook/Instagram use --proxy or environment variables such as SAU_FACEBOOK_PROXY.
• Bilibili automatically downloads and updates biliup on first use; no manual installation is needed.
• Douyin video publishing may trigger SMS verification; the program reads verify_code.txt from the project root or accepts terminal input.
• YouTube scheduled publishing is marked as in development, and Zhihu scheduling as experimental. These should not be treated as stable capabilities.
• Repository code is MIT-licensed; the 18 Agent Skills are declared MIT-0 in their respective SKILL.md files.

HotRepo's take

On the Python daily list for 2026-11-14, the project recorded 43 new stars and a best position of 12, with 16,539 stars and 2,805 forks overall. That single snapshot shows steady daily activity, but it is one data point and does not establish a trend. What the repository itself makes clear is a broad platform matrix and two access paths — CLI and Agent Skills — which fits creators running multiple accounts rather than one-off uploads.

The README includes a sponsor section with promotional links and discount codes, but the repository-backed material (CLI commands, per-platform docs, skills) is substantial and usable without those services, so the sponsorship does not define the project.