dreammis/social-auto-upload

What it solves

Content creators and operators often need to publish the same or similar content across multiple social platforms. Doing this manually is time-consuming and error-prone. This project provides a single command-line interface to upload videos, articles, and image-text posts to a wide range of Chinese and international platforms, including Douyin, Bilibili, Xiaohongshu, Kuaishou, WeChat Channels, Baijiahao, Dayu, Alipay Life, Weibo, Hupu, TikTok, Xueqiu, YouTube, Zhihu, Facebook, Instagram, and more. It also exposes each platform as an Agent Skill, letting AI coding agents like Codex, OpenClaw, and Claude Code perform the uploads on your behalf.

How it works

You first log in to each platform once (using a local session name, e.g., creator). Then you call the CLI with a platform-specific command, for example sau douyin upload-video or sau xiaohongshu upload-note. The tool handles the underlying browser automation or API calls, including cookie sessions, scheduled publishing (where supported), and platform-specific constraints. For AI agents, the repository provides a set of Skill directories (one per platform or a cross-platform entry) that agents can install and follow to perform uploads. The project also includes documentation, example scripts, and a bootstrap prompt to guide agents through installation and verification.

Who it's for

This is aimed at content creators, social media operators, and developers who manage multiple accounts or need to distribute content widely. It also suits those who want to automate publishing with AI agents. The project requires some comfort with command-line usage, but the docs provide step-by-step installation and usage guides.

Highlights

• Unified CLI (sau) covering many platforms with consistent parameter patterns.
• 18 Agent Skills (MIT-0 licensed) that integrate with Codex, OpenClaw, Claude Code, etc.
• Supports video, article (HTML/Markdown/TXT), and image-text (note) publishing.
• Scheduled publishing for some platforms (e.g., Douyin, Bilibili, Xiaohongshu, Facebook Page, etc.).
• Handles platform-specific quirks such as Bilibili's biliup auto-download, YouTube browser automation, and Facebook proxy settings.
• Markdown-to-HTML theme rendering for articles (requires Node.js 22+ for first use).
• Extensible: contributors can add new platforms by following the checklist in the contributing guide.