by iamzifei
Claude Skill that publish on Wechat articles (微信公众号发布)
# Add to your Claude Code skills
git clone https://github.com/iamzifei/wechat-article-publisher-skillPublish 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
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 |
| 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
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)
No comments yet. Be the first to share your thoughts!
| 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 |
git clone https://github.com/iamzifei/wechat-article-publisher-skill.git
cp -r wechat-article-publisher-skill/skills/wechat-article-publisher ~/.claude/skills/
cd wechat-article-publisher-skill
cp .env.example .env
# Edit .env and set your WECHAT_API_KEY
把 /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
/wechat-article-publisher /path/to/article.md
/wechat-article-publisher /path/to/article.html
# Publish as 小绿书 (image-text mode)
/wechat-article-publisher /path/to/article.md --type newspic
[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
| 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 |
|  | Images (auto-uploaded) |
| 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 |
Standard WeChat article format with full rich text support.
Image-focused format for visual content:
article.md# 5 AI Tools Worth Watching in 2024

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.

把 ~/Documents/article.md 发布到微信公众号
✓ 文章已成功发布到公众号草稿箱!
标题: 5 AI Tools Worth Watching in 2024
状态: 已保存到草稿箱
请登录微信公众平台预览并发布。
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
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.
python wechat_api.py list-accounts
python wechat_api.py publish --appid <appid> --markdown /path/to/article.md
python wechat_api.py publish --appid <appid> --html /path/to/article.html
python wechat_api.py publish --appid <appid> --markdown /path/to/article.md --type newspic
<title> or <h1> tagsMIT License - see LICENSE
一键将 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
保存到公众号草稿箱(绝不自动发布)
| 要求 | 说明 | |------|------| | 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
cp -r wechat-article-publisher-skill/skills/wechat-article-publisher ~/.claude/skills/
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