{
  "markdown": "# WeChat Article Publisher Skill\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/H2T024VDBG)\n\n<p align=\"center\">\n  <strong>English</strong> | <a href=\"#中文文档\">中文</a>\n</p>\n\n> Publish Markdown or HTML articles to WeChat Official Account drafts with one command. Say goodbye to tedious copy-paste-format workflows.\n\n**v1.1.0** — API-based publishing for reliability and speed\n\n---\n\n## The Problem\n\nIf you write in Markdown, publishing to WeChat Official Account (公众号) is a **painful process**:\n\n| Pain Point | Description |\n|------------|-------------|\n| **Format Loss** | Copy from Markdown editor -> Paste to WeChat -> All formatting gone |\n| **Manual Formatting** | Re-apply each H2, bold, link manually — 15-20 min per article |\n| **Image Upload Hassle** | Upload images one by one through WeChat's media library |\n| **Multiple Steps** | Switch between markdown editor, image uploads, and WeChat admin panel |\n\n### Time Comparison\n\n| Task | Manual | With This Skill |\n|------|--------|-----------------|\n| Format conversion | 15-20 min | 0 (automatic) |\n| Image upload | 5-10 min | 0 (automatic) |\n| Copy & paste content | 2-3 min | 0 (automatic) |\n| **Total** | **20-30 min** | **< 1 min** |\n\n**30x efficiency improvement**\n\n---\n\n## The Solution\n\nThis skill uses WeChat's API for direct, reliable publishing:\n\n```\nMarkdown/HTML File\n     | Python parsing\n     v\nStructured Data (title, content, images)\n     | WeChat API\n     v\nDraft in WeChat Official Account (never auto-publishes)\n```\n\n### Key Features\n\n- **API-Based**: Direct API calls, no browser automation needed\n- **Cross-Platform**: Works on macOS, Linux, and Windows\n- **Dual Format**: Supports both Markdown (.md) and HTML (.html) files\n- **Format Preserved**: HTML formatting preserved, Markdown auto-converted\n- **Image Auto-Upload**: Images in your content are automatically uploaded\n- **Safe by Design**: Only saves as draft, never publishes automatically\n- **小绿书 Support**: Publish as image-text format (newspic) for visual content\n\n---\n\n## Requirements\n\n| Requirement | Details |\n|-------------|---------|\n| Claude Code | [claude.ai/code](https://claude.ai/code) |\n| Python 3.9+ | Standard library only (no extra dependencies) |\n| WECHAT_API_KEY | Get from [wx.limyai.com](https://wx.limyai.com) |\n| WeChat Account | Authorized on wx.limyai.com |\n\n---\n\n## 怎么装（没用过命令行也能跟着做）\n\n> 下面每一步都可以**直接复制粘贴**。不用懂什么是「技能」「仓库」「终端」，照做就行。\n> 哪一步卡住了，**把报错原样复制给 AI，让它帮你看**——这是最快的解决办法。\n\n### 方式一：WorkBuddy（推荐，不用敲命令）\n\n1. **下载安装 WorkBuddy**，打开它，登录。\n2. 在电脑上**新建一个文件夹**，名字随便，比如 `我的AI技能`，放桌面上就行。记住它在哪。\n3. **把本项目下载下来**：\n   - 在本页面点绿色的 **Code** 按钮 → **Download ZIP**\n   - 下载完**解压**，把解压出来的整个文件夹拖进刚才建的 `我的AI技能` 里\n4. 打开 WorkBuddy 的**设置 → 技能（Skills）**，点「添加技能目录」，选中 `我的AI技能` 这个文件夹。\n5. **重启 WorkBuddy**。\n6. 在对话框里输入 **`/公众号发布 新手`**，回车。\n\n看到它开始介绍它能做什么并给你编号选项，就是装好了。\n\n> 找不到「技能」入口？在设置里搜 `skill`，或者直接问 WorkBuddy：「我要怎么添加本地技能目录？」\n> WorkBuddy 的菜单名称可能随版本变化，但「添加技能目录」这一步的意思是一样的。\n\n### 方式二：Claude Code（会用终端的人）\n\n```bash\ngit clone https://github.com/iamzifei/wechat-article-publisher-skill.git\n```\n\n把 clone 下来的文件夹放进 Claude Code 的技能目录（`~/.claude/skills/`），重启，输入 `/公众号发布 新手`。\n\n### 方式三：其他支持技能的 AI 工具（Codex、豆包、Trae 等）\n\n这些工具大多会读一个固定的技能目录，常见的是 `~/.agents/skills`、`~/.codex/skills`。\n把本项目文件夹复制进去，重启工具，输入 `/公众号发布 新手`。\n\n### 不知道装没装上？\n\n在对话框里输入 `/公众号发布 新手`。**它会自己介绍自己、并带你走一遍**——\n不用你想好要问什么，也不用准备任何材料。\n\n\n## Installation\n\n### Step 1: Clone the Repository\n\n```bash\ngit clone https://github.com/iamzifei/wechat-article-publisher-skill.git\n```\n\n### Step 2: Copy Skill to Claude\n\n```bash\ncp -r wechat-article-publisher-skill/skills/wechat-article-publisher ~/.claude/skills/\n```\n\n### Step 3: Configure API Key\n\n```bash\ncd wechat-article-publisher-skill\ncp .env.example .env\n# Edit .env and set your WECHAT_API_KEY\n```\n\n---\n\n## Usage\n\n### Natural Language\n\n```\n把 /path/to/article.md 发布到微信公众号\n```\n\n```\nPublish ~/Documents/my-post.md to WeChat\n```\n\n```\n帮我把这篇文章发到公众号：~/articles/ai-tools.md\n```\n\n```\n把这个HTML文章发布到公众号：~/newsletter/issue-01.html\n```\n\n```\nPublish the HTML article ~/export/formatted-post.html to WeChat\n```\n\n### Skill Command\n\n```\n/wechat-article-publisher /path/to/article.md\n```\n\n```\n/wechat-article-publisher /path/to/article.html\n```\n\n### With Options\n\n```\n# Publish as 小绿书 (image-text mode)\n/wechat-article-publisher /path/to/article.md --type newspic\n```\n\n---\n\n## Workflow Steps\n\n```\n[1/4] Check API Key...\n      -> Load WECHAT_API_KEY from .env\n\n[2/4] List WeChat Accounts...\n      -> Find authorized accounts\n      -> Auto-select if only one, ask if multiple\n\n[3/4] Publish Article...\n      -> Detect file format (Markdown or HTML)\n      -> Parse content (title, body, images)\n      -> Call WeChat API\n      -> Upload images automatically\n\n[4/4] Report Result...\n      -> Show success message\n      -> Remind to review and publish manually\n```\n\n---\n\n## Supported Formats\n\n### Markdown (.md)\n\n| Syntax | Result |\n|--------|--------|\n| `# H1` | Article title (extracted, not in body) |\n| `## H2` | Section headers |\n| `### H3` | Sub-section headers |\n| `**bold**` | **Bold text** |\n| `*italic*` | *Italic text* |\n| `[text](url)` | Hyperlinks |\n| `> quote` | Blockquotes |\n| `- item` | Unordered lists |\n| `1. item` | Ordered lists |\n| ``` code ``` | Code blocks |\n| `![](img.jpg)` | Images (auto-uploaded) |\n\n### HTML (.html)\n\n| Element | Result |\n|---------|--------|\n| `<title>` or `<h1>` | Article title |\n| `<h2>`, `<h3>` | Section headers |\n| `<strong>`, `<b>` | **Bold text** |\n| `<em>`, `<i>` | *Italic text* |\n| `<a href=\"\">` | Hyperlinks |\n| `<blockquote>` | Blockquotes |\n| `<ul>`, `<ol>` | Lists |\n| `<table>` | Tables (preserved) |\n| `<img src=\"\">` | Images (auto-uploaded) |\n| Inline styles | Preserved |\n\n---\n\n## Article Types\n\n### news (Default)\nStandard WeChat article format with full rich text support.\n\n### newspic (小绿书)\nImage-focused format for visual content:\n- Up to 20 images extracted from content\n- Text limited to 1000 characters\n- Perfect for photo-heavy posts\n\n---\n\n## Example\n\n### Input: `article.md`\n\n```markdown\n# 5 AI Tools Worth Watching in 2024\n\n![cover](./images/cover.jpg)\n\nAI tools exploded in 2024. Here are 5 worth your attention.\n\n## 1. Claude: Best Conversational AI\n\n**Claude** by Anthropic excels at long-context understanding.\n\n> Claude's context window reaches 200K tokens.\n\n![claude-demo](./images/claude-demo.png)\n```\n\n### Command\n\n```\n把 ~/Documents/article.md 发布到微信公众号\n```\n\n### Result\n\n```\n✓ 文章已成功发布到公众号草稿箱！\n\n标题: 5 AI Tools Worth Watching in 2024\n状态: 已保存到草稿箱\n\n请登录微信公众平台预览并发布。\n```\n\n---\n\n## Project Structure\n\n```\nwechat-article-publisher-skill/\n├── .claude-plugin/\n│   └── plugin.json              # Plugin config\n├── skills/\n│   └── wechat-article-publisher/\n│       ├── SKILL.md             # Skill instructions\n│       └── scripts/\n│           ├── wechat_api.py    # WeChat API client\n│           └── parse_markdown.py # Markdown parser\n├── docs/\n│   └── GUIDE.md                 # Detailed guide\n├── .env.example                 # Environment template\n├── README.md                    # This file (bilingual)\n└── LICENSE\n```\n\n---\n\n## FAQ\n\n**Q: How do I get a WECHAT_API_KEY?**\nA: Register at [wx.limyai.com](https://wx.limyai.com), authorize your WeChat Official Account, and get your API key from the dashboard.\n\n**Q: Can I publish to multiple accounts?**\nA: Yes! If you have multiple authorized accounts, the skill will ask you to choose which one to publish to.\n\n**Q: What happens to my images?**\nA: Images are automatically uploaded to WeChat's servers. Both local paths and URLs are supported.\n\n**Q: Will this auto-publish my article?**\nA: No, never. Articles are always saved as drafts. You must manually publish from the WeChat admin panel.\n\n**Q: What's the difference between news and newspic?**\nA: `news` is standard article format; `newspic` (小绿书) is image-focused with limited text, similar to Instagram posts.\n\n**Q: Does this work on Windows?**\nA: Yes! Unlike browser-based tools, this API-based approach works on all platforms.\n\n---\n\n## API Reference\n\n### List Accounts\n```bash\npython wechat_api.py list-accounts\n```\n\n### Publish Markdown Article\n```bash\npython wechat_api.py publish --appid <appid> --markdown /path/to/article.md\n```\n\n### Publish HTML Article\n```bash\npython wechat_api.py publish --appid <appid> --html /path/to/article.html\n```\n\n### Publish as 小绿书\n```bash\npython wechat_api.py publish --appid <appid> --markdown /path/to/article.md --type newspic\n```\n\n---\n\n## Documentation\n\n- [Detailed Usage Guide](docs/GUIDE.md) — Complete documentation with examples\n\n---\n\n## Changelog\n\n### v1.1.0 (2025-01)\n- Add HTML file support with formatting preserved\n- Auto-detect file format (Markdown or HTML)\n- Extract title from HTML `<title>` or `<h1>` tags\n- Support inline styles and rich HTML formatting\n\n### v1.0.0 (2025-01)\n- Initial release for WeChat Official Account\n- API-based publishing (no browser automation)\n- Cross-platform support (macOS, Linux, Windows)\n- Markdown to WeChat format conversion\n- Auto image upload\n- 小绿书 (newspic) support\n- Draft-only publishing (safe by design)\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE)\n\n## Author\n\n[iamzifei](https://github.com/iamzifei)\n\n---\n\n## Contributing\n\n- **Issues**: Report bugs or request features\n- **PRs**: Welcome!\n\n---\n\n<br><br>\n\n---\n\n<h1 id=\"中文文档\">微信公众号文章发布 Skill</h1>\n\n<p align=\"center\">\n  <a href=\"#wechat-article-publisher-skill\">English</a> | <strong>中文</strong>\n</p>\n\n> 一键将 Markdown 或 HTML 文章发布到微信公众号草稿箱，告别繁琐的复制粘贴排版流程。\n\n**v1.1.0** — 基于 API 的发布方式，稳定高效，支持 Markdown 和 HTML\n\n---\n\n## 痛点分析\n\n如果你习惯用 Markdown 写作，将内容发布到微信公众号是一个**极其痛苦**的过程：\n\n| 痛点 | 描述 |\n|------|------|\n| **格式丢失** | 从 Markdown 编辑器复制 -> 粘贴到公众号后台 -> 格式全部丢失 |\n| **手动排版** | 逐个设置 H2、粗体、链接 — 每篇文章 15-20 分钟 |\n| **图片上传繁琐** | 需要通过素材库逐张上传图片 |\n| **步骤繁多** | 在 Markdown 编辑器、图片上传、公众号后台之间反复切换 |\n\n### 时间对比\n\n| 操作 | 手动方式 | 使用本 Skill |\n|------|----------|--------------|\n| 格式转换 | 15-20 分钟 | 0（自动） |\n| 图片上传 | 5-10 分钟 | 0（自动） |\n| 复制粘贴内容 | 2-3 分钟 | 0（自动） |\n| **总计** | **20-30 分钟** | **< 1 分钟** |\n\n**效率提升 30 倍以上**\n\n---\n\n## 解决方案\n\n本 Skill 使用微信 API 直接发布，稳定可靠：\n\n```\nMarkdown/HTML 文件\n     | Python 解析\n     v\n结构化数据（标题、内容、图片）\n     | WeChat API\n     v\n保存到公众号草稿箱（绝不自动发布）\n```\n\n### 核心特性\n\n- **基于 API**：直接调用 API，无需浏览器自动化\n- **跨平台**：支持 macOS、Linux、Windows\n- **双格式支持**：同时支持 Markdown (.md) 和 HTML (.html) 文件\n- **格式保留**：HTML 格式完整保留，Markdown 自动转换\n- **图片自动上传**：文章中的图片自动上传到微信服务器\n- **安全设计**：仅保存草稿，绝不自动发布\n- **小绿书支持**：支持发布为图文消息格式\n\n---\n\n## 环境要求\n\n| 要求 | 说明 |\n|------|------|\n| Claude Code | [claude.ai/code](https://claude.ai/code) |\n| Python 3.9+ | 仅使用标准库，无需额外依赖 |\n| WECHAT_API_KEY | 从 [wx.limyai.com](https://wx.limyai.com) 获取 |\n| 微信公众号 | 在 wx.limyai.com 完成授权 |\n\n---\n\n## 安装方式\n\n### 步骤一：克隆仓库\n\n```bash\ngit clone https://github.com/iamzifei/wechat-article-publisher-skill.git\n```\n\n### 步骤二：复制 Skill 到 Claude\n\n```bash\ncp -r wechat-article-publisher-skill/skills/wechat-article-publisher ~/.claude/skills/\n```\n\n### 步骤三：配置 API Key\n\n```bash\ncd wechat-article-publisher-skill\ncp .env.example .env\n# 编辑 .env 文件，设置你的 WECHAT_API_KEY\n```\n\n---\n\n## 使用方法\n\n### 自然语言\n\n```\n把 /path/to/article.md 发布到微信公众号\n```\n\n```\n帮我把这篇文章发到公众号：~/articles/ai-tools.md\n```\n\n```\n把这个HTML文章发布到公众号：~/newsletter/issue-01.html\n```\n\n```\nPublish ~/Documents/my-post.md to WeChat\n```\n\n```\n发布这个带排版的HTML文件到微信：~/export/formatted-post.html\n```\n\n### Skill 命令\n\n```\n/wechat-article-publisher /path/to/article.md\n```\n\n```\n/wechat-article-publisher /path/to/article.html\n```\n\n### 带选项使用\n\n```\n# 发布为小绿书（图文消息）\n/wechat-article-publisher /path/to/article.md --type newspic\n```\n\n---\n\n## 工作流程\n\n```\n[1/4] 检查 API Key...\n      -> 从 .env 加载 WECHAT_API_KEY\n\n[2/4] 获取公众号列表...\n      -> 查找已授权的公众号\n      -> 如果只有一个则自动选择，多个则询问用户\n\n[3/4] 发布文章...\n      -> 检测文件格式（Markdown 或 HTML）\n      -> 解析内容（标题、正文、图片）\n      -> 调用微信 API\n      -> 自动上传图片\n\n[4/4] 报告结果...\n      -> 显示成功信息\n      -> 提醒用户手动预览并发布\n```\n\n---\n\n## 支持的格式\n\n### Markdown (.md)\n\n| 语法 | 效果 |\n|------|------|\n| `# H1` | 文章标题（提取后不含在正文中） |\n| `## H2` | 二级标题 |\n| `### H3` | 三级标题 |\n| `**粗体**` | **粗体文字** |\n| `*斜体*` | *斜体文字* |\n| `[文字](url)` | 超链接 |\n| `> 引用` | 引用块 |\n| `- 列表` | 无序列表 |\n| `1. 列表` | 有序列表 |\n| ``` 代码 ``` | 代码块 |\n| `![](img.jpg)` | 图片（自动上传） |\n\n### HTML (.html)\n\n| 元素 | 效果 |\n|------|------|\n| `<title>` 或 `<h1>` | 文章标题 |\n| `<h2>`, `<h3>` | 章节标题 |\n| `<strong>`, `<b>` | **粗体文字** |\n| `<em>`, `<i>` | *斜体文字* |\n| `<a href=\"\">` | 超链接 |\n| `<blockquote>` | 引用块 |\n| `<ul>`, `<ol>` | 列表 |\n| `<table>` | 表格（保留） |\n| `<img src=\"\">` | 图片（自动上传） |\n| 内联样式 | 保留 |\n\n---\n\n## 文章类型\n\n### news（默认）\n标准的公众号文章格式，支持完整的富文本。\n\n### newspic（小绿书）\n以图片为主的内容格式：\n- 最多支持 20 张图片\n- 文字内容限制 1000 字\n- 适合图片为主的内容发布\n\n---\n\n## 完整示例\n\n### 输入：`article.md`\n\n```markdown\n# 2024 年最值得关注的 5 个 AI 工具\n\n![封面](./images/cover.jpg)\n\n人工智能工具在 2024 年迎来了爆发式增长。本文将介绍 5 个最值得关注的工具。\n\n## 1. Claude：最强对话 AI\n\n**Claude** 由 Anthropic 开发，在长文本理解方面表现出色。\n\n> Claude 的上下文窗口高达 200K tokens。\n\n![claude-demo](./images/claude-demo.png)\n```\n\n### 执行命令\n\n```\n把 ~/Documents/article.md 发布到微信公众号\n```\n\n### 执行结果\n\n```\n✓ 文章已成功发布到公众号草稿箱！\n\n标题: 2024 年最值得关注的 5 个 AI 工具\n状态: 已保存到草稿箱\n\n请登录微信公众平台预览并发布。\n```\n\n---\n\n## 项目结构\n\n```\nwechat-article-publisher-skill/\n├── .claude-plugin/\n│   └── plugin.json              # 插件配置\n├── skills/\n│   └── wechat-article-publisher/\n│       ├── SKILL.md             # Skill 核心指令\n│       └── scripts/\n│           ├── wechat_api.py    # 微信 API 客户端\n│           └── parse_markdown.py # Markdown 解析器\n├── docs/\n│   └── GUIDE.md                 # 详细使用指南\n├── .env.example                 # 环境变量模板\n├── README.md                    # 本文件（双语）\n└── LICENSE\n```\n\n---\n\n## 常见问题\n\n**Q: 如何获取 WECHAT_API_KEY？**\nA: 访问 [wx.limyai.com](https://wx.limyai.com)，注册并授权你的微信公众号，在控制台获取 API Key。\n\n**Q: 可以发布到多个公众号吗？**\nA: 可以！如果你授权了多个公众号，Skill 会询问你要发布到哪个。\n\n**Q: 图片会怎么处理？**\nA: 图片会自动上传到微信服务器。支持本地路径和网络 URL。\n\n**Q: 会自动发布文章吗？**\nA: 不会。文章始终保存为草稿，你需要在公众号后台手动发布。\n\n**Q: news 和 newspic 有什么区别？**\nA: `news` 是标准文章格式；`newspic`（小绿书）是图文消息格式，以图片为主，文字有限制。\n\n**Q: 支持 Windows 吗？**\nA: 支持！与浏览器自动化工具不同，本 Skill 基于 API，支持所有平台。\n\n---\n\n## API 参考\n\n### 获取公众号列表\n```bash\npython wechat_api.py list-accounts\n```\n\n### 发布 Markdown 文章\n```bash\npython wechat_api.py publish --appid <appid> --markdown /path/to/article.md\n```\n\n### 发布 HTML 文章\n```bash\npython wechat_api.py publish --appid <appid> --html /path/to/article.html\n```\n\n### 发布为小绿书\n```bash\npython wechat_api.py publish --appid <appid> --markdown /path/to/article.md --type newspic\n```\n\n---\n\n## 详细文档\n\n- [完整使用指南](docs/GUIDE.md) — 包含详细说明和更多示例\n\n---\n\n## 更新日志\n\n### v1.1.0 (2025-01)\n- 新增 HTML 文件支持，保留原有格式\n- 自动检测文件格式（Markdown 或 HTML）\n- 从 HTML `<title>` 或 `<h1>` 标签提取标题\n- 支持内联样式和丰富的 HTML 格式\n\n### v1.0.0 (2025-01)\n- 首次发布，支持微信公众号\n- 基于 API 发布（无需浏览器自动化）\n- 跨平台支持（macOS、Linux、Windows）\n- Markdown 自动转换为公众号格式\n- 图片自动上传\n- 小绿书（newspic）支持\n- 仅保存草稿（安全设计）\n\n---\n\n## 许可证\n\nMIT License - 见 [LICENSE](LICENSE)\n\n## 作者\n\n[iamzifei](https://github.com/iamzifei)\n\n---\n\n## 贡献\n\n- **Issues**：报告 Bug 或提出功能建议\n- **PR**：欢迎贡献代码\n",
  "bytes": 14660,
  "sha": "dd43b13c4c8f04c7aa56e3bd570a172c3f07b85ddae03f649eb4a2f40b9019e3",
  "repo_slug": "iamzifei/wechat-article-publisher-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_iamzifei_wechat_article_publisher_skill__746278b2/readme"
}