WeChat Article Publisher Skill

English | 中文

Publish Markdown or HTML articles to WeChat Official Account drafts with one command. Say goodbye to tedious copy-paste-format workflows.

v1.1.0 — API-based publishing for reliability and speed

---

The Problem

If you write in Markdown, publishing to WeChat Official Account (公众号) is a painful process:

Time Comparison

30x efficiency improvement

---

The Solution

This skill uses WeChat's API for direct, reliable publishing:

Markdown/HTML File
     | Python parsing
     v
Structured Data (title, content, images)
     | WeChat API
     v
Draft in WeChat Official Account (never auto-publishes)

Key Features

• API-Based: Direct API calls, no browser automation needed
• Cross-Platform: Works on macOS, Linux, and Windows
• Dual Format: Supports both Markdown (.md) and HTML (.html) files
• Format Preserved: HTML formatting preserved, Markdown auto-converted
• Image Auto-Upload: Images in your content are automatically uploaded
• Safe by Design: Only saves as draft, never publishes automatically
• 小绿书 Support: Publish as image-text format (newspic) for visual content

---

Requirements

---

Installation

Step 1: Clone the Repository

git clone https://github.com/iamzifei/wechat-article-publisher-skill.git

Step 2: Copy Skill to Claude

cp -r wechat-article-publisher-skill/skills/wechat-article-publisher ~/.claude/skills/

Step 3: Configure API Key

cd wechat-article-publisher-skill
cp .env.example .env
# Edit .env and set your WECHAT_API_KEY

---

Usage

Natural Language

把 /path/to/article.md 发布到微信公众号

Publish ~/Documents/my-post.md to WeChat

帮我把这篇文章发到公众号：~/articles/ai-tools.md

把这个HTML文章发布到公众号：~/newsletter/issue-01.html

Publish the HTML article ~/export/formatted-post.html to WeChat

Skill Command

/wechat-article-publisher /path/to/article.md

/wechat-article-publisher /path/to/article.html

With Options

# Publish as 小绿书 (image-text mode)
/wechat-article-publisher /path/to/article.md --type newspic

---

Workflow Steps

[1/4] Check API Key...
      -> Load WECHAT_API_KEY from .env

[2/4] List WeChat Accounts...
      -> Find authorized accounts
      -> Auto-select if only one, ask if multiple

[3/4] Publish Article...
      -> Detect file format (Markdown or HTML)
      -> Parse content (title, body, images)
      -> Call WeChat API
      -> Upload images automatically

[4/4] Report Result...
      -> Show success message
      -> Remind to review and publish manually

---

Supported Formats

Markdown (.md)

HTML (.html)

---

Article Types

news (Default)

Standard WeChat article format with full rich text support.

newspic (小绿书)

Image-focused format for visual content:

• Up to 20 images extracted from content
• Text limited to 1000 characters
• Perfect for photo-heavy posts

---

Example

Input: article.md

# 5 AI Tools Worth Watching in 2024

![cover](./images/cover.jpg)

AI tools exploded in 20

...