wechat-mp-draft（微信议员草案）

微信公众号草稿 Skill

代写微信公众号文章并保存到草稿箱。

前置条件

需要以下凭证（需自行配置）：

• AppID: wxYOUR_APPID_HERE
• AppSecret: YOUR_SECRET_HERE

获取方式： 微信公众平台 → 设置与开发 → 基本配置

重要： 服务器 IP 必须添加到公众号后台的 IP 白名单中。

工作流程

1. 获取 Access Token

./scripts/get_access_token.sh

2. 上传封面图片（获取 thumb_media_id）

封面图片是必填项！

./scripts/upload_image.sh <access_token> <图片路径>

返回示例：

{"media_id":"xxx","url":"http://mmbiz.qpic.cn/..."}

3. 撰写文章并保存到草稿箱

./scripts/add_draft.sh <access_token> <标题> <HTML内容> <thumb_media_id> [作者] [摘要]

关键问题与解决方案

❌ 问题 1：40007 invalid media_id

原因：

• thumb_media_id 是必填字段
• 封面图片必须是永久素材（通过 add_material 接口上传）

解决： 必须先上传封面图片获取 thumb_media_id：

curl -F "media=@cover.jpg" "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=TOKEN&type=image"

❌ 问题 2：IP 不在白名单（40164）

解决： 登录微信公众平台 → 设置与开发 → 基本配置 → IP白名单 → 添加服务器 IP

❌ 问题 3：HTML 内容格式错误

解决：

• HTML 中的换行符会导致 JSON 解析失败
• 必须将换行符替换为空格
• 使用 `tr '\

' ' '` 处理

完整使用示例

# 1. 获取 token
TOKEN=$(./scripts/get_access_token.sh | jq -r '.access_token')

# 2. 上传封面图
THUMB_RESPONSE=$(./scripts/upload_image.sh "$TOKEN" /path/to/cover.jpg)
THUMB_ID=$(echo "$THUMB_RESPONSE" | jq -r '.media_id')

# 3. 准备文章内容（HTML 格式）
CONTENT='<p>这里是文章内容...</p>'

# 4. 保存草稿
./scripts/add_draft.sh "$TOKEN" "文章标题" "$CONTENT" "$THUMB_ID" "作者" "摘要"

API 参数说明

新增草稿必填字段

支持的 HTML 标签

• <p> - 段落
• <br> - 换行
• <section> - 区块
• <img> - 图片（需先上传获取 media_id）
• <strong>, <b> - 加粗
• <span style="..."> - 带样式的文本
• <a href="..."> - 链接
• <h1>-<h6> - 标题

错误码速查

注意事项

1. token 有效期 2 小时，过期需重新获取
2. 封面图必须先上传，不能直接引用外部 URL
3. HTML 内容需转义，避免 JSON 解析失败
4. IP 白名单必须配置，否则无法调用 API
5. 内容大小限制：正文 < 2万字符，< 1MB

文件结构

wechat-mp-draft/
├── SKILL.md                    # 本文件
├── scripts/
│   ├── get_access_token.sh     # 获取 token
│   ├── upload_image.sh         # 上传封面图片
│   └── add_draft.sh            # 保存草稿
└── references/
    └── api_reference.md        # API 详细文档