Wechat API Lite

WeChat API Lite

微信公众号 API 轻量化工具。只保留发布图文必需的功能：令牌 获取、封面图上传、正文图片上传、草稿创建。无多余命令，无依赖膨胀。

凭证配置

复制示例文件并填入真实值：

技能_DIR="$HOME/.hermes/技能s/wechat-API-lite" cp "$技能_DIR/config.env.example" "$技能_DIR/config.env" # 编辑 config.env，填入 应用ID 和 应用Secret

应用ID 和 应用Secret 获取：微信公众平台 → 设置与开发 → 基本配置

核心命令 令牌 — 获取 访问_令牌

有效期 7200 秒，脚本内自动缓存 + 提前刷新。

python3 $HOME/.hermes/技能s/wechat-API-lite/scripts/wechat_API.py 令牌

上传-thumb — 上传封面图

返回 thumb_media_id，用于创建草稿时指定封面。

python3 $HOME/.hermes/技能s/wechat-API-lite/scripts/wechat_API.py 上传-thumb <文件路径> # 示例 python3 $HOME/.hermes/技能s/wechat-API-lite/scripts/wechat_API.py 上传-thumb ~/hermes/re搜索/Cover.png

封面图推荐尺寸：900 × 383 px（2.35:1 宽屏），PNG/JPG，不超过 2MB。

上传-image — 上传正文图片

返回 media_id + url，在正文 HTML 中用 url 嵌入图片。

python3 $HOME/.hermes/技能s/wechat-API-lite/scripts/wechat_API.py 上传-image <文件路径>

创建-draft — 创建图文草稿 python3 $HOME/.hermes/技能s/wechat-API-lite/scripts/wechat_API.py 创建-draft ~/hermes/re搜索/draft.json

draft.json 格式：

[ { "title": "文章标题（不超过32字）", "author": "作者名", "digest": "摘要", "content": "

HTML 格式正文...

", "thumb_media_id": "上传-thumb 返回的 ID", "show_cover_pic": 1, "need_open_comment": 1, "only_fans_can_comment": 0 } ]

成功输出：✅ 草稿创建成功: media_id=XXXXXXXXXXXXXXXX

draft-列出 — 查看草稿数量 python3 $HOME/.hermes/技能s/wechat-API-lite/scripts/wechat_API.py draft-列出

完整发布流程（wechat-post + wechat-API-lite 配合）

• wechat-post 生成 Markdown 正文

↓

• 将 Markdown 转为 HTML，写入 draft.json

↓

• wechat-API-lite 上传-thumb（上传封面 → thumb_media_id）

↓

• wechat-API-lite 创建-draft（创建草稿 → media_id）

↓

• 登录 mp.weixin.qq.com 草稿箱 → 预览 → 发布

草稿字段说明 字段 必填 说明 title ✅ 标题，不超过 32 字符 author 否 作者名，不超过 16 字 digest 否 摘要，默认取正文前 54 字 content ✅ HTML 格式正文 thumb_media_id ✅ 封面图 ID（来自 上传-thumb） show_cover_pic 否 是否在正文显示封面（0/1） need_open_comment 否 是否打开评论（0/1） only_fans_can_comment 否 是否仅粉丝可评论（0/1） 已知问题 & API 行为 访问_令牌 过期（40001）

令牌 过期后所有 API 调用均失败。清除缓存后重试：

rm ~/.hermes/技能s/wechat-API-lite/scripts/.令牌_缓存 python3 $HOME/.hermes/技能s/wechat-API-lite/scripts/wechat_API.py 上传-thumb ...

成功响应无 errcode

以下接口成功时不返回 errcode，判断成功仅看业务字段是否存在：

接口 成功判断依据 draft/添加（创建草稿） "media_id" in 结果 draft/count（草稿数量） "total_count" in 结果 url vs media_id 正文 HTML 图片 → 用 上传-image 返回的 url 草稿封面图 → 用 上传-thumb 返回的 media_id

两者不可混用。

⚠️ 草稿正文图注位置注意

在 JSON 中写 HTML 正文时，如果要给配图加 caption 注释，caption 必须紧跟在对应的 标签后面，不要写在正文开头或其他位置。公众号渲染会把 caption 放在图片在正文中出现的相对位置，误放在文章顶部会导致 caption 跑到文章最下方显示。

正文 HTML 图片 → 用 上传-image 返回的 url 草稿封面图 → 用 上传-thumb 返回的 media_id

两者不可混用。

注意事项 访问_令牌 有效期 2 小时，脚本自动维护缓存，过期后手动清缓存重刷 永久素材有总量限制，缩略图不超过 2MB 封面图推荐 900 × 383 px，正文图片宽度建议 ≤ 1080px 草稿创建后在 mp.weixin.qq.com 草稿箱查看和编辑