
2026/09/05
面向 AI Agent 的公众号发布 API 总览
两个独立服务面:Convert API 负责渲染,Publishing API 承载草稿。各自需要什么、CLI 在哪里介入。
面向 AI Agent 的公众号发布 API 总览
最重要的一件事:Convert API 永远不会创建公众号草稿。 渲染与发布是两个独立服务。
| Convert API | Publishing API | |
|---|---|---|
| URL | https://www.md2wechat.cn/api/convert | https://md2wechat.com/api/v1 |
| 认证 | 一把 API Key(三种等价请求头) | 经 CLI 的微信 AppID/AppSecret |
| 副作用 | 无 | 草稿创建 |
| 白名单 | 永不需要 | 平台要求时需要 |
只需要渲染时
到 Convert API 为止。一把 Key、一次请求、返回 data.html——完全不需要微信凭证。见 Convert。
需要落到草稿箱时
Publishing API 由 md2wechat CLI 驱动:
md2wechat inspect article.md --json
md2wechat convert article.md --preview
md2wechat convert article.md --draft --cover cover.jpg前置条件:微信 AppID 与 AppSecret、草稿/素材接口权限、平台要求时的 IP 白名单(白名单)、副作用前的显式确认。概念页:发布 API。
为什么这个拆分对 Agent 重要
渲染可以安全重试、验证成本低;发布是必须显式授权的副作用。两个服务面分开,安全路径就一目了然——md2wechat.cn 在 https://www.md2wechat.cn/wechat-publishing-api 划的是同一条边界。
更多文章
邮件列表
加入我们的社区
订阅邮件列表,及时获取最新消息和更新