公众号排版助手·一键高颜值排版

微信公众号运营工具集

本技能是一个 微信公众号（Wechat MP）运营工具集，用于管理微信公众账号，包含发文、草稿管理、用户管理、评论管理、数据统计等多个脚本，支持多公众号同步。
本技能由极速数据提供：https://www.jisuapi.com
信息反馈：请发邮件至 liupandeng@jisuapi.com

官方文档：https://developers.weixin.qq.com/doc/subscription/api/

现阶段能力（按模块）

• 发文到草稿（publish.py）
• Markdown → HTML（本地转换）
• HTML 美化（css / css_path / style_url 抓取 <style> 内联样式）
• 使用用户指定封面图（cover_path / cover_base64 / cover_url）并上传获取 thumb_media_id
• 草稿箱发布：/cgi-bin/draft/add
• 草稿管理（drafts.py）
• 批量获取草稿、获取详情、删除草稿
• 将草稿提交发布（发布草稿 / freepublish_submit）
• 拉取源公众号草稿并同步到其它公众号（clone）
• 评论管理（comments.py）
• 查询评论、开启/关闭评论、精选/取消精选、回复/删除回复、删除评论
• 用户管理（users.py）
• 黑名单列表、批量拉黑、批量取消拉黑（batchunblacklist）
• 关注者 openid 列表（分页）、用户基本信息
• 数据统计（stats.py）
• 常用 datacube 接口：群发、阅读、分享、用户增减等

> 安全说明：涉及本地文件读取的参数（例如 md_path、html_path、css_path、cover_path）默认只允许当前工作目录及子目录下的相对路径，禁止绝对路径与 .. 目录穿越。

与 jisu-wechat-article 配合使用

可以将 jisu-wechat-article 作为“选题与素材入口”，再用本技能完成公众号发布与运营。

推荐流程：

1. 用 jisu-wechat-article 搜索文章，拿到标题、摘要、发布时间、来源公众号、链接；
2. 基于搜索结果整理选题与文案（必要时在浏览器打开链接确认真实文章页）；
3. 用本技能 publish.py 发到草稿箱，再通过 drafts.py/comments.py/users.py/stats.py 完成后续运营。

相关链接：

• jisu-wechat-article（ClawHub）：<https://clawhub.ai/jisuapi/jisu-wechat-article>

依赖安装

pip install requests markdown pillow

> 安全提示：以下环境变量中，WECHAT_MP_APP_SECRET、WECHAT_MP_ACCOUNTS、WECHAT_MP_COOKIE 均可能包含敏感凭据。
> 请遵循最小权限原则，仅在确有需要时设置；避免写入公开日志、截图或仓库。

单公众号（默认）

# Windows PowerShell
$env:WECHAT_MP_APP_ID="你的AppID"
$env:WECHAT_MP_APP_SECRET="你的AppSecret"
$env:WECHAT_MP_DEFAULT_AUTHOR="作者名（可选）"

多公众号同步（推荐）

用 WECHAT_MP_ACCOUNTS 传 JSON 数组：

# Windows PowerShell
$env:WECHAT_MP_ACCOUNTS='[
  {"name":"公众号A","appid":"xxx","secret":"yyy"},
  {"name":"公众号B","appid":"xxx2","secret":"yyy2"}
]'

其它可选环境变量（含敏感项）

• WECHAT_MP_COOKIE（可选，敏感）：用于抓取受登录态影响的 html_url / cover_url 页面资源（也可在请求体里传 html_url_cookie / cover_url_cookie 覆盖）。
• WECHAT_MP_DEFAULT_AUTHOR（可选，低敏）：发文时未显式传 author 时的默认作者名。
• WECHAT_MP_ACCOUNTS（可选，高敏）：多公众号模式下的账号数组，包含多组 appid/secret，建议仅在隔离环境配置并妥善管理。

脚本路径

脚本文件：

