WeChat GZH

WeChat GZH - 微信公众号管理

微信公众号 API 封装，支持素材管理和发布能力。

功能列表

• 凭证管理

获取_stable_访问_令牌 - 获取稳定版 访问 令牌

• 素材管理

添加_material - 上传永久素材（图片/视频/语音/缩略图） 获取_material - 获取永久素材

• 发布能力

添加_draft - 新建草稿 获取_draft - 获取草稿列表 删除_draft - 删除草稿 submit_publish - 发布草稿 获取_publish_状态 - 发布状态查询 获取_published_articles - 获取已发布图文信息 获取_published_列出 - 获取已发布的消息列表 删除_publish - 删除发布文章 配置

首次使用需要配置 应用ID 和 应用Secret：

# 创建配置文件 cat > ~/.wechat_gzh_config.json << EOF { "应用id": "your_应用id_here", "secret": "your_应用secret_here" } EOF

# 设置权限 chmod 600 ~/.wechat_gzh_config.json

使用方法 Python API from scripts.wechat_gzh 导入 WeChatGZH

# 初始化 wechat = WeChatGZH()

# 获取 访问 令牌 令牌 = wechat.获取_stable_访问_令牌()

# 上传永久素材 结果 = wechat.添加_material("/path/to/image.jpg", "image") print(f"Media ID: {结果['media_id']}")

# 上传视频素材 结果 = wechat.添加_material( "/path/to/video.mp4", "video", video_信息={"title": "我的视频", "introduction": "视频描述"} )

# 获取已发布列表 articles = wechat.获取_published_列出(off设置=0, count=10)

# 发布草稿 结果 = wechat.submit_publish(media_id="xxx")

命令行 # 获取 访问 令牌 python scripts/wechat_gzh.py 获取-令牌

# 上传永久素材 python scripts/wechat_gzh.py 上传-material -f /path/to/image.jpg -t image python scripts/wechat_gzh.py 上传-material -f /path/to/video.mp4 -t video --title "视频标题"

# 获取已发布列表 python scripts/wechat_gzh.py 列出-published --off设置 0 --count 10

# 发布草稿 python scripts/wechat_gzh.py publish --media-id xxx

# 查询发布状态 python scripts/wechat_gzh.py 状态 --publish-id xxx

API 端点 凭证 获取 Stable 访问 令牌: POST https://API.weixin.qq.com/cgi-bin/stable_令牌 素材 上传永久素材: POST https://API.weixin.qq.com/cgi-bin/material/添加_material 获取永久素材: POST https://API.weixin.qq.com/cgi-bin/material/获取_material 发布 新建草稿: POST https://API.weixin.qq.com/cgi-bin/draft/添加 获取草稿列表: POST https://API.weixin.qq.com/cgi-bin/draft/batch获取 删除草稿: POST https://API.weixin.qq.com/cgi-bin/draft/删除 发布草稿: POST https://API.weixin.qq.com/cgi-bin/freepublish/submit 发布状态查询: POST https://API.weixin.qq.com/cgi-bin/freepublish/获取 获取已发布图文信息: POST https://API.weixin.qq.com/cgi-bin/freepublish/获取article 获取已发布的消息列表: POST https://API.weixin.qq.com/cgi-bin/freepublish/batch获取 删除发布文章: POST https://API.weixin.qq.com/cgi-bin/freepublish/删除 注意事项 访问 令牌 缓存: 令牌 有效期 7200 秒，建议缓存复用 调用频率: 每分钟限制 1 万次，每天 50 万次 强制刷新: 每天限用 20 次，需间隔 30 秒 IP 白名单: 需要在公众号后台配置服务器 IP 白名单 权限要求: 部分接口需要认证服务号 错误处理

常见错误码：

40001: invalid 凭证 - 访问_令牌 无效 40007: invalid media_id - 无效的媒体 ID 48001: API un授权d - 接口未授权

完整错误码参考：https://developers.weixin.qq.com/doc/o平台/developers/errCode/errCode.html

示例场景 发布一篇图文 # 1. 准备图文素材（需要先上传） # 2. 创建草稿 draft = wechat.添加_draft(articles=[{ "title": "标题", "content": "正文内容", "thumb_media_id": "封面图 media_id" }])

# 3. 发布草稿 结果 = wechat.submit_publish(media_id=draft['media_id'])

# 4. 查询发布状态 状态 = wechat.获取_publish_状态(publish_id=结果['publish_id'])

参考文档 获取稳定版接口调用凭据 获取永久素材 发布能力