wechat-mp-draft-publisher

---

name: wechat-mp-draft-publisher description: Publish WeChat Official Account draft articles through a packaged CLI executable that wraps WeChat API calls. Use when the user wants to publish or create a draft from local article content and images, especially when the required flow is getAuth -> uploadArticleImage -> uploadCoverImage -> addDraft.

---

WeChat MP Draft Publisher

Publish draft articles by calling the bundled wrapper script, which enforces this fixed sequence: 1. getAuth 2. uploadArticleImage 3. uploadCoverImage 4. addDraft

Requirements

Provide executable via one of:

- Local binary path: - CLI flag --bin /absolute/path/to/mp-weixin-skill - Env var MP_WECHAT_CLI_BIN - GitHub Release auto-download: - Env var MP_WECHAT_RELEASE_URL=https://github.com///releases/download// (direct asset URL, supports zip or binary) - or: - Env var MP_WECHAT_GITHUB_REPO=owner/repo - Optional env MP_WECHAT_RELEASE_TAG=latest (default latest) - Optional env MP_WECHAT_ASSET_NAME=custom-asset-name

Ensure local credentials file exists for getAuth:

- ~/.weixin_credentials - format: - appid=YOUR_APP_ID - secret=YOUR_APP_SECRET

Prepare these files before running:

- Article content file (--content-file), usually HTML - Inline article image (--article-image) - Cover image (--cover-image)

Run

Use the wrapper script:

bash scripts/publish_draft.sh \
  --article-image /absolute/path/to/article-image.png \
  --cover-image /absolute/path/to/cover-image.png \
  --content-file /absolute/path/to/content.html \
  --title "Article Title" \
  --author "Author Name" \
  --digest "Optional digest"

GitHub Release mode (auto-download executable):

export MP_WECHAT_GITHUB_REPO="owner/repo"
export MP_WECHAT_RELEASE_TAG="latest"
bash scripts/publish_draft.sh \
  --cover-image /absolute/path/to/cover-image.png \
  --content-file /absolute/path/to/content.html \
  --title "Article Title"

Direct URL mode:

export MP_WECHAT_RELEASE_URL="https://github.com/Mesus/weixin-mp-skill/releases/download/v0.0.1/mp-weixin-skill.zip"
bash scripts/publish_draft.sh \
  --cover-image /absolute/path/to/cover-image.png \
  --content-file /absolute/path/to/content.html \
  --title "Article Title"

If uploadCoverImage response does not include usable media_id, pass it explicitly:

bash scripts/publish_draft.sh \
  --bin /absolute/path/to/mp-weixin-skill \
  --article-image /absolute/path/to/article-image.png \
  --cover-image /absolute/path/to/cover-image.png \
  --content-file /absolute/path/to/content.html \
  --title "Article Title" \
  --thumb-media-id "YOUR_MEDIA_ID"

Output Contract

Script prints one JSON object on stdout:

access_token: token returned by getAuth

article_image_url: URL returned by uploadArticleImage

cover_upload: raw JSON object returned by uploadCoverImage

thumb_media_id_used: value passed to addDraft

draft: raw JSON object returned by addDraft

On failure, script prints JSON error to stderr and exits non-zero.

Resource

CLI wrapper implementation details: references/cli-contract.md