核心用法
本技能是面向微信公众号运营者的全功能工具集,通过命令行脚本实现内容生产到发布的完整 workflow:
发文到草稿(publish.py):核心模块,支持 Markdown → HTML 本地转换、CSS 样式美化(内联样式、网络抓取)、自动生成/上传封面图(PNG/base64/URL)。特色功能包括 html_url 直接抓取网页正文(智能提取 js_content 或自定义 content_selector),支持网易、新浪、今日头条等站点的自动正文识别。提供 @file JSON 文件传参模式,解决 Windows PowerShell 中文编码问题。
草稿管理(drafts.py):批量获取、详情查看、删除草稿;支持 freepublish/submit 发布草稿;核心亮点是 clone 功能——可将源公众号草稿完整同步到其他公众号(自动处理封面图下载与重新上传)。
评论管理(comments.py):完整的评论生命周期管理:查询、开启/关闭、精选/取消精选、回复/删除回复、删除评论。
数据统计(stats.py):封装常用 datacube 接口,支持图文群发、阅读、分享、用户增减等数据查询。
多账号架构:通过 WECHAT_MP_ACCOUNTS 环境变量配置 JSON 数组,实现一次命令多号同步执行,适合 MCN 机构或企业矩阵运营。
显著优点
- 本地化优先:Markdown 转换、HTML 美化、封面生成均在本地完成,降低对第三方服务的依赖
- 智能内容提取:
auto_content_selector自动识别主流站点正文结构,og:image自动提取封面 - 多账号原生支持:JSON 配置即可实现矩阵账号批量操作,
clone功能解决跨号内容同步痛点 - 安全沙箱设计:文件路径参数限制在当前工作目录及子目录,禁止绝对路径与
..穿越 - 调试友好:
dry_run模式、debug_html_out输出中间产物,便于排查格式问题
潜在缺点与局限性
- 功能边界依赖官方 API:发布草稿为异步任务,无法实时确认最终发布状态;部分接口(如评论管理)需要
msg_data_id等前置数据 - CSS 处理能力有限:
style_url仅抓取页面内联<style>,不解析外链 CSS 文件 - Windows 编码陷阱:PowerShell 直接传 JSON 中文易乱码,必须使用
@file模式(文档已充分警示) - 封面图体积限制:默认 5MB 下载上限,超大图需手动调整
cover_url_max_bytes
适合人群
- 内容运营团队:需要批量发布、多账号同步的公众号矩阵运营者
- 技术型编辑:熟悉命令行,希望用 Markdown 写作并自动化发布的个人创作者
- 数据分析师:需要定期拉取
datacube统计数据的运营人员
常规风险
- API 限流与权限:微信接口存在调用频次限制,订阅号发布功能需认证,未认证账号可能遇到
48001等权限错误 - 素材管理:封面图上传为"永久素材",需注意公众号后台的素材总量限制
- 异步任务不确定性:
freepublish/submit提交后需等待微信回调或轮询确认,不适合需要即时确认发布的场景 - Cookie 安全:
WECHAT_MP_COOKIE等敏感信息通过环境变量传递,需避免泄露到日志或版本控制