矩媒 MatrixMedia

做短视频矩阵的人都有一个共同的痛点：一条视频做完，要分别登录抖音、B站、小红书、视频号、头条、快手、百家号，每个平台重新填标题、传封面、选标签、点发布。七遍下来，半小时没了。

矩媒（MatrixMedia） 就是来终结这种重复劳动的。

它是一款开源的多平台视频矩阵发布与批量分发工具（GitHub 项目 hanliang97/MatrixMedia，105+ Stars，GPL-2.0 协议），基于 Electron + Vue + Puppeteer 构建，本地运行，一次配置就能把视频批量分发到国内 8 大主流平台。

一、MatrixMedia 能做什么？

一句话概括：把“手动发布 7 遍”变成“自动发布 1 次” 。

MatrixMedia 用 Puppeteer（无头浏览器）模拟人工操作各平台的发布页面。你只需准备好视频文件（支持本地路径或 http URL）、标题、描述、标签，它就能自动完成登录、上传、填表、点击发布的全流程。

关键设计理念是：MatrixMedia 把自己定位为“AI 工具无关、框架无关”的外部命令。它不关心谁来调用——可以是你手动点 GUI，可以是 shell 脚本，可以是 Claude Code，也可以是 n8n 工作流。

二、支持哪些平台？

目前 8 个平台已完整自动化：

注意：目前仅抖音和视频号支持 CLI 直接扫码登录，其他平台需先在 GUI 中登录一次，CLI 会自动复用登录态。不支持 YouTube、TikTok 国际版等海外平台。

三、三种接入方式：GUI / CLI / HTTP API / MCP

MatrixMedia 提供四种触发方式，覆盖从手动操作到 AI 自动化全场景：

1. GUI 图形界面

Electron 桌面应用，支持 Windows 和 macOS。可视化选择平台、填写信息、点击发布，适合不想碰命令行的用户，也用来做首次登录。

2. CLI 命令行

自动化场景的主力。统一入口是 matrixmedia cli：

# 登录（抖音/视频号扫码）
matrixmedia cli login

# 发布视频到指定平台
matrixmedia cli publish -p dy -f video.mp4 -t "标题"

# 查询登录态
matrixmedia cli accounts

# 查看发布历史
matrixmedia cli history

CLI 采用机器可读契约：退出码 0=成功 / 1=异常 / 2=参数错误 / 3=业务失败，支持 --json 输出稳定 JSON 结构供上游解析。

3. HTTP API

GUI 启动后暴露本地 HTTP 接口（POST http://127.0.0.1:30088/publish），供其他程序或工作流在 GUI 运行时触发布局，避免冷启动开销。

curl -X POST http://127.0.0.1:30088/publish \
  -H "Content-Type: application/json" \
  -d '{"platform":"dy","file":"video.mp4","title":"标题"}'

4. MCP Server（Model Context Protocol）

这是 MatrixMedia 与同类工具最大的差异化亮点。通过 MCP 协议，Claude Desktop、Cursor、Cline 等 AI 工具可以直接调用 MatrixMedia 发视频。

MCP 可用 Tools：

• list_accounts：按平台过滤已登录账号
• list_history：按平台/状态/天数筛选发布记录
• publish_video：发布视频（≤35分钟，支持定时）
• publish_article：发布掘金文章

配置方式：cd mcp && npm install && npm run build，然后在 Claude Desktop 的 MCP 配置中添加 stdio transport 指向 mcp/dist/index.js。

关键限制：MCP 运行于无头 stdio 环境，无法弹出扫码窗口；所有平台需先在 GUI 完成登录。

四、使用教程（从零到发布）

第一步：下载与安装

下载地址：

• GitHub Releases：https://github.com/hanliang97/MatrixMedia/releases
• 国内 Gitee：https://gitee.com/gzlingyi_0/pubtw/releases/

下载对应操作系统的安装包（Windows .exe 或 macOS .dmg），安装后启动。

第二步：登录各平台账号

打开 GUI 桌面应用，在「账号管理」中依次登录各平台账号：

• 抖音 / 视频号：支持 CLI 扫码登录，也可在 GUI 中扫码
• 快手 / 百家号 / B站 / 头条 / 小红书：在 GUI 中登录一次即可

小红书特别提示：由于小红书对 Electron 内置窗口的自动化检测日趋严格，建议在「账号管理 → 小红书账号 → 发布设置」中开启「使用真实浏览器」模式，通过 puppeteer-core 驱动本机 Chrome 规避风控。

第三步：准备视频内容

将视频文件放在本地目录，或使用 http(s) 远程 URL（工具会自动下载，上传后清理临时文件）。

第四步：发布视频

方式一：GUI 发布

• 在 GUI 中选择目标平台
• 填写标题、描述、标签
• 选择视频文件
• 点击「发布」

方式二：CLI 批量发布

# 发布到单个平台
matrixmedia cli publish -p dy -f /path/to/video.mp4 -t "视频标题"

# 发布到多个平台
matrixmedia cli publish -p dy,kuaishou,bilibili -f video.mp4 -t "标题"

# 远程 URL 发布
matrixmedia cli publish -p dy -f https://example.com/video.mp4 -t "标题"

方式三：HTTP API 触发

curl -X POST http://127.0.0.1:30088/publish \
  -H "Content-Type: application/json" \
  -d '{"platforms":["dy","kuaishou"],"file":"video.mp4","title":"标题"}'

方式四：MCP + Claude 自动发布
在 Claude Desktop 中配置好 MCP 后，直接对 Claude 说：“帮我发布这段视频到抖音和B站”，Claude 就会调用 MatrixMedia 的 MCP Tool 完成发布。

五、实用建议与注意事项

✅ 适合谁用？

• 自媒体矩阵运营者：一个人管理多个平台账号，每天发布大量内容
• AI 自动化工作流开发者：将视频发布接入 Cursor/Claude Code/n8n/Dify 等工具链
• MCN 机构：批量管理账号矩阵，统一内容分发

⚠️ 注意事项

1. 登录态管理：CLI 与 GUI 共用 session partition，GUI 登录后 CLI 自动复用，无需重复认证。但 MCP 环境无法扫码，所有平台需先在 GUI 完成登录。
2. 反爬策略适配：MatrixMedia 通过模拟浏览器操作实现自动化，受限于各平台前端架构变动和反爬策略升级。项目后续工作主要集中在 Bug 修复与反爬虫策略适配。
3. 小红书专用模式：务必开启「使用真实浏览器」模式，否则可能触发「AI 托管」警告甚至封号风险。
4. 版本更新追踪：最新版本 v0.10.4 已支持视频号带货商品选择、橱窗商品自动拉取、AI 生成声明自动点选；v0.10.x 新增 B 站封面 Puppeteer 自动化与二开指南。建议关注 GitHub Releases 及时更新。
5. 开源协议：本项目以 GPL-2.0 协议开源，欢迎 Star、提 Issue 与 PR。

六、总结

MatrixMedia 的价值不在于它本身有多复杂的技术——本质上它就是用 Puppeteer 模拟浏览器操作——而在于它把“多平台重复发布”这个高频痛点，封装成了标准化的服务。

更关键的是，它通过 CLI + HTTP API + MCP 三层接口，让自己成为了 AI 自动化工作流中“最后一公里”的桥梁。当你的 Cursor 或 Claude Code 能自动生成视频文案、自动剪辑视频，却卡在“没人手动点发布”时，MatrixMedia 就是那个补全闭环的关键拼图。

对于自媒体矩阵运营者来说，它是每天节省半小时的效率工具；对于 AI 开发者来说，它是让 AI Agent 真正“落地”到内容分发的底层基础设施。