微信公众号草稿

技能标识：wechat-mp-draft

代写微信公众号文章并保存到公众号草稿箱。使用场景：用户需要撰写公众号文章并直接发布到微信公众号后台草稿箱。触发词："写公众号文章"、"保存到公众号草稿"、"微信文章"、"公众号发文"。

作者：admin | 来源记录：ClawHub

字段	类型	必填	说明
title	string	是	标题，不超过32字
content

错误码	说明	解决
40001	accesstoken 过期	重新获取
40007

微信公众号草稿 Skill

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

前置条件

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

- AppID: wxYOURAPPIDHERE
AppSecret: YOURSECRETHERE

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

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

工作流程

1. 获取 Access Token

bash
./scripts/getaccesstoken.sh

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

封面图片是必填项！

bash
./scripts/uploadimage.sh token> <图片路径>

字段	类型	必填	说明
title	string	是	标题，不超过32字
content

错误码	说明	解决
40001	accesstoken 过期	重新获取
40007

返回示例：
json
{media_id:xxx,url:http://mmbiz.qpic.cn/...}

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

bash
./scripts/adddraft.sh token> <标题> mediaid> [作者] [摘要]

关键问题与解决方案

❌ 问题 1：40007 invalid media_id

原因：

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

解决：
必须先上传封面图片获取 thumbmediaid：
bash
curl -F media=@cover.jpg https://api.weixin.qq.com/cgi-bin/material/addmaterial?accesstoken=TOKEN&type=image

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

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

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

解决：

- HTML 中的换行符会导致 JSON 解析失败
必须将换行符替换为空格
使用 tr \n 处理

完整使用示例

bash

1. 获取 token

TOKEN=$(./scripts/getaccesstoken.sh | jq -r .access_token)

2. 上传封面图
THUMBRESPONSE=$(./scripts/uploadimage.sh $TOKEN /path/to/cover.jpg) THUMBID=$(echo $THUMBRESPONSE | jq -r .media_id)
3. 准备文章内容（HTML 格式）
CONTENT=
这里是文章内容...

4. 保存草稿
./scripts/adddraft.sh $TOKEN 文章标题 $CONTENT $THUMBID 作者摘要
API 参数说明

新增草稿必填字段

字段类型必填说明
title string 是标题，不超过32字
content
string | 是 | HTML内容，不超过2万字符 | | thumbmediaid | string | 是 | 封面图片永久素材ID | | author | string | 否 | 作者，不超过16字 | | digest | string | 否 | 摘要，不超过128字 | | showcoverpic | number | 否 | 是否显示封面，0/1 | | needopencomment | number | 否 | 是否打开评论，0/1 | | onlyfanscan_comment | number | 否 | 是否仅粉丝可评论，0/1 |
支持的 HTML 标签

-
- 段落

- 换行
- 区块
- 图片（需先上传获取 media_id）
, - 加粗
- 带样式的文本
- 链接
-
- 标题

错误码速查

错误码说明解决
40001 accesstoken 过期重新获取
40007
mediaid 无效 | 检查封面图是否上传正确 | | 40164 | IP 不在白名单 | 添加 IP 到白名单 | | 44002 | POST 数据为空 | 检查请求体 | | 47001 | 数据格式错误 | 检查 JSON 格式 |
注意事项

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

文件结构

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

微信公众号草稿