Spreado 全平台内容发布工具

Spreado 是什么

Spreado 是一款开源的社交媒体自动化发布工具，专为内容创作者设计。它可以把同一个视频一键同步发布到抖音、小红书、快手、腾讯视频号等国内主流平台，帮助个人创作者和 MCN 机构摆脱「一个视频传四遍」的重复劳动。

项目使用 Python 编写，底层通过浏览器自动化完成登录与上传，对外提供命令行工具和 Python API 两种使用方式。

核心能力

• 多平台支持：一次上传，同步到抖音、小红书、快手、视频号。
• 智能认证：自动处理登录与 Cookie 管理，支持二维码扫码登录全流程。
• 灵活调度：支持定时发布与草稿保存。
• 丰富配置：标题、描述、标签、封面、地理位置等元数据均可设置。
• 双入口：既有简单易用的 CLI，也支持 Python API 集成。
• 插件化架构：新增平台无需改动核心代码，放入 plugins/ 目录即可自动发现。
• Agent Skill：为 Claude、Cursor、Codex 等 AI 助手提供 Skill，可协助安装、配置与发布。

快速上手

1. 安装

不想折腾 Python 环境，可以直接从 GitHub Releases 下载对应系统的可执行文件（Windows / macOS / Linux，含 ARM64）。

如果已有 Python 3.10+ 环境，也可以用 uv 或 pip 安装：

# 使用 uv（推荐）
uv tool install spreado

# 或使用 pip
pip install spreado

无需单独安装浏览器：Spreado 会自动检测系统中的 Chrome/Edge，检测不到时回退到 Playwright 内置 Chromium。

2. 登录各平台

首次使用需要逐个平台完成登录认证，过程中会打开浏览器窗口：

spreado login douyin
spreado login xiaohongshu
spreado login kuaishou
spreado login shipinhao

登录成功后 Cookie 会保存在本地 cookies/ 目录，后续上传无需重复登录。

3. 上传视频

# 上传到单个平台
spreado upload douyin --video video.mp4 --title "我的视频标题"

# 带描述、标签与封面
spreado upload xiaohongshu --video video.mp4 --cover cover.jpg \
    --title "标题" --content "详细描述" --tags "标签1,标签2"

# 并行上传到所有平台
spreado upload all --video video.mp4 --title "我的视频" --parallel

# 定时发布（2 小时后）
spreado upload douyin --video video.mp4 --title "定时发布" --schedule 2

4. 验证登录状态

spreado verify all --parallel

Python API 示例

除了命令行，也可以在自己的脚本中调用上传逻辑：

import asyncio
from pathlib import Path
from spreado.plugins.douyin.uploader import DouYinUploader

async def main():
    uploader = DouYinUploader(
        cookie_file_path=Path("cookies/douyin/default/account.json")
    )
    result = await uploader.upload_video_flow(
        file_path=Path("video.mp4"),
        title="我的视频",
        content="视频描述",
        tags=["标签1", "标签2"],
        thumbnail_path=Path("cover.png"),
    )
    print("上传成功" if result else "上传失败")

asyncio.run(main())

浏览器与 Cookie 配置

Spreado 按以下优先级选择浏览器：

1. 自动检测系统已安装的 Chrome / Edge（默认）
2. 通过环境变量手动指定
3. 回退到 Playwright Chromium

export SPREADO_BROWSER_CHANNEL=chrome
export SPREADO_BROWSER_PATH="/path/to/chrome"

Cookie 默认存放在 cookies/<平台>/default/account.json，通过 --cookies 参数可指定自定义路径，从而实现多账号管理。

适用人群与注意事项

• 适合：需要把视频批量分发到多个国内平台的个人创作者、运营团队与 MCN 机构。
• 注意：工具依赖浏览器自动化，平台页面改版可能导致上传流程失效；Cookie 会过期，需要定期重新扫码登录；批量自动化发布时请遵守各平台的风控与合规要求。
• 仓库标注许可证为 Apache-2.0，但 README 中写的是 MIT，商用前建议先确认。