• skills/wechat-mp/publish.py（发文到草稿）
• skills/wechat-mp/drafts.py（草稿管理）
• skills/wechat-mp/comments.py（评论管理）
• skills/wechat-mp/users.py（用户管理）
• skills/wechat-mp/stats.py（数据统计）

使用方式

按脚本分别调用（每个脚本都有自己的子命令）。

发文到草稿（publish.py）

Windows（PowerShell）强烈推荐：用 @file 方式传 JSON

在 Windows PowerShell 下，直接把 JSON 写在命令行里很容易遇到：
- 中文变成 ????（管道/控制台编码导致不可逆丢字）
- JSON 转义/引号问题（导致解析失败）

推荐把请求参数保存成一个 UTF-8 的 JSON 文件，然后用 @文件路径 传入（脚本会读取该文件内容作为请求体）：

# 1) 保存请求 JSON（注意用 UTF-8 保存）
# out\req.json 示例：
# {
#   "title": "标题",
#   "digest": "摘要",
#   "html_path": "article.html",
#   "debug_html_out": "out\\debug-final.html",
#   "dry_run": 1
# }

# 2) 用 @file 模式执行（最稳）
python skills\wechat-mp\publish.py draft @out\req.json

0) 直接从网络地址抓取 HTML（html_url）

当你不想先手动下载网页时，可以直接传 html_url。脚本会下载网页 HTML，自动提取 <body> 作为正文，并把 <head><style> 合并后做 inline（可配合 inline_css/strip_class）。
对于 mp.weixin.qq.com 链接，默认会优先提取页面里的 id="js_content" 正文（可显著降低体积，减少 45002 content size out of limit）。

python skills\wechat-mp\publish.py draft @out\req.json

out\req.json 示例：

{
  "title": "标题",
  "html_url": "https://mp.weixin.qq.com/s/IRNhW6etkGIBkCQ7g5Y7HQ",
  "debug_html_out": "out\\debug-final.html",
  "dry_run": 1
}

如果目标页面需要登录态，可设置环境变量 WECHAT_MP_COOKIE，或在请求里传 html_url_cookie。
如果页面体积较大，可能需要传 html_url_max_bytes 提高下载上限（默认 2.5MB），例如 8000000。

0.1) 正文提取（公众号 / 网易 / 新浪 / 今日头条）

当你使用 html_url 或 html_path 输入网页时，可以通过 content_selector 精确提取正文区域（取该节点的 innerHTML）：

• 公众号文章（通常直接用 body）：
• 可不传 content_selector，默认提取 <body>（如果你有明确容器，也可手动指定）
• 网易文章：
• 常用："content_selector": "div.post_body"
• 新浪文章：
• 常用："content_selector": "div.article"
• 今日头条：
• 常用："content_selector": "article"

示例（网易）：

{
  "title": "标题",
  "html_url": "https://www.163.com/tech/article/KOAS9OQJ00098IEO.html?clickfrom=w_tech",
  "content_selector": "div.post_body",
  "dry_run": 1,
  "debug_html_out": "out/debug-163.html"
}

示例（新浪）：

{
  "title": "标题",
  "html_url": "https://k.sina.com.cn/article_1644114654_61ff32de0200249su.html?from=news&subch=onews",
  "content_selector": "div.article",
  "dry_run": 1,
  "debug_html_out": "out/debug-sina.html"
}

补充：
- content_selector 依赖 beautifulsoup4（pip install beautifulsoup4）
- auto_content_selector 默认开启时，会按常见站点尝试默认 selector（网易 div.post_body、新浪 div.article、今日头条 article）

1) Markdown 文件 → HTML → 草稿

python3 skills/wechat-mp/publish.py draft '{
  "title": "我的文章标题",
  "digest": "一句话摘要（建议填写）",
  "md_path": "article.md"
}'

2) 传入 Markdown 内容（不落盘）

python3 skills/wechat-mp/publish.py draft '{
  "title": "标题",
  "md_content": "# Hello\n\n正文…"
}'

3) 美化样式：直接传 css 或从网页抓样式

