Agent Skills › hanliang97/MatrixMedia › matrixmedia-mcp

matrixmedia-mcp

GitHub

指导AI使用矩媒桌面端连接器和MCP工具，在抖音、小红书等主流平台进行视频/文章发布、账号状态检查及数据查询。支持定时发布、草稿保存及多平台矩阵操作，包含严格的发布前确认与错误处理流程。

workbuddy/connector/matrixmedia/skills/matrixmedia-mcp/SKILL.md hanliang97/MatrixMedia

Trigger Scenarios

发布视频矩阵发布多平台发布发抖音发视频号发小红书定时发布发布记录登录状态粉丝数据

Install

npx skills add hanliang97/MatrixMedia --skill matrixmedia-mcp -g -y

More Options

Non-standard path

npx skills add https://github.com/hanliang97/MatrixMedia/tree/main/workbuddy/connector/matrixmedia/skills/matrixmedia-mcp -g -y

Use without installing

npx skills use hanliang97/MatrixMedia@matrixmedia-mcp

指定 Agent (Claude Code)

npx skills add hanliang97/MatrixMedia --skill matrixmedia-mcp -a claude-code -g -y

安装 repo 全部 skill

npx skills add hanliang97/MatrixMedia --all -g -y

预览 repo 内 skill

npx skills add hanliang97/MatrixMedia --list

SKILL.md

Frontmatter

{
    "name": "matrixmedia-mcp",
    "author": "MatrixMedia",
    "version": "1.1.0",
    "description": "指导 AI 使用矩媒 MatrixMedia 连接器的 MCP 工具发布视频\/文章、检查登录态、查询发布记录与账号数据。触发词：发布视频、矩阵发布、多平台发布、发抖音、发视频号、发小红书、定时发布、发布记录、登录状态、粉丝数据。",
    "display_name": "矩媒连接器使用指南",
    "description_en": "How to use the MatrixMedia connector MCP tools",
    "description_zh": "矩媒连接器的工具调用说明",
    "display_name_en": "MatrixMedia Connector Guide"
}

矩媒 MatrixMedia 连接器

连接器通过本机已安装的矩媒桌面端执行操作。任何工具返回“未找到 MatrixMedia”时，告诉用户先安装桌面端（https://github.com/hanliang97/MatrixMedia/releases ，国内 https://gitee.com/gzlingyi_0/pubtw/releases ），然后停止。

平台代码：dy=抖音 ks=快手 sph=视频号 xhs=小红书 blbl=哔哩哔哩 bjh=百家号 tt=头条 fqsp=番茄视频 juejin=掘金。

工具

工具	用途	必填参数
`list_accounts`	列出账号及登录态（只读）	无；可选 `platform`
`list_history`	本机发布记录（只读）	无；可选 `days` `platform` `status` `all`
`publish_video`	发布视频（对外公开）	`platform` `phone` `file` `title`
`publish_article`	发布掘金文章（对外公开）	`platform=juejin` `phone` `title`，`content` 或 `file`
`get_publish_status`	查询发布任务进度与结果（只读）	`jobId`；可选 `waitSeconds`（默认 20，最大 25）
`get_account_stats`	读本地账号数据快照	`phone` `platform`
`sync_account_stats`	采集最新账号数据	`phone` `platform`
`get_work_stats`	按完整标题查单个视频数据	`phone` `platform` `title`

数据类工具支持 dy sph blbl bjh tt ks xhs（番茄视频、掘金没有数据接口）。

发布流程

参数不全时询问用户；不知道账号时先调 list_accounts 让用户选择。phone 填账号列表里的 phone 字段。
调 list_accounts（带 platform）确认目标账号已登录。未登录时请用户打开矩媒桌面端登录该平台账号后再继续。
发布前必须确认：列出平台 / 账号 / 文件 / 标题 / 简介 / 标签 / 定时时间，用户明确同意后再调用 publish_video。用户已明确说“直接发”且参数完整时可省略。
调 publish_video（或 publish_article）。工具最多等 20 秒：
- 返回 status: running + jobId：上传仍在后台进行。告诉用户“正在上传”，然后用 get_publish_status 传入 jobId 轮询，直到状态不再是 running。上传通常需要数分钟，最长约 40 分钟。
- 不要因为任务还在运行就再次调用 publish_video。参数相同的重复调用会返回同一个任务（reused: true），不会重复上传。
- 20 秒内就完成或失败的，会直接返回最终结果或错误。
根据最终结果总结：
- status: success：成功。
- status: scheduled：已创建定时任务，提醒用户到点时保持矩媒运行。
- status: needs_attention：视频号挂链接失败、已存草稿，请用户去视频号后台检查，不要重发。
- status: failed 或报错含“登录”：请用户在桌面端重新登录后重试。
- 报错“参数错误”：修正后最多重试一次。
- get_publish_status 提示“未找到该任务”（连接器重启过）：调用 list_history 确认这条视频是否已发布，不要直接重新发布。