核心用法
wechat-mp-suite 是一套面向微信公众号（WeChat MP）的自动化运营工具，基于 Python 脚本实现完整的公众号管理链路。核心模块包括：
1. 发文到草稿（publish.py）
- Markdown 转 HTML 并内联样式美化，支持
css/css_path/style_url三种样式注入方式 - 智能正文提取：支持公众号、网易、新浪、今日头条等站点，通过
content_selector或auto_content_selector自动抽取正文 - 灵活封面处理：优先使用用户指定的
cover_path/cover_base64/cover_url，或自动提取og:image，上传至微信永久素材库 - 多模式输入：支持本地文件路径、直接传内容、或从
html_url抓取网页
2. 草稿管理（drafts.py）
- 批量获取、详情查询、删除草稿
- 提交发布（freepublish_submit）
- 跨号克隆（clone）：将源公众号草稿同步到多个目标公众号，自动处理封面图下载与重新上传
3. 评论管理（comments.py）
- 查询、开启/关闭评论、精选/取消精选、回复/删除回复、删除评论
4. 用户管理（users.py）
- 黑名单管理（查询、批量拉黑/取消拉黑，每次最多20个openid）
- 关注者列表分页、用户基本信息查询
5. 数据统计（stats.py）
- 接入微信 datacube：图文群发、阅读、分享、用户增减、累计用户等数据
多公众号配置：通过 WECHAT_MP_ACCOUNTS JSON 数组实现多账号管理，所有操作默认同步执行。
显著优点
- 工作流闭环：从内容创作（Markdown）、样式美化、封面处理到发布、评论管理、数据分析，覆盖运营全链路
- 跨平台内容迁移：
html_url+content_selector组合可快速将外部站点内容迁移至公众号，自动提取正文并美化 - 多账号协同：单命令多号同步，大幅降低矩阵账号运营成本
- 安全路径限制：文件读取参数默认限制在当前工作目录及子目录，禁止目录穿越
- Windows 友好：针对 PowerShell 中文编码问题，提供
@fileJSON 文件传参方案
潜在缺点与局限性
- 依赖微信官方 API 权限：发布、评论管理、黑名单等接口需认证订阅号或服务号，个人未认证号权限受限（可能返回 48001 等错误）
- 封面图尺寸限制：微信对封面图有规格要求，过大或格式不符会导致上传失败
- 内容体积限制：公众号正文有大小上限（约 64KB HTML），超大会返回 45002 错误
- 异步发布机制：
freepublish_submit仅提交任务，真正发布完成是异步的，需配置回调接收结果 - clone 功能限制：跨号克隆时，封面图需重新下载上传，若原图为临时素材可能失效；不支持克隆已发布的图文消息
适合人群
- 内容创作者/自媒体运营者：需要高效将 Markdown 内容发布至多平台
- 企业新媒体运营团队：管理矩阵账号，需统一内容分发与数据监控
- 技术型编辑：习惯用 Git + Markdown 管理内容，希望自动化微信发布流程
- 数据驱动运营者：需要定期拉取阅读、分享、用户增长等数据做分析
常规风险
- 凭据泄露风险：
WECHAT_MP_APP_SECRET、WECHAT_MP_ACCOUNTS、WECHAT_MP_COOKIE均包含敏感信息，需避免写入日志、截图或公开仓库 - IP 封禁风险：频繁调用微信 API 可能触发速率限制，建议合理控制调用频率
- 内容合规风险：自动化抓取外部站点内容可能涉及版权，需确保获得授权；自动提取正文可能包含未预期的元素，建议 dry_run 预览
- 多账号操作风险：clone 或批量操作时，若配置错误可能导致内容发至错误账号，建议先单账号测试