python3 skills/wechat-mp/publish.py draft '{
  "title": "标题",
  "md_path": "article.md",
  "css": "h1{color:#1677ff} .wechatmp-article{font-size:16px}",
  "style_url": "https://example.com"
}'

说明：
- style_url 仅抓取页面中的 <style>...</style>，不会自动拉取外链 CSS（轻量实现，避免过度复杂）。

4) 封面图：用户指定优先（可回退 og:image）

• 优先使用用户提供：cover_path / cover_base64 / cover_url 三选一。
• 若三者都不传，且你提供的 html_url / html_path 含 <meta property="og:image" ...>，默认会自动把 og:image 作为封面（可通过 auto_cover_from_og_image=0 关闭）。
• 不再自动生成本地封面图。
• 指定本地封面：

python3 skills/wechat-mp/publish.py draft '{
  "title": "标题",
  "md_path": "article.md",
  "cover_path": "assets/cover.png"
}'

• 直接传 base64：

python3 skills/wechat-mp/publish.py draft '{
  "title": "标题",
  "md_path": "article.md",
  "cover_base64": "<base64_string>",
  "cover_out": "out/cover.png"
}'

• 指定封面 URL（会下载后上传永久素材）：

python3 skills/wechat-mp/publish.py draft '{
  "title": "标题",
  "md_path": "article.md",
  "cover_url": "https://example.com/cover.jpg",
  "cover_out": "out/cover_from_url.jpg"
}'

请求参数（draft）

返回结果

成功时会返回每个公众号创建的草稿 draft_media_id（以及封面 thumb_media_id），例如：

{
  "ok": true,
  "title": "我的文章标题",
  "cover": "out/wechatmp-cover.png",
  "accounts": [
    {"account":"公众号A","ok":true,"draft_media_id":"xxx","thumb_media_id":"yyy"}
  ]
}

评论管理（comments.py）

脚本文件：skills/wechat-mp/comments.py

> 说明：评论接口通常需要 msg_data_id 与 index 等字段（来自图文消息数据）。你可以先在公众号后台或其它流程中拿到这些 id。

查询评论列表（list）

python3 skills/wechat-mp/comments.py list '{
  "msg_data_id": 123,
  "index": 0,
  "begin": 0,
  "count": 20,
  "type": 0
}'

开启/关闭评论（open/close）

python3 skills/wechat-mp/comments.py open  '{"msg_data_id":123,"index":0}'
python3 skills/wechat-mp/comments.py close '{"msg_data_id":123,"index":0}'

精选/取消精选（mark/unmark）

python3 skills/wechat-mp/comments.py mark   '{"msg_data_id":123,"index":0,"user_comment_id":1}'
python3 skills/wechat-mp/comments.py unmark '{"msg_data_id":123,"index":0,"user_comment_id":1}'

回复/删除回复（reply_add/reply_delete）

python3 skills/wechat-mp/comments.py reply_add '{
  "msg_data_id": 123,
  "index": 0,
  "user_comment_id": 1,
  "content": "谢谢关注～"
}'
python3 skills/wechat-mp/comments.py reply_delete '{"msg_data_id":123,"index":0,"user_comment_id":1}'

删除评论（delete）

python3 skills/wechat-mp/comments.py delete '{"msg_data_id":123,"index":0,"user_comment_id":1}'

数据统计（stats.py）

脚本文件：skills/wechat-mp/stats.py

支持常用 datacube 统计接口（均需传 begin_date / end_date，格式 YYYY-MM-DD）：

• articlesummary → getarticlesummary
• articletotal → getarticletotal
• userread → getuserread
• usershare → getusershare
• usercumulate → getusercumulate

示例：

python3 skills/wechat-mp/stats.py articlesummary '{"begin_date":"2026-03-01","end_date":"2026-03-01"}'
python3 skills/wechat-mp/stats.py userread       '{"begin_date":"2026-03-01","end_date":"2026-03-07"}'

用户管理（users.py）

脚本文件：skills/wechat-mp/users.py

