The WeChat Publishing API for AI Agents
Two separate services: the Convert API renders HTML, the Publishing API carries drafts. What each one needs and where the CLI fits.
The WeChat Publishing API for AI Agents
The single most important fact: the Convert API never creates WeChat drafts. Rendering and publishing are two separate services.
| Convert API | Publishing API | |
|---|---|---|
| URL | https://www.md2wechat.cn/api/convert | https://md2wechat.com/api/v1 |
| Auth | One API key (three equivalent headers) | WeChat AppID/AppSecret via the CLI |
| Side effects | None | Draft creation |
| Whitelist | Never needed | When the platform requires it |
When you only need rendering
Stop at the Convert API. One key, one request, data.html back — no WeChat credentials at all. See Convert.
When you need the draft box
The Publishing API is driven by the md2wechat CLI:
md2wechat inspect article.md --json
md2wechat convert article.md --preview
md2wechat convert article.md --draft --cover cover.jpgPrerequisites: WeChat AppID and AppSecret, draft/material API permissions, an IP whitelist entry when required (Whitelist), and explicit confirmation before the side effect. Concept page: Publishing API.
Why the split matters for agents
Rendering is safe to retry and cheap to verify; publishing is a side effect that must be explicit. Keeping them on separate services keeps the safe path obvious — the same boundary the md2wechat.cn docs draw at https://www.md2wechat.cn/wechat-publishing-api.
More Posts
How to Use md2wechat-skill in Obsidian with Claudian
A practical Claudian guide for md2wechat-skill, including install order, PATH fixes, discovery commands, and the first successful Obsidian workflow.
How to Choose From 48 WeChat Themes
The 48-theme catalog in five groups, what per-theme metadata means, and the API/AI mode rule that fails closed.
CLI, Skill, or Raw API: How to Choose the Right md2wechat Entry Point
CLI, skill, and raw API are not three separate products. They are three different entry points. This article explains which one fits which stage.
Newsletter
Join the community
Subscribe to our newsletter for the latest news and updates