微信公众号草稿 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 '\n' ' ' 处理
完整使用示例
# 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 参数说明
新增草稿必填字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 标题，不超过32字 |
| content | string | 是 | HTML内容，不超过2万字符 |
| thumb_media_id | string | 是 | 封面图片永久素材ID |
| author | string | 否 | 作者，不超过16字 |
| digest | string | 否 | 摘要，不超过128字 |
| show_cover_pic | number | 否 | 是否显示封面，0/1 |
| need_open_comment | number | 否 | 是否打开评论，0/1 |
| only_fans_can_comment | number | 否 | 是否仅粉丝可评论，0/1 |
支持的 HTML 标签
<p>- 段落<br>- 换行<section>- 区块<img>- 图片（需先上传获取 media_id）<strong>,<b>- 加粗<span style="...">- 带样式的文本<a href="...">- 链接<h1>-<h6>- 标题
错误码速查
| 错误码 | 说明 | 解决 |
|---|---|---|
| 40001 | access_token 过期 | 重新获取 |
| 40007 | media_id 无效 | 检查封面图是否上传正确 |
| 40164 | IP 不在白名单 | 添加 IP 到白名单 |
| 44002 | POST 数据为空 | 检查请求体 |
| 47001 | 数据格式错误 | 检查 JSON 格式 |
注意事项
- token 有效期 2 小时，过期需重新获取
- 封面图必须先上传，不能直接引用外部 URL
- HTML 内容需转义，避免 JSON 解析失败
- IP 白名单必须配置，否则无法调用 API
- 内容大小限制：正文 < 2万字符，< 1MB
文件结构
wechat-mp-draft/
├── SKILL.md # 本文件
├── scripts/
│ ├── get_access_token.sh # 获取 token
│ ├── upload_image.sh # 上传封面图片
│ └── add_draft.sh # 保存草稿
└── references/
└── api_reference.md # API 详细文档
