mcpField
W
wechat-draft-publisher

wechat-draft-publisher

github.com/bnd-1Marketing & growth177 installsUpdated 29w ago
Repository

About wechat-draft-publisher

wechat-draft-publisher is a skill for sending formatted articles to the WeChat Official Account draft box. It guides initial credential setup and prepares a draft for review before manual publication.

Key features

  1. 01Guided AppID and AppSecret setup
  2. 02Public IP lookup for whitelist configuration
  3. 03HTML article and cover image upload
  4. 04Draft creation with media_id result

Use cases

  1. 01Setting up WeChat publishing credentials for the first time
  2. 02Sending a formatted article to the draft box
  3. 03Checking a public IP after a whitelist error

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bnd-1/wechat_article_mini --skill wechat-draft-publisher

After installing, type/wechat-draft-publisherin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

publisher.py
README.md
requirements.txt
examples/
config.json.example
example.html
scripts/
fix-wechat-style.py
install.sh
optimize-html.py
publish-workflow.sh
test.sh

Details

From the project README

微信公众号草稿发布器（小龙虾极速版）

核心理念：首次引导配置，之后一键发布

前置：安装依赖

每次使用前，先确保依赖已安装（幂等操作，可重复执行）：

pip3 install -r skills/wechat-draft-publisher/requirements.txt

首次使用：引导配置

第1步：查询IP并告知用户

每次首次使用或遇到IP白名单错误时，先帮用户查询IP：

python publisher.py --query-ip

这会自动查询公网IP并显示：

>>> 你的公网IP是: x.x.x.x

请将此IP添加到微信公众号后台:
1. 登录 https://developers.weixin.qq.com/platform
2. 设置与开发 → 基本配置 → IP白名单
3. 添加IP: x.x.x.x

告诉用户：

首次使用需要配置两件事：

1. IP白名单：我已查到你的服务器IP是 x.x.x.x
   请登录微信公众号后台，在 设置与开发→基本配置→IP白名单 中添加这个IP

2. AppID和AppSecret：
   在同一页面（基本配置）中复制AppID和AppSecret
   运行发布工具时会自动引导你填写

配置好了告诉我，我就帮你发布！
第2步：运行发布器（自动引导输入凭证）
python publisher.py --title "文章标题" --content article.html

首次运行会自动提示输入 AppID 和 AppSecret。

正常发布流程（配置完成后）

一键发布
python publisher.py \
  --title "文章标题" \
  --content xxx_formatted.html \
  --cover cover.png \
  --author "小龙虾"
自动执行步骤
  1. 找 HTML 文件：优先 *_formatted.html，回退最新 .html
  2. 提取标题：从 HTML 注释或文件名
  3. 找封面图：cover.png
  4. 调用发布：上传封面 → 上传内容图片 → 创建草稿
  5. 返回结果：显示 media_id，提示去后台查看
发布成功后提示
✅ 文章已推送到草稿箱！

接下来：
1. 登录 https://developers.weixin.qq.com/platform
2. 进入"草稿箱"
3. 预览效果，确认后发布

⚠️ 草稿不会自动发布，你可以在后台编辑后再发

常见错误速查

错误原因解决
invalid ip not in whitelistIP不在白名单运行 python publisher.py --query-ip 查IP并添加
AppSecret error凭证错误检查 ~/.wechat-publisher/config.json
title size out of limit标题太长工具会自动截断，无需处理
api功能未授权公众号类型不支持需要认证的服务号

配置文件位置

~/.wechat-publisher/config.json

{
  "appid": "xxx",
  "appsecret": "xxx"
}

完整工作流联动

写文章(tech-writer/pm-writer) → 美化格式(formatter) → 推送到微信(本skill)

用户只需要说三句话：

  1. "写一篇关于XXX的文章"
  2. "美化文章"
  3. "推送到微信"

Comments

Markdown supported