social-auto-upload
Command-line and agent-skill tool that uploads videos and posts to many Chinese and global social platforms.
- Stars
- 16k
- Forks
- 2.7k
- Licence
- MIT
- Language
- Python
- Last update
- 15 days ago
- Type
- CLI
What it is
social-auto-upload is a Python tool that publishes videos, articles, and image posts to social media platforms such as Douyin, Xiaohongshu, Bilibili, YouTube, and TikTok. It offers a unified `sau` command line and packaged skills that AI agents such as Codex, OpenClaw, or Claude Code can use. People use it to avoid repeating the same upload steps on each platform.
- Upload a video to Douyin, Kuaishou, or Xiaohongshu with one command per platform
- Schedule video posts on platforms that support scheduled publishing
- Publish long-form articles with images to Dayu or Xueqiu
- Let an AI agent install the project and run uploads through provided skills
Great for
- Content creators posting the same video to several platforms
- Operators managing multiple accounts on Chinese platforms like Douyin and Xiaohongshu
- Developers who want scripted or agent-driven publishing
- Users who already work with Python and the command line
Not ideal for
- People who want a point-and-click app with no terminal use, since the README centers on CLI commands and install docs
- Users needing platforms not listed in the README's support table
- Anyone expecting guaranteed stability on platforms marked as in development or experimental, such as YouTube scheduling and Zhihu scheduling
How to get it
- 1
Clone and build from source
You'll need: Python 3.10-3.12
Clone the repository
git clone https://github.com/dreammis/social-auto-uploadInstall a single agent skill (optional)
npx skills add dreammis/social-auto-upload --skill douyin-upload - 2
Run it
- Follow the installation guide in docs/install.md
- Log in to a platform with: sau douyin login --account creator
- Check the session with: sau douyin check --account creator
- Upload a video with: sau douyin upload-video --account <account_name> --file videos/demo.mp4 --title "示例标题" --desc "示例简介"
- 3
Get the most out of it
- Check the platform capability table before choosing a platform, since support varies
- Use the CLI reference in docs/CLI.md for platform-specific parameters such as Bilibili --tid or YouTube --playlist
- Use per-platform skills or the cross-platform skill with an AI agent
- Use the article themes (default, grace, simple, modern, plain) for article posts
Downloads
Strengths
- Single CLI covers many platforms with a consistent upload-video pattern
- Per-platform skills can be installed into compatible agents
- MIT license and an active repository
Trade-offs
- Relies on logging into each platform and maintaining local sessions, which can break when platforms change
- README mixes stable features with in-development and experimental ones, so support must be checked per platform
- The README contains sponsor messages that are unrelated to the tool's function
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| social-auto-upload (this) | 16k | CLI | intermediate | 15 days ago | Content creators posting the same video to several platforms |
| AiToEarn | 27.2k | App | intermediate | 4 days ago | Creators who post the same content to many platforms |
| lux | 31.8k | CLI | beginner | 7 months ago | People who want to save videos from supported sites to a local file from the command line |
| VidBee | 11k | App | beginner | 5 days ago | People who save videos or podcasts from supported sites and want them organized in one library |
| DouyinLiveRecorder | 11.1k | App | beginner | 7 months ago | People who want to archive streams from specific streamers on the listed platforms |
| Agent-Reach | 108k | CLI | beginner | 5 days ago | Developers building or using AI agents that need web content beyond basic search |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.