微信公众号文章发布器 - 通过API将Markdown/HTML内容发布到公众号草稿箱

wechat-article-publisher by iamzifei/wechat-article-publisher-skill

1,000 周安装量

93 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/iamzifei/wechat-article-publisher-skill --skill wechat-article-publisher

开发生产力 API

🇨🇳中文介绍

微信公众号文章发布器

通过 API 将 Markdown 或 HTML 内容发布到微信公众号草稿箱，支持自动格式转换。

前提条件

已设置 WECHAT_API_KEY 环境变量（来自 .env 文件）
Python 3.9+
已在 wx.limyai.com 上授权微信公众号

脚本

位于 ~/.claude/skills/wechat-article-publisher/scripts/:

wechat_api.py

用于列出账号和发布文章的微信 API 客户端：

# 列出已授权账号
python wechat_api.py list-accounts

# 从 markdown 文件发布
python wechat_api.py publish --appid <wechat_appid> --markdown /path/to/article.md

# 从 HTML 文件发布（保留格式）
python wechat_api.py publish --appid <wechat_appid> --html /path/to/article.html

# 使用自定义选项发布
python wechat_api.py publish --appid <appid> --markdown /path/to/article.md --type newspic

parse_markdown.py

解析 Markdown 并提取结构化数据（可选，用于高级用途）：

python parse_markdown.py <markdown_file> [--output json|html]

工作流程

策略："API 优先发布"

与基于浏览器的发布方式不同，此技能使用直接 API 调用实现可靠、快速的发布。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 1：检查 API 密钥

在任何操作之前，验证 API 密钥是否可用：

# 检查 .env 文件是否存在并包含 WECHAT_API_KEY
cat .env | grep WECHAT_API_KEY

如果未设置，提醒用户：

复制 .env.example 到 .env
设置他们的 WECHAT_API_KEY 值

步骤 2：列出可用账号

获取已授权的微信账号列表：

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py list-accounts

{
  "success": true,
  "data": {
    "accounts": [
      {
        "name": "我的公众号",
        "wechatAppid": "wx1234567890",
        "username": "gh_abc123",
        "type": "subscription",
        "verified": true,
        "status": "active"
      }
    ],
    "total": 1
  }
}

如果只有一个账号，自动使用它
如果有多个账号，请用户选择
记下 wechatAppid 用于发布

步骤 3：发布文章

对于 Markdown 文件：

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid <wechatAppid> \
  --markdown /path/to/article.md

对于 HTML 文件（保留格式）：

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid <wechatAppid> \
  --html /path/to/article.html

对于小绿书（图文模式）：

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid <wechatAppid> \
  --markdown /path/to/article.md \
  --type newspic

{
  "success": true,
  "data": {
    "publicationId": "uuid-here",
    "materialId": "uuid-here",
    "mediaId": "wechat-media-id",
    "status": "published",
    "message": "文章已成功发布到公众号草稿箱"
  }
}

步骤 4：报告结果

确认草稿已创建
提醒用户在微信管理后台手动预览并发布
提供任何相关的 ID 供参考

所有 API 请求都需要 X-API-Key 请求头：

X-API-Key: WECHAT_API_KEY

POST https://wx.limyai.com/api/openapi/wechat-accounts

POST https://wx.limyai.com/api/openapi/wechat-publish

参数	类型	必填	描述
wechatAppid	string	是	微信 AppID
title	string	是	文章标题（最多 64 字符）
content	string	是	文章内容（Markdown/HTML）
summary	string	否	文章摘要（最多 120 字符）
coverImage	string	否	封面图片 URL
author	string	否	作者名称
contentFormat	string	否	'markdown'（默认）或 'html'
articleType	string	否	'news'（默认）或 'newspic'

代码	描述
API_KEY_MISSING	未提供 API 密钥
API_KEY_INVALID	API 密钥无效
ACCOUNT_NOT_FOUND	账号未找到或未授权
ACCOUNT_TOKEN_EXPIRED	账号授权已过期
INVALID_PARAMETER	参数无效
WECHAT_API_ERROR	微信 API 调用失败
INTERNAL_ERROR	服务器错误

切勿自动发布 - 仅保存到草稿箱，用户手动发布
首先检查 API 密钥 - 如果未配置则快速失败
首先列出账号 - 用户可能有多个账号
优雅处理错误 - 显示清晰的错误信息
保留原始内容 - 不必要地修改用户的 markdown

Markdown 文件 (.md)

