MatrixMedia：多平台视频矩阵发布工具

项目简介

矩媒 MatrixMedia 是一款面向自媒体矩阵运营的视频批量发布工具，采用 Electron 图形界面与命令行（CLI）两种形态。它在本机登录各平台账号后，把同一批视频分发到多个平台、多个账号，适合需要批量运营内容矩阵的自媒体团队和个人。

目前可一键发布视频的平台有 8 个：抖音、快手、百家号、哔哩哔哩、头条号、视频号、小红书、番茄视频。

主要功能

• GUI + CLI 双形态：在图形界面操作，也能在参数中加入子串 cli 进入无 GUI 流程，方便脚本与智能体编排。
• CLI 子命令：cli login、publish、publish-article、accounts、history、stats、stats-sync、stats-work、comments、comments-reply，每个都支持 --help。
• CLI 登录：支持抖音与视频号的终端二维码登录（抖音还支持 puppeteer 无头）；其他平台先在 GUI 登录一次，CLI 复用同一 persist:<phone><平台> session partition。
• 远程素材：file 支持本地路径或 http(s) 远程 URL，自动下载并在上传后清理临时文件。
• 评论互动：cli comments 拉取抖音、快手、视频号已发布作品的评论；cli comments-reply 默认 dry-run 校验，加 --execute 才真正发送，并写入记录。
• 数据统计：读取账号粉丝快照（粉丝、播放、点赞、评论、收藏），按完整标题查询某个视频的发布数据。
• HTTP API：GUI 启动后可通过 POST http://127.0.0.1:30088/publish 由其他程序触发发布。
• MCP Server：仓库内置 mcp/ 子包，Claude Desktop、Cursor、Cline 等支持 MCP 的工具无需 shell 调用即可使用 9 个 tool。
• 真实浏览器发布：小红书可切换为本机 Chrome / Chromium 发布，规避内置窗口的自动化检测，检测不到时自动回退。
• 统一退出码：0 成功 / 1 异常 / 2 参数错误 / 3 业务失败，cli accounts --json 与 cli history --json 输出稳定 JSON。

安装与使用

软件下载地址：

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

使用文档：官网 与 Gitee Wiki，另有 教程视频。

GUI 打开后默认进入「项目详情」页，可查看 HTTP / MCP / CLI 接入说明。CLI 登录示例：

matrixmedia cli login -p dy --phone 13800138000

构建 MCP Server：

cd mcp && npm install && npm run build

然后将配置写入 Claude Desktop 的 claude_desktop_config.json 或 Cursor / Cline 的 .cursor/mcp.json，把 MATRIXMEDIA_DIR 设为仓库根目录的绝对路径，重启 AI 工具即可调用 list_accounts、publish_video、list_comments、reply_comment 等 tool。

接入 AI 工具：CLI 被刻意设计为与 AI 工具、框架无关的外部命令，只要能调用 shell、读取退出码或 JSON stdout，就能直接对接 OpenClaw、Hermes、Claude Code、Codex、WorkBuddy、Cursor、Cline、Aider、Dify、n8n、LangChain、CrewAI 等。另有现成的 DSH 插件位于 dsh-plugin/，可在 DSH Web UI 的插件页填仓库地址接入。

注意事项

• MCP 运行在无头 stdio 环境，无法弹出扫码窗口，所有平台都需要先在 GUI 完成登录再通过 MCP 发布。
• CLI 登录目前只覆盖抖音与视频号；其他平台在 GUI 登录即可，登录态过期时 cli accounts 会报「cookie 已过期」，回 GUI 重登一次即可。
• 小红书对 Electron 内置窗口的自动化检测日趋严格，可能出现「AI 托管」警告，建议在账号管理的「发布设置」中开启「使用真实浏览器」，首次开启会自动检测 Chrome 路径，也可手动选择，并用「测试连接」确认。
• 定时任务按身份键查重并在触发轮内去重，避免同一作品重复发布。
• 项目采用 GPL-2.0 许可证。

本作品整理自 GitHub 开源项目 hanliang97/MatrixMedia，原作者 @hanliang97，许可证 GPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。