Back to search
wechat-article-publisher-skill
SkillGitHub
Claude Skill that publish on Wechat articles (微信公众号发布)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/iamzifei--wechat-article-publisher-skill)HTML
<a href="/listings/iamzifei--wechat-article-publisher-skill"><img src="/api/listings/iamzifei--wechat-article-publisher-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 761 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # WeChat Article Publisher Skill
- [](https://ko-fi.com/H2T024VDBG)
- <p align="center">
- <strong>English</strong> | <a href="#中文文档">中文</a>
- </p>
- > 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](https://claude.ai/code) |
- | Python 3.9+ | Standard library only (no extra dependencies) |
- | WECHAT_API_KEY | Get from [wx.limyai.com](https://wx.limyai.com) |
- | WeChat Account | Authorized on wx.limyai.com |
- ---
- ## 怎么装(没用过命令行也能跟着做)
- > 下面每一步都可以**直接复制粘贴**。不用懂什么是「技能」「仓库」「终端」,照做就行。
- > 哪一步卡住了,**把报错原样复制给 AI,让它帮你看**——这是最快的解决办法。
- ### 方式一:WorkBuddy(推荐,不用敲命令)
- 1. **下载安装 WorkBuddy**,打开它,登录。
- 2. 在电脑上**新建一个文件夹**,名字随便,比如 `我的AI技能`,放桌面上就行。记住它在哪。
- 3. **把本项目下载下来**:
- - 在本页面点绿色的 **Code** 按钮 → **Download ZIP**
- - 下载完**解压**,把解压出来的整个文件夹拖进刚才建的 `我的AI技能` 里
- 4. 打开 WorkBuddy 的**设置 → 技能(Skills)**,点「添加技能目录」,选中 `我的AI技能` 这个文件夹。
- 5. **重启 WorkBuddy**。
- 6. 在对话框里输入 **`/公众号发布 新手`**,回车。
- 看到它开始介绍它能做什么并给你编号选项,就是装好了。
- > 找不到「技能」入口?在设置里搜 `skill`,或者直接问 WorkBuddy:「我要怎么添加本地技能目录?」
- > WorkBuddy 的菜单名称可能随版本变化,但「添加技能目录」这一步的意思是一样的。
- ### 方式二:Claude Code(会用终端的人)
- ```bash
- git clone https://github.com/iamzifei/wechat-article-publisher-skill.git
- ```
- 把 clone 下来的文件夹放进 Claude Code 的技能目录(`~/.claude/skills/`),重启,输入 `/公众号发布 新手`。
- ### 方式三:其他支持技能的 AI 工具(Codex、豆包、Trae 等)
- 这些工具大多会读一个固定的技能目录,常见的是 `~/.agents/skills`、`~/.codex/skills`。
- 把本项目文件夹复制进去,重启工具,输入 `/公众号发布 新手`。
- ### 不知道装没装上?
- 在对话框里输入 `/公众号发布 新手`。**它会自己介绍自己、并带你走一遍**——
- 不用你想好要问什么,也不用准备任何材料。
- ## Installation
- ### Step 1: Clone the Repository
- ```bash
- git clone https://github.com/iamzifei/wechat-article-publisher-skill.git
- ```
- ### Step 2: Copy Skill to Claude
- ```bash
- cp -r wechat-article-publisher-skill/skills/wechat-article-publisher ~/.claude/skills/
- ```
- ### Step 3: Configure API Key
- ```bash
- 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 |
- | `` | 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`
- ```markdown
- # 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.
- 
- ```
- ### 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](https://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
- ```bash
- python wechat_api.py list-accounts
- ```
- ### Publish Markdown Article
- ```bash
- python wechat_api.py publish --appid <appid> --markdown /path/to/article.md
- ```
- ### Publish HTML Article
- ```bash
- python wechat_api.py publish --appid <appid> --html /path/to/article.html
- ```
- ### Publish as 小绿书
- ```bash
- python wechat_api.py publish --appid <appid> --markdown /path/to/article.md --type newspic
- ```
- ---
- ## Documentation
- - [Detailed Usage Guide](docs/GUIDE.md) — 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](LICENSE)
- ## Author
- [iamzifei](https://github.com/iamzifei)
- ---
- ## Contributing
- - **Issues**: Report bugs or request features
- - **PRs**: Welcome!
- ---
- <br><br>
- ---
- <h1 id="中文文档">微信公众号文章发布 Skill</h1>
- <p align="center">
- <a href="#wechat-article-publisher-skill">English</a> | <strong>中文</strong>
- </p>
- > 一键将 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](https://claude.ai/code) |
- | Python 3.9+ | 仅使用标准库,无需额外依赖 |
- | WECHAT_API_KEY | 从 [wx.limyai.com](https://wx.limyai.com) 获取 |
- | 微信公众号 | 在 wx.limyai.com 完成授权 |
- ---
- ## 安装方式
- ### 步骤一:克隆仓库
- ```bash
- git clone https://github.com/iamzifei/wechat-article-publisher-skill.git
- ```
- ### 步骤二:复制 Skill 到 Claude
- ```bash
- cp -r wechat-article-publisher-skill/skills/wechat-article-publisher ~/.claude/skills/
- ```
- ### 步骤三:配置 API Key
- ```bash
- cd wechat-article-publisher-skill
- cp .env.example .env
- # 编辑 .env 文件,设置你的 WECHAT_API_KEY
- ```
- ---
- ## 使用方法
- ### 自然语言
- ```
- 把 /path/to/article.md 发布到微信公众号
- ```
- ```
- 帮我把这篇文章发到公众号:~/articles/ai-tools.md
- ```
- ```
- 把这个HTML文章发布到公众号:~/newsletter/issue-01.html
- ```
- ```
- Publish ~/Documents/my-post.md to WeChat
- ```
- ```
- 发布这个带排版的HTML文件到微信:~/export/formatted-post.html
- ```
- ### Skill 命令
- ```
- /wechat-article-publisher /path/to/article.md
- ```
- ```
- /wechat-article-publisher /path/to/article.html
- ```
- ### 带选项使用
- ```
- # 发布为小绿书(图文消息)
- /wechat-article-publisher /path/to/article.md --type newspic
- ```
- ---
- ## 工作流程
- ```
- [1/4] 检查 API Key...
- -> 从 .env 加载 WECHAT_API_KEY
- [2/4] 获取公众号列表...
- -> 查找已授权的公众号
- -> 如果只有一个则自动选择,多个则询问用户
- [3/4] 发布文章...
- -> 检测文件格式(Markdown 或 HTML)
- -> 解析内容(标题、正文、图片)
- -> 调用微信 API
- -> 自动上传图片
- [4/4] 报告结果...
- -> 显示成功信息
- -> 提醒用户手动预览并发布
- ```
- ---
- ## 支持的格式
- ### Markdown (.md)
- | 语法 | 效果 |
- |------|------|
- | `# H1` | 文章标题(提取后不含在正文中) |
- | `## H2` | 二级标题 |
- | `### H3` | 三级标题 |
- | `**粗体**` | **粗体文字** |
- | `*斜体*` | *斜体文字* |
- | `[文字](url)` | 超链接 |
- | `> 引用` | 引用块 |
- | `- 列表` | 无序列表 |
- | `1. 列表` | 有序列表 |
- | ``` 代码 ``` | 代码块 |
- | `` | 图片(自动上传) |
- ### HTML (.html)
- | 元素 | 效果 |
- |------|------|
- | `<title>` 或 `<h1>` | 文章标题 |
- | `<h2>`, `<h3>` | 章节标题 |
- | `<strong>`, `<b>` | **粗体文字** |
- | `<em>`, `<i>` | *斜体文字* |
- | `<a href="">` | 超链接 |
- | `<blockquote>` | 引用块 |
- | `<ul>`, `<ol>` | 列表 |
- | `<table>` | 表格(保留) |
- | `<img src="">` | 图片(自动上传) |
- | 内联样式 | 保留 |
- ---
- ## 文章类型
- ### news(默认)
- 标准的公众号文章格式,支持完整的富文本。
- ### newspic(小绿书)
- 以图片为主的内容格式:
- - 最多支持 20 张图片
- - 文字内容限制 1000 字
- - 适合图片为主的内容发布
- ---
- ## 完整示例
- ### 输入:`article.md`
- ```markdown
- # 2024 年最值得关注的 5 个 AI 工具
- 
- 人工智能工具在 2024 年迎来了爆发式增长。本文将介绍 5 个最值得关注的工具。
- ## 1. Claude:最强对话 AI
- **Claude** 由 Anthropic 开发,在长文本理解方面表现出色。
- > Claude 的上下文窗口高达 200K tokens。
- 
- ```
- ### 执行命令
- ```
- 把 ~/Documents/article.md 发布到微信公众号
- ```
- ### 执行结果
- ```
- ✓ 文章已成功发布到公众号草稿箱!
- 标题: 2024 年最值得关注的 5 个 AI 工具
- 状态: 已保存到草稿箱
- 请登录微信公众平台预览并发布。
- ```
- ---
- ## 项目结构
- ```
- wechat-article-publisher-skill/
- ├── .claude-plugin/
- │ └── plugin.json # 插件配置
- ├── skills/
- │ └── wechat-article-publisher/
- │ ├── SKILL.md # Skill 核心指令
- │ └── scripts/
- │ ├── wechat_api.py # 微信 API 客户端
- │ └── parse_markdown.py # Markdown 解析器
- ├── docs/
- │ └── GUIDE.md # 详细使用指南
- ├── .env.example # 环境变量模板
- ├── README.md # 本文件(双语)
- └── LICENSE
- ```
- ---
- ## 常见问题
- **Q: 如何获取 WECHAT_API_KEY?**
- A: 访问 [wx.limyai.com](https://wx.limyai.com),注册并授权你的微信公众号,在控制台获取 API Key。
- **Q: 可以发布到多个公众号吗?**
- A: 可以!如果你授权了多个公众号,Skill 会询问你要发布到哪个。
- **Q: 图片会怎么处理?**
- A: 图片会自动上传到微信服务器。支持本地路径和网络 URL。
- **Q: 会自动发布文章吗?**
- A: 不会。文章始终保存为草稿,你需要在公众号后台手动发布。
- **Q: news 和 newspic 有什么区别?**
- A: `news` 是标准文章格式;`newspic`(小绿书)是图文消息格式,以图片为主,文字有限制。
- **Q: 支持 Windows 吗?**
- A: 支持!与浏览器自动化工具不同,本 Skill 基于 API,支持所有平台。
- ---
- ## API 参考
- ### 获取公众号列表
- ```bash
- python wechat_api.py list-accounts
- ```
- ### 发布 Markdown 文章
- ```bash
- python wechat_api.py publish --appid <appid> --markdown /path/to/article.md
- ```
- ### 发布 HTML 文章
- ```bash
- python wechat_api.py publish --appid <appid> --html /path/to/article.html
- ```
- ### 发布为小绿书
- ```bash
- python wechat_api.py publish --appid <appid> --markdown /path/to/article.md --type newspic
- ```
- ---
- ## 详细文档
- - [完整使用指南](docs/GUIDE.md) — 包含详细说明和更多示例
- ---
- ## 更新日志
- ### v1.1.0 (2025-01)
- - 新增 HTML 文件支持,保留原有格式
- - 自动检测文件格式(Markdown 或 HTML)
- - 从 HTML `<title>` 或 `<h1>` 标签提取标题
- - 支持内联样式和丰富的 HTML 格式
- ### v1.0.0 (2025-01)
- - 首次发布,支持微信公众号
- - 基于 API 发布(无需浏览器自动化)
- - 跨平台支持(macOS、Linux、Windows)
- - Markdown 自动转换为公众号格式
- - 图片自动上传
- - 小绿书(newspic)支持
- - 仅保存草稿(安全设计)
- ---
- ## 许可证
- MIT License - 见 [LICENSE](LICENSE)
- ## 作者
- [iamzifei](https://github.com/iamzifei)
- ---
- ## 贡献
- - **Issues**:报告 Bug 或提出功能建议
- - **PR**:欢迎贡献代码
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.