H1 标题 (# ) → 文章标题
H2/H3 标题 (##, ###) → 章节标题
粗体 (text)
斜体 (text)
链接 text
引用块 (> )
代码块 (...)
列表 (- 或 1.)
图片 → 自动上传到微信

<title> 或 <h1> → 文章标题
所有 HTML 格式保留（样式、表格等）
<img> 标签 → 图片自动上传到微信
第一个 <p> → 自动提取为摘要
支持内联样式和丰富格式

HTML 标题提取优先级：

<title> 标签内容
第一个 <h1> 标签内容
回退为 "Untitled"

HTML 内容提取：

如果存在 <body>，使用 body 内容
否则，去除 <html>、<head>、<!DOCTYPE> 并使用剩余内容

标准微信文章格式
完整的 Markdown/HTML 支持
包含图片的富文本

newspic (小绿书/图文消息)

以图片为中心的格式（类似 Instagram 帖子）
从内容中最多提取 20 张图片
文本内容限制为 1000 字符
图片自动上传到微信

用户："把 ~/articles/ai-tools.md 发布到微信公众号"

# 步骤 1: 验证 API 密钥
cat .env | grep WECHAT_API_KEY

# 步骤 2: 列出账号
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py list-accounts

# 步骤 3: 发布（假设只有一个账号，appid 为 wx1234567890）
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid wx1234567890 \
  --markdown ~/articles/ai-tools.md

# 步骤 4: 报告
# "文章已成功发布到公众号草稿箱！请登录微信公众平台预览并发布。"

用户："把这个HTML文章发布到公众号：~/articles/newsletter.html"

# 步骤 1: 验证 API 密钥
cat .env | grep WECHAT_API_KEY

# 步骤 2: 列出账号
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py list-accounts

# 步骤 3: 发布 HTML（自动检测格式）
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid wx1234567890 \
  --html ~/articles/newsletter.html

# 步骤 4: 报告
# "文章已成功发布到公众号草稿箱！HTML格式已保留。请登录微信公众平台预览并发布。"

Error: WECHAT_API_KEY environment variable not set.

解决方案：要求用户使用 API 密钥设置 .env 文件。

Error: ACCOUNT_NOT_FOUND - 公众号不存在或未授权

解决方案：要求用户在 wx.limyai.com 上授权其账号。

Error: ACCOUNT_TOKEN_EXPIRED - 公众号授权已过期

解决方案：要求用户在 wx.limyai.com 上重新授权。

Error: WECHAT_API_ERROR - 微信接口调用失败

解决方案：可能是临时问题，重试或检查微信服务状态。

为什么使用 API 而不是浏览器自动化？

可靠性：直接 API 调用比浏览器自动化更稳定
速度：无需浏览器启动、页面加载或 UI 交互
简单性：单条命令即可发布
可移植性：适用于任何安装 Python 的系统（无仅限 macOS 的依赖项）

图片：尽可能使用公共 URL；本地图片将被上传
标题：保持在 64 字符以内
摘要：如果未提供，从第一段自动提取
封面：如果未指定，markdown 中的第一张图片将成为封面

最小工作流程（1 条命令）：
- list-accounts → 获取 appid → publish → 完成

完整工作流程（带验证）：
1. 检查 .env → 列出账号 → 与用户确认
2. 使用选项发布 → 报告结果

问：如何获取 WECHAT_API_KEY？

答：在 wx.limyai.com 注册并授权您的微信账号以获取 API 密钥。

问：我可以发布到多个账号吗？

答：可以，使用 list-accounts 查看所有已授权账号，然后指定目标 --appid。

问：图片在微信中不显示？

答：确保图片是可访问的 URL。本地图片会自动上传，但如果路径不正确可能会失败。

问：标题太长？

答：微信限制标题为 64 字符。脚本将使用 H1 的前 64 个字符。

问：news 和 newspic 有什么区别？

答：news 是标准文章格式；newspic（小绿书）是以图片为中心且文本有限的格式。

🇺🇸English

WeChat Article Publisher

Publish Markdown or HTML content to WeChat Official Account drafts via API, with automatic format conversion.

Prerequisites

WECHAT_API_KEY environment variable set (from .env file)
Python 3.9+
Authorized WeChat Official Account on wx.limyai.com

Scripts

Located in ~/.claude/skills/wechat-article-publisher/scripts/:

wechat_api.py

WeChat API client for listing accounts and publishing articles:

# List authorized accounts
python wechat_api.py list-accounts

# Publish from markdown file
python wechat_api.py publish --appid <wechat_appid> --markdown /path/to/article.md

# Publish from HTML file (preserves formatting)
python wechat_api.py publish --appid <wechat_appid> --html /path/to/article.html

# Publish with custom options
python wechat_api.py publish --appid <appid> --markdown /path/to/article.md --type newspic

parse_markdown.py

Parse Markdown and extract structured data (optional, for advanced use):

python parse_markdown.py <markdown_file> [--output json|html]

Workflow

Strategy: "API-First Publishing"

Unlike browser-based publishing, this skill uses direct API calls for reliable, fast publishing.

Load WECHAT_API_KEY from environment
List available WeChat accounts (if user hasn't specified)
Detect file format (Markdown or HTML) and parse accordingly
Call publish API to create draft in WeChat
Report success with draft details

Supported File Formats:

.md files → Parsed as Markdown, converted by WeChat API
.html files → Sent as HTML, formatting preserved

Step-by-Step Guide

Step 1: Check API Key

Before any operation, verify the API key is available:

# Check if .env file exists and contains WECHAT_API_KEY
cat .env | grep WECHAT_API_KEY

If not set, remind user to:

Copy .env.example to .env
Set their WECHAT_API_KEY value

Step 2: List Available Accounts

Get the list of authorized WeChat accounts:

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py list-accounts

Output example:

{
  "success": true,
  "data": {
    "accounts": [
      {
        "name": "我的公众号",
        "wechatAppid": "wx1234567890",
        "username": "gh_abc123",
        "type": "subscription",
        "verified": true,
        "status": "active"
      }
    ],
    "total": 1
  }
}

Important :

If only one account, use it automatically
If multiple accounts, ask user to choose
Note the wechatAppid for publishing

Step 3: Publish Article

For Markdown files:

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid <wechatAppid> \
  --markdown /path/to/article.md

For HTML files (preserves formatting):

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid <wechatAppid> \
  --html /path/to/article.html

For 小绿书 (image-text mode):

python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid <wechatAppid> \
  --markdown /path/to/article.md \
  --type newspic

Success response:

{
  "success": true,
  "data": {
    "publicationId": "uuid-here",
    "materialId": "uuid-here",
    "mediaId": "wechat-media-id",
    "status": "published",
    "message": "文章已成功发布到公众号草稿箱"
  }
}

Step 4: Report Result

After successful publishing:

Confirm the draft was created
Remind user to review and publish manually in WeChat admin panel
Provide any relevant IDs for reference

API Reference

Authentication

All API requests require the X-API-Key header:

X-API-Key: WECHAT_API_KEY

Get Accounts List

POST https://wx.limyai.com/api/openapi/wechat-accounts

Publish Article

POST https://wx.limyai.com/api/openapi/wechat-publish

Parameters:

Parameter	Type	Required	Description
wechatAppid	string	Yes	WeChat AppID
title	string	Yes	Article title (max 64 chars)
content	string	Yes	Article content (Markdown/HTML)
summary	string	No	Article summary (max 120 chars)
coverImage	string	No	Cover image URL
author	string	No	Author name
contentFormat	string	No	'markdown' (default) or 'html'

Error Codes

Code	Description
API_KEY_MISSING	API key not provided
API_KEY_INVALID	API key invalid
ACCOUNT_NOT_FOUND	Account not found or unauthorized
ACCOUNT_TOKEN_EXPIRED	Account authorization expired
INVALID_PARAMETER	Invalid parameter
WECHAT_API_ERROR	WeChat API call failed
INTERNAL_ERROR	Server error

Critical Rules

NEVER auto-publish - Only save to drafts, user publishes manually
Check API key first - Fail fast if not configured
List accounts first - User may have multiple accounts
Handle errors gracefully - Show clear error messages
Preserve original content - Don't modify user's markdown unnecessarily

Supported Formats

Markdown Files (.md)

H1 header (# ) → Article title
H2/H3 headers (##, ###) → Section headers
Bold (text)
Italic (text)
Links text
Blockquotes (> )
Code blocks (...)
Lists (- or 1.)
Images → Auto-uploaded to WeChat

HTML Files (.html)

<title> or <h1> → Article title
All HTML formatting preserved (styles, tables, etc.)
<img> tags → Images auto-uploaded to WeChat
First <p> → Auto-extracted as summary
Supports inline styles and rich formatting

HTML Title Extraction Priority:

<title> tag content
First <h1> tag content
"Untitled" as fallback

HTML Content Extraction:

If <body> exists, uses body content
Otherwise, strips <html>, <head>, <!DOCTYPE> and uses remaining content

Article Types

news (普通文章)

Standard WeChat article format
Full Markdown/HTML support
Rich text with images

newspic (小绿书/图文消息)

Image-focused format (like Instagram posts)
Maximum 20 images extracted from content
Text content limited to 1000 characters
Images auto-uploaded to WeChat

Example Flow

Markdown File

User: "把 ~/articles/ai-tools.md 发布到微信公众号"

# Step 1: Verify API key
cat .env | grep WECHAT_API_KEY

# Step 2: List accounts
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py list-accounts

# Step 3: Publish (assuming single account with appid wx1234567890)
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid wx1234567890 \
  --markdown ~/articles/ai-tools.md

# Step 4: Report
# "文章已成功发布到公众号草稿箱！请登录微信公众平台预览并发布。"

HTML File

User: "把这个HTML文章发布到公众号：~/articles/newsletter.html"

# Step 1: Verify API key
cat .env | grep WECHAT_API_KEY

# Step 2: List accounts
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py list-accounts

# Step 3: Publish HTML (auto-detects format)
python ~/.claude/skills/wechat-article-publisher/scripts/wechat_api.py publish \
  --appid wx1234567890 \
  --html ~/articles/newsletter.html

# Step 4: Report
# "文章已成功发布到公众号草稿箱！HTML格式已保留。请登录微信公众平台预览并发布。"

Error Handling

API Key Not Found

Error: WECHAT_API_KEY environment variable not set.

Solution : Ask user to set up .env file with their API key.

Account Not Found

Error: ACCOUNT_NOT_FOUND - 公众号不存在或未授权

Solution : Ask user to authorize their account on wx.limyai.com.

Token Expired

Error: ACCOUNT_TOKEN_EXPIRED - 公众号授权已过期

Solution : Ask user to re-authorize on wx.limyai.com.

WeChat API Error

Error: WECHAT_API_ERROR - 微信接口调用失败

Solution : May be temporary issue, retry or check WeChat service status.

Best Practices

Why use API instead of browser automation?

Reliability : Direct API calls are more stable than browser automation
Speed : No browser startup, page loading, or UI interactions
Simplicity : Single command to publish
Portability : Works on any system with Python (no macOS-only dependencies)

Content Guidelines

Images : Use public URLs when possible; local images will be uploaded
Title : Keep under 64 characters
Summary : Auto-extracted from first paragraph if not provided
Cover : First image in markdown becomes cover if not specified

Workflow Efficiency

Minimal workflow (1 command):
- list-accounts → get appid → publish → done

Full workflow (with verification):
1. Check .env → list accounts → confirm with user
2. Publish with options → report result

Troubleshooting

Q: How do I get a WECHAT_API_KEY?

A: Register and authorize your WeChat account at wx.limyai.com to get your API key.

Q: Can I publish to multiple accounts?

A: Yes, use list-accounts to see all authorized accounts, then specify the target --appid.

Q: Images not showing in WeChat?

A: Ensure images are accessible URLs. Local images are auto-uploaded but may fail if path is incorrect.

Q: Title is too long?

A: WeChat limits titles to 64 characters. The script will use the first 64 chars of H1.

Q: What's the difference between news and newspic?

A: news is standard article format; newspic (小绿书) is image-focused with limited text.

Weekly Installs

1.0K

Repository

iamzifei/wechat…er-skill

GitHub Stars

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykPass

Installed on

opencode980

gemini-cli957

codex953

cursor950

github-copilot933

kimi-cli917

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装

微信公众号文章发布器 - 通过API将Markdown/HTML内容发布到公众号草稿箱

🇨🇳中文介绍

微信公众号文章发布器

前提条件

脚本

wechat_api.py

parse_markdown.py

工作流程

相关 Skills

分步指南

步骤 1：检查 API 密钥

步骤 2：列出可用账号

步骤 3：发布文章

步骤 4：报告结果

API 参考

认证

获取账号列表

发布文章

错误代码

关键规则

支持的格式

Markdown 文件 (.md)

HTML 文件 (.html)

文章类型

news (普通文章)

newspic (小绿书/图文消息)

示例流程

Markdown 文件

HTML 文件

错误处理

API 密钥未找到

账号未找到

令牌过期

微信 API 错误

最佳实践

为什么使用 API 而不是浏览器自动化？

内容指南

工作流程效率

故障排除

问：如何获取 WECHAT_API_KEY？

问：我可以发布到多个账号吗？

问：图片在微信中不显示？

问：标题太长？

问：news 和 newspic 有什么区别？

🇺🇸English

WeChat Article Publisher

Prerequisites

Scripts

wechat_api.py

parse_markdown.py

Workflow

Step-by-Step Guide

Step 1: Check API Key

Step 2: List Available Accounts

Step 3: Publish Article

Step 4: Report Result

API Reference

Authentication

Get Accounts List

Publish Article

Error Codes

Critical Rules

Supported Formats

Markdown Files (.md)

HTML Files (.html)

Article Types

news (普通文章)

newspic (小绿书/图文消息)

Example Flow

Markdown File

HTML File

Error Handling

API Key Not Found

Account Not Found

Token Expired

WeChat API Error

Best Practices

Why use API instead of browser automation?

Content Guidelines

Workflow Efficiency