Wx Mp Engagement
Apps & Automationwx-mp-engagementWx Mp Engagement is an Agent Skill for apps & automation published in the TeamWiseFlow/xiaobei repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
微信公众号 engagement 数据抓取。通过 camoufox-cli 跑创作者中心拿已发布文章的阅读数 / 点赞数 / 评论数 / 分享数 / 收藏数,写入 published-track的 pub_wx_mp 表。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/TeamWiseFlow/xiaobei/blob/HEAD/crews/main/skills/wx-mp-engagement/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/wx-mp-engagement, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
微信公众号 Engagement 抓取
通过 camoufox-cli + 与 wx-mp-hunter 共用的 wx_mp 持久化 session + 创作者中心列表页爬虫 替换 published-track MANUAL_PLATFORMS 中 wx_mp 的"手动填"。不碰 relay(凭据是会话 token,relay 持有无益)。
思路:创作者中心后台的「发表记录」页面把每篇已发布文章的阅读/点赞/评论/分享/收藏列在行内,走「发表记录页 -> 解析 innerText -> 按标题匹配 -> 提行内数字」,不需要打开单篇分析页。
限制:仅支持用户自己有后台权限的号(创作者中心用公众号账号登录)。竞品号拿不到--这是产品约束,不是技术约束。
前置条件
1. wx_mp session 探活 + 失效重登(走 wx-mp-hunter,不走 login-manager)
wx-mp-engagement 与 wx-mp-hunter 共用 camoufox 持久化 session wx_mp(靠 session 名约定共享同一 profile 目录与登录态)。探活/登录/导出 cookie+UA+token 落中央存储 全由 wx-mp-hunter 负责。
# 探活
wx-mp-hunter check
# 失效后:camoufox 扫码登录
wx-mp-hunter login # camoufox 无头截 QR PNG 落 /tmp/qr-wx-mp.png
# (发 QR PNG 给用户 -> 用户扫码后 -> 主会话回复"已扫码")
wx-mp-hunter login-confirm # 验登录就位 + 导出 cookie+UA+token 落中央存储
退出码:
0有效2失效 -> 走 wx-mp-hunter login + login-confirm
wx-mp-engagement 不吃 cookie——只走 camoufox-cli 操作浏览器,wx_mp session profile 里登录态已就位即可。中央存储的 cookie+UA+token 仅供 wx-mp-hunter 的脚本业务命令(search/account-posts/fetch)用。
2. published-track DB 已就位
ls ~/.openclaw/workspace-main/db/published_track.db
# 初始化(如未建)
~/.openclaw/workspace-main/skills/published-track/scripts/init-db.sh
CLI
# dump 创作者中心 DOM + 截图 + 解析出的文章列表 JSON
wx-mp-engagement probe
# 产物落在 ./wx-mp-engagement-probe/:01_center.png / 02_list.png / 02_list.html / 03_articles.json
# 列出后台所有文章 + 行内 metrics
wx-mp-engagement list
# 抓单篇(按 row.title 在列表页匹配)
wx-mp-engagement fetch --row-id <pub_wx_mp.id>
# 批量抓取最近 N 天未更新(reads=0)的所有 wx_mp 记录
wx-mp-engagement fetch-all --days 7
退出码:
0成功1通用错误(参数错 / row 找不到 / 标题未匹配)2session 失效(与 wx-mp-hunter / fetch-and-update-metrics 呑约一致)
工作流程
关键发现(2026-07-09)
-
发表记录页 URL:
https://mp.weixin.qq.com/cgi-bin/appmsgpublish?sub=list&begin=0&count=20&token=<TOKEN>&lang=zh_CN- 不是
appmsg?action=list(那是草稿箱) - 必须带 token 参数,否则显示"请重新登录"
- 不是
-
Token 来源:wx-mp-hunter
login-confirm登录就位后已从 redirect URL 提 token 并合写进中央存储~/.openclaw/logins/wx_mp.json的token字段(见 wx-mp-hunter SKILL.md「第 4 步」)——本 skill fetch 流程里拼发表记录页 URL 用的 token 从该中央存储读,不在现场重开首页重定向提。token 与 cookie/UA 同源同时导出,失效则一并失效(checkexit 2 → 走 wx-mp-hunter 重登流)。 -
Cookie 导入禁忌:⚠️ 严禁
camoufox-cli cookies import造会话(浏览器方案严禁 cookie 导入)。本 skill 与 wx-mp-hunter 共用wx_mp持久化 session(靠 session 名约定共享同一 profile 目录与登录态),camoufox-cli 命令统一--session wx_mp --persistent,登录态在 session profile 里已就位,不开独立 session、不 import cookie。撞 fail-first 队列(同 session 正被占用)就等占用方完成再串行接力,不自动 close 正在跑的 session。 -
数据提取方式:不依赖 selector,直接用
document.body.innerText解析。页面 innerText 结构清晰:06月30日 已发表 文章标题 转载/原创/视频号 <阅读数> <赞> <评论> <分享> <收藏> <在看?> <额外?>
fetch 流程
1. wx-mp-hunter check
├─ exit 2 -> 退出(调用方触发 wx-mp-hunter login + login-confirm)
└─ exit 0 -> 继续
2. lookup_published_row(row_id) -> 拿 title / publish_url
3. 复用 wx_mp 持久化 session(不开独立 session、不 import cookie):
camoufox-cli --session wx_mp --persistent --json open "https://mp.weixin.qq.com/"
4. 读 redirect URL 拿 token(open 首页自动重定向到 /cgi-bin/home?...&token=xxx):
camoufox-cli --session wx_mp --json url
(也可从中央存储 wx_mp.json 的 token 字段读;session 内实时拿更稳,token 与 session 同寿命)
5. camoufox-cli --session wx_mp --persistent --json open "https://mp.weixin.qq.com/cgi-bin/appmsgpublish?sub=list&begin=0&count=20&token=<TOKEN>&lang=zh_CN" -> 发表记录页
6. camoufox-cli --session wx_mp --json eval <innerText 解析 JS> -> [{title, metrics}, ...]
7. match_article(rows, row.title) -> 按标题归一化匹配
8. update-metrics.sh --platform wx_mp --id <row_id> ... -> 写 pub_wx_mp
9. finally: 不主动 close(wx_mp 持久化 session 留下次用;fail-first 队列里别的命令接力)
输出 JSON 示例
{
"ok": true,
"row_id": 42,
"title": "测试文章",
"publish_url": "https://mp.weixin.qq.com/s?__biz=xxx&mid=123",
"session": "wx_mp",
"metrics": {
"reads": 576,
"likes": 10,
"comments": 16,
"shares": 6,
"favorites": 1
},
"update": {"ok": true, "action": "updated"}
}
与 published-track 集成
wx_mp 的互动数据抓取不走 fetch-and-update-metrics.sh——后者只管 xhs/bilibili/douyin/kuaishou 四个纯 HTTP+cookie 平台(login-manager 探活 → fetch-retro-data.ts → update-metrics.sh)。wx_mp 走 camoufox 抓创作者中心,机制完全不同,由本 skill 独立承担,agent 直调本 skill wrapper:
wx-mp-engagement fetch --row-id <rowid>
本 skill 内部流程:
wx-mp-hunter check探活 wx_mp session(exit 2 = 失效,退出由调用方按心跳规则跳过 + 报告)- camoufox-cli 抓创作者中心发表记录页
- 解析 innerText 按标题匹配拿 metrics
- 调
./skills/published-track/scripts/update-metrics.sh --platform wx_mp --id <rowid> ...写 pub_wx_mp
update-metrics.sh是 published-track 的纯写库脚本,本 skill 写库就走它(不经过 fetch-and-update-metrics.sh)。fetch-and-update-metrics.sh收到--platform wx_mp会直接 exit 1 报错提示走本 skill,两条链路独立、不耦合。
修改点:
fetch-and-update-metrics.sh:MANUAL_PLATFORMS已移除wx_mp(保留wx_channel,本 skill 不覆盖视频号);wx_mp 不再走该脚本任何分支,直调本 skill
约束
- 浏览器方案:camoufox-cli 主推;不 fork;不 bake chromium
- 并发:与 wx-mp-hunter 共用
wx_mp持久化 session(同名约定),fail-first 队列串行接力,不自动 close 正在跑的 session - 整块 client 容器内闭环(不碰 relay)
- 凭据边界:本 skill 只用浏览器 session token;不动
wx-mp-publisher的 AppID/AppSecret
Pitfalls
pitfall: 创作者中心 DOM 改版
- 症状:innerText 解析返回空或数据错位
- workaround:跑
probe命令检查02_list.html确认页面结构,调整解析逻辑
pitfall: 抓取频限封号
- 症状:突然 403 / 风控页
- workaround:严格节流--每公众号每天 ≤ 1 次全量;违规立即降级到 manual update
pitfall: 公众号文章未到 24h 无阅读数
- 症状:阅读数 0(实际是未刷新)
- workaround:不报错,记 0;T+1d 重抓(fetch-all 自动覆盖)
pitfall: token 过期
- 症状:列表页显示"请重新登录"
- workaround:token 与 wx_mp session 同寿命,失效则
wx-mp-hunter checkexit 2 → 走 wx-mp-hunterlogin+login-confirm重登流(重登后 token 随 cookie+UA 一并重新导出落中央存储),再用新 token 拼列表页 URL
pitfall: 列表页 URL 必须带 token
- 症状:不带 token 的 URL 显示"请重新登录"
- workaround:从中央存储
~/.openclaw/logins/wx_mp.json的token字段读,或在wx_mpsession 内open 首页 + url实时拿 redirect URL 里的 token,再拼列表页 URL
Notes
- 限频建议:单公众号每 24h 全量 ≤ 1 次;单篇按需触发
- 失败兜底:本 skill 跑不通时回退到 manual update(
update-metrics.sh --reads ... --likes ... --comments ...手动填) - camoufox-cli 注意:本 skill 全部命令统一
--session wx_mp --persistent(复用与 wx-mp-hunter 共享的持久化 session),headless 是默认行为;token 从 session 内 redirect URL 实时拿或从中央存储wx_mp.json的token字段读