wechat-mp-draft-publisher

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.

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/<owner>/<repo>/releases/download/<tag>/<asset> (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