> 权限：黑名单相关接口在官方文档中为仅认证订阅号/服务号；每次拉黑/取消拉黑最多 20 个 openid。
> 取消拉黑文档：batchUnblacklist（POST /cgi-bin/tags/members/batchunblacklist）。

获取黑名单（分页）（blacklist_get）

python3 skills/wechat-mp/users.py blacklist_get '{"begin_openid":""}'

返回中含 data.openid、next_openid 等时，下一页把 next_openid 填入 begin_openid 再请求。

批量拉黑（blacklist_add）

python3 skills/wechat-mp/users.py blacklist_add '{"openid_list":["oXXX","oYYY"]}'

批量取消拉黑（blacklist_remove）

python3 skills/wechat-mp/users.py blacklist_remove '{"openid_list":["oXXX"]}'

（子命令 batch_unblacklist 与 blacklist_remove 等价。）

用户基本信息（user_info）

python3 skills/wechat-mp/users.py user_info '{"openid":"oXXX","lang":"zh_CN"}'

关注者列表（user_list）

python3 skills/wechat-mp/users.py user_list '{"next_openid":""}'

首张可传空 next_openid；若返回 next_openid，可继续传入拉取后续页。

PowerShell 建议用 @文件 传入 JSON，例如：python skills\wechat-mp\users.py blacklist_remove @out\req.json。

草稿管理（drafts.py）

脚本文件：skills/wechat-mp/drafts.py

批量获取草稿列表（list）

python3 skills/wechat-mp/drafts.py list '{"offset":0,"count":20,"no_content":1}'

获取草稿详情（get）

python3 skills/wechat-mp/drafts.py get '{"media_id":"xxx"}'

删除草稿（delete）

python3 skills/wechat-mp/drafts.py delete '{"media_id":"xxx"}'

发布草稿（publish）

> 调用接口：POST /cgi-bin/freepublish/submit（官方文档：发布草稿）。
> 将草稿箱中指定 media_id 的图文提交发布。接口返回成功仅表示任务已提交；真正发布完成是异步的，结果可能通过公众平台配置的回调收到 PUBLISHJOBFINISH 事件。
> 权限：订阅号需认证；服务号可用。若报错 48001 等请核对账号接口权限。

python3 skills/wechat-mp/drafts.py publish '{"media_id":"DRAFT_MEDIA_ID"}'

多账号配置时，会对每个公众号各自调用一次（各号草稿 media_id 不同；仅对当前号有效的 media_id 会成功）。

拉取草稿并同步到其它公众号（clone）

> 适合“把 A 公众号已在草稿箱的内容，复制到 B/C 公众号草稿箱”场景。
> 脚本会先读取源草稿，再把每篇文章的 thumb_url 下载并上传到目标公众号，最后调用目标号 draft/add。

python3 skills/wechat-mp/drafts.py clone '{
  "media_id": "SOURCE_DRAFT_MEDIA_ID",
  "source_account": "公众号A",
  "target_accounts": ["公众号B","公众号C"]
}'

参数说明：
- media_id：源草稿 media_id（必填）
- source_account：源公众号名称（多账号时必填；单账号可省略）
- target_accounts：目标公众号名称数组（可省略；省略时默认同步到除源号外所有账号）
- cover_url_cookie：下载封面图（thumb_url）时使用的 Cookie（可选）
- cover_url_max_bytes：下载封面图最大字节数，默认 5000000

查询草稿箱开关状态（switch_status）

> 检查公众号草稿箱功能是否已开启。返回 is_open：0=关闭，1=开启。

python3 skills/wechat-mp/drafts.py switch_status

返回示例：

{
  "ok": true,
  "command": "switch_status",
  "accounts": [
    {"account":"公众号A","ok":true,"is_open":1,"is_open_desc":"开启"}
  ]
}

后续规划

后续还可以继续在同目录扩展：

• materials.py：素材管理（图片/视频等）
• drafts.py：可补充发布状态查询（如 freepublish/get）等

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

• 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
• 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
• 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
• 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
• 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
• 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。