# Wechat Draft Publisher

> 自动将HTML文章发布到微信公众号草稿箱（小龙虾适配版）。首次使用自动引导配置IP白名单。当用户说"推送到微信"、"发布到公众号"、"上传草稿"时使用。

- Skill: `bnd-1/wechat-draft-publisher-2` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add bnd-1/wechat-draft-publisher-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bnd-1/wechat-draft-publisher-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: bnd-1 (https://skillmd.com/u/bnd-1)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/bnd-1/wechat-draft-publisher-2

---


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

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

---

## 前置：安装依赖

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

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

---

## 首次使用：引导配置

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

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

```bash
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步：运行发布器（自动引导输入凭证）

```bash
python publisher.py --title "文章标题" --content article.html
```

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

---

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

### 一键发布

```bash
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 whitelist` | IP不在白名单 | 运行 `python publisher.py --query-ip` 查IP并添加 |
| `AppSecret error` | 凭证错误 | 检查 `~/.wechat-publisher/config.json` |
| `title size out of limit` | 标题太长 | 工具会自动截断，无需处理 |
| `api功能未授权` | 公众号类型不支持 | 需要认证的服务号 |

---

## 配置文件位置

`~/.wechat-publisher/config.json`

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

---

## 完整工作流联动

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

用户只需要说三句话：
1. "写一篇关于XXX的文章"
2. "美化文章"
3. "推送到微信"