- name
- wechat-publisher
- description
- Publish articles to WeChat Official Account (微信公众号) draft box via API. Use when the user wants to upload a Markdown article (with optional local images) to their WeChat 公众号 草稿箱. Handles token management, image uploading to WeChat CDN, Markdown-to-HTML conversion, and draft creation. Does NOT generate images — images must be provided as local files.
WeChat Publisher Skill
Publish Markdown articles to WeChat Official Account draft box.
Prerequisites
- Create
config.jsonin the skill root (copy fromconfig.example.json), or set env varsWX_APPID/WX_APPSECRET(recommended for secrets). - Python 3 available (
python3) - All scripts are in
scripts/relative to this SKILL.md
For full API details, read references/wechat_api.md.
Workflow
Step 1 — Gather inputs
Ask the user (or infer from context):
- Article: path to
.mdfile - Cover image (required): local image file for the article thumbnail (jpg/png, ≤1MB)
- Body images (optional): local image files referenced in the article
- Title: article title (use H1 from markdown if not specified)
- Author (optional)
- Digest/summary (optional, ≤120 chars)
Step 2 — Upload cover image → get thumb_media_id
THUMB_ID=$(python3 scripts/upload_thumb.py cover.jpg)Step 3 — Upload body images → build image map
For each body image referenced in the article:
WX_URL=$(python3 scripts/upload_img.py images/fig1.png)Build a JSON map of local filenames to WeChat CDN URLs:
{"fig1.png": "http://mmbiz.qpic.cn/...", "fig2.jpg": "http://..."}Save as /tmp/image_map.json.
Skip this step if the article has no inline images.
Step 4 — Convert Markdown to HTML
# Without images:
python3 scripts/md_to_html.py article.md > /tmp/article.html
# With image map:
python3 scripts/md_to_html.py article.md --image-map /tmp/image_map.json > /tmp/article.htmlStep 5 — Upload draft
python3 scripts/upload_draft.py \
--title "文章标题" \
--html /tmp/article.html \
--thumb-media-id "$THUMB_ID" \
--author "作者名" \
--digest "文章摘要"Output: media_id of the created draft.
The draft appears in the WeChat MP backend at: https://mp.weixin.qq.com → 草稿箱
Step 6 — Confirm
Tell the user:
- ✅ Draft uploaded successfully
- Draft media_id:
XXX - View in WeChat MP backend: https://mp.weixin.qq.com (草稿箱)
Error Handling
| Error | Fix |
|---|---|
errcode: 40001 | Token expired → delete .token_cache.json and retry |
errcode: 48001 | Account lacks API permission (check subscription vs service account) |
errcode: 40007 | Invalid thumb_media_id → re-upload cover image |
| Cover upload fails | Image must be jpg/png, ≤1MB |
Notes
- Access tokens are cached in
.token_cache.json(auto-refreshed when expired) - WeChat only accepts images hosted on WeChat CDN — always upload images first
- The draft is saved but NOT published; user must publish manually from MP backend or via
/cgi-bin/freepublish/submit - Subscription accounts (订阅号) may have limited publishing frequency (once per day/week)