最近在研究 AI Agent 自动发布内容，尝试了不少抖音 MCP 项目，但很多项目 Star 不高、维护频率一般，而且容易受到平台页面变化影响。

后来发现了一个相对成熟的项目——social-auto-upload（简称 SAU）。

它支持：

• 抖音
• 小红书
• B站
• 快手
• 腾讯视频号

并且提供统一的 CLI 命令行工具，可以直接被 Claude Code、OpenClaw、Cursor、Codex 等 AI 工具调用。

本文记录一次完整安装过程以及踩坑记录。

---

一、环境准备

系统环境：

Windows 11
Python 3.11+
uv
Git

首先克隆项目：

git clone https://github.com/dreammis/social-auto-upload.git

cd social-auto-upload

---

二、创建虚拟环境

创建并激活环境：

uv venv

.venv\Scripts\activate

激活成功后会看到：

(social-auto-upload)

前缀。

---

三、安装 SAU

执行：

uv pip install -e .

安装过程中出现：

Failed to hardlink files;
falling back to full copy

不用担心。

这是 uv 在不同磁盘间复制缓存时的提示，不影响正常使用。

安装成功后会看到：

Installed 17 packages

类似输出。

---

四、第一个坑：缺少 conf.py

安装完成后直接执行：

sau

结果报错：

ModuleNotFoundError:
No module named 'conf'

原因是项目默认没有生成配置文件。

解决办法：

copy conf.example.py conf.py

再次执行：

sau

此时输出：

usage: sau [-h]
{douyin,kuaishou,xiaohongshu,bilibili,tencent}

说明安装成功。

---

五、安装浏览器内核

SAU 使用 Patchright（Playwright 分支）控制浏览器。

安装 Chromium：

patchright install chromium

如果下载特别慢，可以配置代理：

set HTTP_PROXY=http://127.0.0.1:7897

set HTTPS_PROXY=http://127.0.0.1:7897

然后重新执行：

patchright install chromium

下载完成后会显示：

Chrome Headless Shell downloaded

说明浏览器安装成功。

---

六、查看支持的平台

执行：

sau douyin --help

输出：

login
check
upload-video
upload-note

说明抖音模块已经加载成功。

---

七、第二个坑：必须指定账号

第一次执行：

sau douyin login

直接报错：

the following arguments are required:

--account

这是因为新版 SAU 支持多账号管理。

正确写法：

sau douyin login --account mydouyin

其中：

mydouyin

只是账号标识符，可以自定义。

例如：

sau douyin login --account main

sau douyin login --account account1

都可以。

---

八、第三个坑：登录超时

首次登录时遇到：

Page.goto:
Timeout 30000ms exceeded

浏览器访问：

https://creator.douyin.com/

超时。

最终解决方法：

set HTTP_PROXY=http://127.0.0.1:7897

set HTTPS_PROXY=http://127.0.0.1:7897

然后重新登录：

sau douyin login --account mydouyin --headed --debug

参数说明：

--headed
显示浏览器

--debug
输出调试日志

---

九、抖音扫码登录

执行后会生成二维码：

二维码已经准备好

同时保存图片：

cookies/
douyin_mydouyin_login_qrcode_xxxxx.png

使用抖音 App 扫码即可。

登录成功后看到：

扫码成功
已经跳转到登录后页面

随后：

Douyin login flow completed

并生成：

cookies/
douyin_mydouyin.json

这个文件就是登录 Cookie。

---

十、验证登录状态

很多人容易写错命令。

错误写法：

sau check

sau check login

都会报：

invalid choice

正确写法：

sau douyin check --account mydouyin

如果返回：

valid

说明 Cookie 有效，登录成功。

---

十一、命令格式总结

SAU 的命令结构是：

sau
 └─ 平台
      └─ 动作
            └─ 参数

例如：

sau douyin login --account mydouyin

sau douyin check --account mydouyin

sau douyin upload-video --account mydouyin

顺序不能写错。

---

十二、最终结果

经过完整配置后：

SAU CLI      √
conf.py      √
Chromium     √
抖音登录      √
Cookie保存    √
状态检测      √

目前已经可以直接进行抖音自动上传。

对于 Claude Code、OpenClaw、Codex 用户来说，我更推荐直接调用 SAU CLI，而不是再套一层 MCP。

因为本质上：

AI Agent ↓

sau CLI ↓

浏览器自动化 ↓

抖音

这种方式维护成本更低，也更加稳定。

后续还可以结合：

• n8n
• Docker
• MySQL
• Claude Code

搭建完整的 AI 自动发布工作流。