核心用法
mp-draft-push 是一款面向微信公众号运营场景的自动化发布工具,核心功能是将已准备好的文章内容直接推送至公众号草稿箱。该技能采用命令行脚本架构,依赖 bash、curl、jq 等系统工具,通过调用微信官方 API 完成内容上传。
使用流程分为四步:首先接收调用方传入的文章参数(标题、摘要、HTML 正文、可选封面图路径);随后获取微信接口凭证 access_token;接着将封面图上传至微信素材库获取 thumb_media_id;最后构建符合微信规范的 JSON 数据并创建草稿。
技能要求内容调用方预先完成内容生产,仅负责"最后一公里"的发布动作,不涉及 AI 写作、图片生成或内容采集。HTML 正文需严格使用内联样式(style="..."),且文章内图片必须使用微信 mmbiz.qpic.cn 域名的 URL。
---
显著优点
- 即插即用:纯脚本实现,无需复杂运行时环境,依赖工具均为 Linux/macOS 系统标配
- 流程标准化:封装了微信 API 的鉴权、素材上传、草稿创建全流程,减少重复开发
- 兜底机制:支持通过环境变量配置默认封面 URL,无封面时可自动降级处理
- 合规友好:内置微信 HTML 规范提示(内联样式、图片域名限制),降低格式错误风险
---
潜在缺点与局限性
- 前置依赖重:需自行解决内容来源、排版美化、图片上传至微信素材库等环节
- 硬编码风险:
scripts.sh为外部依赖,若仓库未完整包含或路径变更会导致执行失败 - Token 管理简陋:每次重新获取
access_token,无本地缓存机制,高并发场景可能触发频率限制 - 调试困难:失败时仅打印原始 API 响应,缺乏结构化错误码映射和重试策略
- 安全凭证暴露:
WECHAT_APPID/WECHAT_SECRET通过环境变量传递,无加密存储建议
---
适合人群
- 已有内容生产管线(如 Markdown → HTML 转换流程)的技术型运营者
- 需要将 CMS、AI 写作工具与公众号打通的开发者/小团队
- 追求"写完即走"、不依赖微信后台手动操作的效率导向用户
---
常规风险
1. API 限流风险:微信开放平台对素材上传、草稿创建有频次限制,高频使用需自行实现队列或重试
2. 内容合规风险:技能本身无内容审核机制,违规内容推送可能导致公众号被封禁
3. 凭证泄露风险:环境变量中的 AppSecret 若被日志记录或误提交,将导致账号被盗用
4. 格式兼容风险:微信 HTML 渲染规则时常调整,历史样式可能在新版本中出现错位