md2wechat Agent API markAgent API 文档
md2wechat Agent API markAgent API 文档
首页

开始

Markdown 转微信公众号 API 文档QuickstartAuth

接口

API OverviewThemeConvert发布 API微信 IP 白名单多账号发布图片生成标题生成封面图Advanced LayoutMode SelectionAdvanced Layout Use CasesAdvanced Layout SyntaxAdvanced Layout MistakesDiscovery-First Workflowdoctor 与 inspect 准备状态Advanced Layout Recipes排版模块目录

接入

运维

ErrorsPricingContact
X (Twitter)
API

多账号发布

用命名凭证与显式选择安全地管理多个公众号。

多账号发布

适用场景

团队、客户号与矩阵号在同一台机器上向多个公众号发布。命名账号把凭证隔离,并让每次副作用的目标显式可见。

配置

wechat:
  default_account: main
  accounts:
    main:
      appid: wx1234567890abcdef
      secret: your_main_secret
    client-a:
      appid: wx0987654321fedcba
      secret: your_client_secret

账号名需匹配 ^[a-z0-9][a-z0-9_-]{0,63}$。

选择优先级

  1. --wechat-account <name> 参数
  2. WECHAT_ACCOUNT 环境变量
  3. wechat.default_account
  4. 直写的 wechat.appid / wechat.secret
  5. 仅存在一个命名账号时,该账号

多个命名账号且无默认值(也未显式选择)时报:

WECHAT_ACCOUNT_AMBIGUOUS

发现账号,不泄漏密钥

md2wechat config wechat-accounts --json

返回 accounts[{name, appid, current}]、current 与 default_account。该命令永不输出 secret,连打码都不会。

按命令选择目标

md2wechat convert article.md --draft --cover cover.jpg --wechat-account client-a

--wechat-account 挂在每个微信副作用命令上(草稿创建、图片上传、图片消息)。

API Key 边界

  • 命名账号与固定出口代理模式需要有效 MD2WECHAT_API_KEY,副作用前经 HEAD /api/auth/validate 校验。
  • 旧单账号路径(直写 wechat.appid/wechat.secret)无 API Key 仍可用。

相关页面

  • Auth
  • 微信 IP 白名单
  • 发布 API

微信 IP 白名单

为什么微信副作用需要 IP 白名单,以及固定出口怎么配。

图片生成

文章配图与封面的命令、供应商、预设与免 Key 的 plan 模式。

目录

多账号发布
适用场景
配置
选择优先级
发现账号,不泄漏密钥
按命令选择目标
API Key 边界
相关页面