微矩阵

CLI 与 MCP 使用指南

把微矩阵 WeMatrix 接入 Codex、Claude、Cursor、CI 脚本和自定义 AI Agent

CLI 定位

微矩阵 WeMatrix CLI 是面向 AI Agent 的微信公众号矩阵管理命令行工具。 它连接微矩阵服务，让 Codex、Claude、Cursor、自动化脚本或内部运营工具可以安全读取公众号矩阵上下文、创建微信公众号草稿、读取账号样式、查询流量主收益，并生成远程 HTTP MCP 配置。

CLI 的设计目标是让 Agent 可以准备内容和创建草稿，但不绕过人工审核直接发布。正式发布仍建议由运营者在微矩阵或微信公众平台确认。
微矩阵
WeMatrix
微信公众号矩阵管理
公众号矩阵管理平台
微信公众号草稿 API
微信公众号 MCP
面向 Agent 的公众号管理平台
公众号流量主收益统计

安装与环境变量

推荐通过 npm 安装公开 CLI 包。Agent 使用时优先把 Token 放在环境变量或 Secret 管理器里，不要写进命令历史和仓库文件。

npm install -g wematrix-cli
wematrix --version

# 也可以临时运行
npm exec --package=wematrix-cli -- wematrix --version
export WEMATRIX_BASE_URL="https://mp.lingxiaoyao.cn"
export WEMATRIX_TOKEN="mp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

wematrix context
wematrix accounts

NPM 包：wematrix-cli。源码仓库：Createitv/wematrix-cli。

Agent 工作流

给 AI Agent 的推荐顺序是先读上下文，再读账号和样式，最后创建草稿。这样 Agent 能明确当前 Token 的能力边界，也能避免把内容写到错误账号。

# 1. 读取微矩阵 WeMatrix 平台上下文和 Token 权限
wematrix context

# 2. 选择目标公众号
wematrix accounts

# 3. 读取目标公众号默认样式
wematrix styles --appid wx123

# 4. 生成 Markdown 后创建微信草稿
wematrix draft create post.md --title "每日简报" --appid wx123
如果你的 Agent 支持工具调用，先让它执行 wematrix context，再根据返回的 scopes、accounts 和 policy 决定下一步。

命令参考

命令Scope用途
wematrix contextagent:context读取平台能力、Token 权限、账号矩阵和发布策略，让 Agent 先理解边界。
wematrix accountsaccounts:read读取已授权微信公众号列表，选择后续草稿创建的 appid。
wematrix styles --appid wx123styles:read读取目标公众号默认样式，帮助 Agent 保持账号排版一致。
wematrix draft create post.md --title "每日简报" --appid wx123drafts:create把 Markdown 内容创建为微信草稿，不直接群发。
wematrix publisher summary --appids wx123,wx456publisher:read读取多公众号流量主累计收益。
wematrix publisher settlement --start 2026-05-01 --end 2026-05-19 --group-by appidpublisher:read读取指定区间结算汇总。
wematrix mcp config --base-url https://mp.lingxiaoyao.cn无需业务 scope输出远程 HTTP MCP 配置片段。

从 stdin 创建草稿

cat post.md | wematrix draft create --stdin --title "每日简报" --appid wx123

流量主收益查询

wematrix publisher summary --appids wx123,wx456

wematrix publisher settlement \
  --start 2026-05-01 \
  --end 2026-05-19 \
  --group-by appid

MCP 配置

如果你的 AI 客户端支持远程 HTTP MCP，可以让 CLI 直接生成配置片段。配置中使用环境变量占位，不要把真实 Token 写入共享文件。

wematrix mcp config --base-url https://mp.lingxiaoyao.cn
{
  "mcpServers": {
    "wematrix": {
      "type": "http",
      "url": "https://mp.lingxiaoyao.cn/api/mcp",
      "headers": {
        "Authorization": "Bearer ${WEMATRIX_TOKEN}"
      }
    }
  }
}

API 详情可以查看 API 使用指南 或OpenAPI JSON。

安全边界

CLI 成功结果输出 JSON 到 stdout，错误输出 JSON 到 stderr，方便 Agent 稳定解析。

Token 在 CLI 输出和错误信息中会自动脱敏。本地保存 Token 时，需要设置 WEMATRIX_CONFIG_PASSPHRASE，配置文件使用 AES-256-GCM 加密。

每个 API Token 应只分配必要 scope，例如只创建草稿就只授予 drafts:create 和必要读取权限。

export WEMATRIX_CONFIG_PASSPHRASE="local-secret-from-your-secret-manager"

wematrix login \
  --base-url https://mp.lingxiaoyao.cn \
  --token "$WEMATRIX_TOKEN"

wematrix logout

排查建议

TOKEN_MISSING

检查是否设置了 WEMATRIX_TOKEN，或者命令中是否传入 --token。

FORBIDDEN

Token 缺少当前命令需要的 scope。到控制台重新创建或调整 API Token 权限。

CONFIG_PASSPHRASE_MISSING

本地配置已加密，读取前需要设置同一个 WEMATRIX_CONFIG_PASSPHRASE。

上一篇API 使用指南
下一篇常见问题