WeChat Article Publisher

Publish Markdown or HTML content to WeChat Official Account drafts via API, with automatic format conversion.

Prerequisites WECHAT_API_KEY environment variable set (from .env file) Python 3.9+ Authorized WeChat Official Account on wx.limyai.com Scripts

Located in ~/.claude/skills/wechat-article-publisher/scripts/:

wechat_api.py

WeChat API client for listing accounts and publishing articles:

List authorized accounts

python wechat_api.py list-accounts

Publish from markdown file

python wechat_api.py publish --appid --markdown /path/to/article.md

Publish from HTML file (preserves formatting)

python wechat_api.py publish --appid --html /path/to/article.html

Publish with custom options

python wechat_api.py publish --appid --markdown /path/to/article.md --type newspic

parse_markdown.py

Parse Markdown and extract structured data (optional, for advanced use):

python parse_markdown.py [--output json|html]

Workflow

Strategy: "API-First Publishing"

Unlike browser-based publishing, this skill uses direct API calls for reliable, fast publishing.

Load WECHAT_API_KEY from environment List available WeChat accounts (if user hasn't specified) Detect file format (Markdown or HTML) and parse accordingly Call publish API to create draft in WeChat Report success with draft details

Supported File Formats:

.md files → Parsed as Markdown, converted by WeChat API .html files → Sent as HTML, formatting preserved Step-by-Step Guide Step 1: Check API Key

Before any operation, verify the API key is available:

Check if .env file exists and contains WECHAT_API_KEY

cat .env | grep WECHAT_API_KEY

If not set, remind user to:

Copy .env.example to .env Set their WECHAT_API_KEY value Step 2: List Available Accounts

Get the list of authorized WeChat accounts:

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py list-accounts

Output example:

{ "success": true, "data": { "accounts": [ { "name": "我的公众号", "wechatAppid": "wx1234567890", "username": "gh_abc123", "type": "subscription", "verified": true, "status": "active" } ], "total": 1 } }

Important:

If only one account, use it automatically If multiple accounts, ask user to choose Note the wechatAppid for publishing Step 3: Publish Article

For Markdown files:

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \ --appid \ --markdown /path/to/article.md

For HTML files (preserves formatting):

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \ --appid \ --html /path/to/article.html

For 小绿书 (image-text mode):

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \ --appid \ --markdown /path/to/article.md \ --type newspic

Success response:

{ "success": true, "data": { "publicationId": "uuid-here", "materialId": "uuid-here", "mediaId": "wechat-media-id", "status": "published", "message": "文章已成功发布到公众号草稿箱" } }

Step 4: Report Result

After successful publishing:

Confirm the draft was created Remind user to review and publish manually in WeChat admin panel Provide any relevant IDs for reference API Reference Authentication

All API requests require the X-API-Key header:

X-API-Key: WECHAT_API_KEY

Get Accounts List POST https://wx.limyai.com/api/openapi/wechat-accounts

Publish Article POST https://wx.limyai.com/api/openapi/wechat-publish

Parameters:

Parameter Type Required Description wechatAppid string Yes WeChat AppID title string Yes Article title (max 64 chars) content string Yes Article content (Markdown/HTML) summary string No Article summary (max 120 chars) coverImage string No Cover image URL author string No Author name contentFormat string No 'markdown' (default) or 'html' articleType string No 'news' (default) or 'newspic' Error Codes Code Description API_KEY_MISSING API key not provided API_KEY_INVALID API key invalid ACCOUNT_NOT_FOUND Account not found or unauthorized ACCOUNT_TOKEN_EXPIRED Account authorization expired INVALID_PARAMETER Invalid parameter WECHAT_API_ERROR WeChat API call failed INTERNAL_ERROR Server error Critical Rules NEVER auto-publish - Only save to drafts, user publishes manually Check API key first - Fail fast if not configured List accounts first - User may have multiple accounts Handle errors gracefully - Show clear error messages Preserve original content - Don't modify user's markdown unnecessarily Supported Formats Markdown Files (.md) H1 header (# ) → Article title H2/H3 headers (##, ###) → Section headers Bold (text) Italic (text) Links text Blockquotes (> ) Code blocks (...) Lists (- or 1.) Images → Auto-uploaded to WeChat HTML Files (.html)