WeChat Article Publisher Skill

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:

| Pain Point | Description | |------------|-------------| | Format Loss | Copy from Markdown editor -> Paste to WeChat -> All formatting gone | | Manual Formatting | Re-apply each H2, bold, link manually — 15-20 min per article | | Image Upload Hassle | Upload images one by one through WeChat's media library | | Multiple Steps | Switch between markdown editor, image uploads, and WeChat admin panel |

Time Comparison

| Task | Manual | With This Skill | |------|--------|-----------------| | Format conversion | 15-20 min | 0 (automatic) | | Image upload | 5-10 min | 0 (automatic) | | Copy & paste content | 2-3 min | 0 (automatic) | | Total | 20-30 min | < 1 min |

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

| Requirement | Details | |-------------|---------| | Claude Code | claude.ai/code | | Python 3.9+ | Standard library only (no extra dependencies) | | WECHAT_API_KEY | Get from wx.limyai.com | | WeChat Account | Authorized on wx.limyai.com |

---

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)

| Syntax | Result | |--------|--------| | # H1 | Article title (extracted, not in body) | | ## H2 | Section headers | | ### H3 | Sub-section headers | | **bold** | Bold text | | *italic* | Italic text | | [text](url) | Hyperlinks | | > quote | Blockquotes | | - item | Unordered lists | | 1. item | Ordered lists | | code | Code blocks | | ![](img.jpg) | Images (auto-uploaded) |

HTML (.html)

| Element | Result | |---------|--------| | <title> or <h1> | Article title | | <h2>, <h3> | Section headers | | <strong>, <b> | Bold text | | <em>, <i> | Italic text | | <a href=""> | Hyperlinks | | <blockquote> | Blockquotes | | <ul>, <ol> | Lists | | <table> | Tables (preserved) | | <img src=""> | Images (auto-uploaded) | | Inline styles | Preserved |

---

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 2024. Here are 5 worth your attention.

## 1. Claude: Best Conversational AI

**Claude** by Anthropic excels at long-context understanding.

> Claude's context window reaches 200K tokens.

![claude-demo](./images/claude-demo.png)

Command

把 ~/Documents/article.md 发布到微信公众号

Result

✓ 文章已成功发布到公众号草稿箱！

标题: 5 AI Tools Worth Watching in 2024
状态: 已保存到草稿箱

请登录微信公众平台预览并发布。

---

Project Structure

wechat-article-publisher-skill/
├── .claude-plugin/
│   └── plugin.json              # Plugin config
├── skills/
│   └── wechat-article-publisher/
│       ├── SKILL.md             # Skill instructions
│       └── scripts/
│           ├── wechat_api.py    # WeChat API client
│           └── parse_markdown.py # Markdown parser
├── docs/
│   └── GUIDE.md                 # Detailed guide
├── .env.example                 # Environment template
├── README.md                    # This file (bilingual)
└── LICENSE

---

FAQ

Q: How do I get a WECHAT_API_KEY? A: Register at wx.limyai.com, authorize your WeChat Official Account, and get your API key from the dashboard.

Q: Can I publish to multiple accounts? A: Yes! If you have multiple authorized accounts, the skill will ask you to choose which one to publish to.

Q: What happens to my images? A: Images are automatically uploaded to WeChat's servers. Both local paths and URLs are supported.

Q: Will this auto-publish my article? A: No, never. Articles are always saved as drafts. You must manually publish from the WeChat admin panel.

Q: What's the difference between news and newspic? A: news is standard article format; newspic (小绿书) is image-focused with limited text, similar to Instagram posts.

Q: Does this work on Windows? A: Yes! Unlike browser-based tools, this API-based approach works on all platforms.

---

API Reference

List Accounts

python wechat_api.py list-accounts

Publish Markdown Article

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

Publish HTML Article

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

Publish as 小绿书

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

---

Documentation

• Detailed Usage Guide — Complete documentation with examples

---

Changelog

v1.1.0 (2025-01)

• Add HTML file support with formatting preserved
• Auto-detect file format (Markdown or HTML)
• Extract title from HTML <title> or <h1> tags
• Support inline styles and rich HTML formatting

v1.0.0 (2025-01)

• Initial release for WeChat Official Account
• API-based publishing (no browser automation)
• Cross-platform support (macOS, Linux, Windows)
• Markdown to WeChat format conversion
• Auto image upload
• 小绿书 (newspic) support
• Draft-only publishing (safe by design)

---

License

MIT License - see LICENSE

Author

iamzifei

---

Contributing

• Issues: Report bugs or request features
• PRs: Welcome!

---

---

一键将 Markdown 或 HTML 文章发布到微信公众号草稿箱，告别繁琐的复制粘贴排版流程。

v1.1.0 — 基于 API 的发布方式，稳定高效，支持 Markdown 和 HTML

---

痛点分析

如果你习惯用 Markdown 写作，将内容发布到微信公众号是一个极其痛苦的过程：

| 痛点 | 描述 | |------|------| | 格式丢失 | 从 Markdown 编辑器复制 -> 粘贴到公众号后台 -> 格式全部丢失 | | 手动排版 | 逐个设置 H2、粗体、链接 — 每篇文章 15-20 分钟 | | 图片上传繁琐 | 需要通过素材库逐张上传图片 | | 步骤繁多 | 在 Markdown 编辑器、图片上传、公众号后台之间反复切换 |

时间对比

| 操作 | 手动方式 | 使用本 Skill | |------|----------|--------------| | 格式转换 | 15-20 分钟 | 0（自动） | | 图片上传 | 5-10 分钟 | 0（自动） | | 复制粘贴内容 | 2-3 分钟 | 0（自动） | | 总计 | 20-30 分钟 | < 1 分钟 |

效率提升 30 倍以上

---

解决方案

本 Skill 使用微信 API 直接发布，稳定可靠：

Markdown/HTML 文件
     | Python 解析
     v
结构化数据（标题、内容、图片）
     | WeChat API
     v
保存到公众号草稿箱（绝不自动发布）

核心特性

• 基于 API：直接调用 API，无需浏览器自动化
• 跨平台：支持 macOS、Linux、Windows
• 双格式支持：同时支持 Markdown (.md) 和 HTML (.html) 文件
• 格式保留：HTML 格式完整保留，Markdown 自动转换
• 图片自动上传：文章中的图片自动上传到微信服务器
• 安全设计：仅保存草稿，绝不自动发布
• 小绿书支持：支持发布为图文消息格式

---

环境要求

| 要求 | 说明 | |------|------| | Claude Code | claude.ai/code | | Python 3.9+ | 仅使用标准库，无需额外依赖 | | WECHAT_API_KEY | 从 wx.limyai.com 获取 | | 微信公众号 | 在 wx.limyai.com 完成授权 |

---

安装方式

步骤一：克隆仓库

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

步骤二：复制 Skill 到 Claude

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

步骤三：配置 API Key

cd wechat-article-publisher-skill
cp .env.example .env
# 编辑 .env 文件，设置你的 WECHAT_API_KEY

---

使用方法

自然语言

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

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

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