wechat-mp-draft-publisher（微信 mp 草稿发布者）

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/<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