wxgzh-mcp · 微信公众号草稿管理技能

功能列表

文件结构

wxgzh-mcp/
├── SKILL.md              # 本说明文件
├── README.md             # 详细使用指南
├── config.json           # 配置文件（用户填写）
├── src/
│   ├── main.py           # 技能入口
│   ├── config.py         # 配置管理
│   ├── wechat_api.py     # 微信 API 封装
│   └── tools/
│       ├── token.py      # Token 工具
│       ├── media.py      # 媒体上传工具
│       └── draft.py       # 草稿管理工具
├── docker-compose.yml     # Docker 部署
└── requirements.txt       # Python 依赖

快速开始

第一步：配置白名单

本机 IP（用于 API 调用）需要加入微信公众号白名单。

查询本机 IP：

访问 https://api.ipify.org 或联系管理员获取。

添加白名单：

1. 登录 微信公众平台
2. 设置与开发 → 基本配置
3. IP 白名单 → 添加 IP

第二步：填写配置

在 config.json 中填入你的公众号信息：

{
  "app_id": "wx1234567890abcdef",
  "app_secret": "你的AppSecret",
  "proxy": null
}

第三步：安装依赖并测试

cd wxgzh-mcp
pip install -r requirements.txt

# 测试 Token 获取
python -c "from src.wechat_api import WeChatAPI; api = WeChatAPI(); print(api.get_access_token())"

第四步：创建草稿

from src.wechat_api import WeChatAPI

api = WeChatAPI()

# 上传封面图（需先准备图片）
thumb_result = api.upload_thumb("封面图路径.jpg")
thumb_media_id = thumb_result["media_id"]

# 创建草稿
result = api.add_draft(
    title="文章标题",
    content="<p>正文内容 HTML</p>",
    author="作者名",
    thumb_media_id=thumb_media_id,
    digest="摘要"
)

draft_media_id = result["media_id"]
print(f"草稿创建成功: {draft_media_id}")

常见问题

错误 40164：IP 不在白名单

• 解决方案：参见第一步「配置白名单」

错误 45003：标题/作者超出限制

• 标题最多 64 字符
• 作者最多 8 字符

错误 48001：API 未授权

• 个人订阅号无法使用群发 API
• 草稿功能正常，可手动发布

注意事项

• Access Token 有效期 2 小时，模块自动缓存
• 图片格式支持 JPG、PNG，大小限制 2MB
• 封面图必须先上传获取 media_id 才能创建草稿