js-wechat-mp-ops-skill

name	js-wechat-mp-ops-skill
description	微信公众号后台分析只读 skill，覆盖"用户分析 + 图文（内容）分析"两个板块。
version	0.5.0
metadata	{"openclaw":{"emoji":"📊","homepage":"https://github.com/imjszhang/js-eyes","requires":{"skills":["js-eyes"],"bins":["node"]},"platforms":["mp.weixin.qq.com"]}}

js-wechat-mp-ops-skill

面向微信公众号后台 mp.weixin.qq.com 的只读分析 skill。首版覆盖：

• 用户分析（/misc/useranalysis）：用户增长 + 用户属性
• 内容分析（/misc/appmsganalysis）：近期图文列表 + 单篇图文详情

和 js-wechat-ops-skill 形成 reader / author backend 互补：

• js-wechat-ops-skill：阅读者视角，读 mp.weixin.qq.com/s/<id> 文章页
• js-wechat-mp-ops-skill：作者后台视角，读 mp.weixin.qq.com/misc|cgi-bin/... 分析页

两者职责分明、并存不合并。

依赖与前置

• JS Eyes Server：已启动 (js-eyes server start)
• 浏览器扩展：已安装并连上 server
• 登录态：浏览器里已经人工登录公众号后台（扫码登录；本 skill 不做任何扫码自动化）
• 已打开目标分析页：调用前至少打开下列之一：
  • https://mp.weixin.qq.com/misc/appmsganalysis?...（内容分析）
  • https://mp.weixin.qq.com/misc/useranalysis?...（用户分析）
• 双侧 allowRawEval：bridge 首次注入时会走一次 bot.executeScript(rawSource)，之后每次工具调用只执行 window.__jse_mp_*__.<method>()。
  • 宿主：~/.js-eyes/config/config.json 里 security.allowRawEval: true
  • 扩展：js-eyes 扩展 popup 里 Allow Raw Eval 打开
  • 少一侧会返回 RAW_EVAL_DISABLED。

安全红线（READ / INTERACTIVE / DESTRUCTIVE）

本 skill 的所有工具都会被归入以下三档之一。审计界线按「是否改微信侧业务数据」而非「是否触网」来划：

READ（默认档）

纯读，不改任何 DOM、不改 URL、不触发任何业务写操作。

• 走 DOM 读取（表格 / KPI 卡 / KPI 文本）
• 走 fetchCgiBin(path, params) 重放已有登录凭证的 GET XHR（仅取数据）
• 日常调用不触发 js_eyes_execute_script: confirm consent（除首次 bridge 注入）
• 工具：wechat_mp_user_overview / wechat_mp_user_attrs / wechat_mp_content_list / wechat_mp_content_list_all / wechat_mp_content_detail / wechat_mp_content_summary / wechat_mp_content_trend / wechat_mp_content_sources / wechat_mp_content_tables_dump

INTERACTIVE（v0.3+）

只改浏览器自己筛选态/导航，不改微信侧任何业务数据。实现硬约束：

• 只允许 location.assign(newUrl) 方式切换 URL / query，禁止模拟点击任何 DOM CTA
• 调用返回 {from, to, hint}，由调用方再 state() 做自校验
• skill.contract.js 里带 interactive: true / destructive: false 两个字段
• 工具：wechat_mp_content_navigate / wechat_mp_user_navigate

DESTRUCTIVE（永不做）

任何改微信侧业务数据、生成导出文件、触发订阅变化的操作，v0.1+ 一直不会做：

• 发文 / 删文 / 修改草稿 / 改菜单 / 改设置
• 关注 / 取关 / 拉黑 / 回复 / 删评
• 「下载数据明细」等导出 CTA（触发服务端生成文件）
• 任何扫码登录自动化 如果未来真的要做，将在 skill.contract.js 里把该工具标记 destructive: true，并要求调用方显式 --confirm 走 Safe Default Mode consent 流程。

提供的 AI 工具

档位	工具	页面	说明
READ	wechat_mp_user_overview	/misc/useranalysis?1=1	用户增长概况：每日新增/取消/净增关注 + 累计总数
READ	wechat_mp_user_attrs	/misc/useranalysis?action=attr	用户属性：性别/年龄/地域/终端（关注数 < 100 时返回 ready:false）
READ	wechat_mp_content_list	/misc/appmsganalysis?action=report	近期发表图文列表 + 阅读人数/占比 + msgid/publish_date
READ	wechat_mp_content_list_all	/misc/appmsganalysis?action=report	列表全量（不设 limit 默认）+ paginator 信息（总页/每页/总条数）
READ	wechat_mp_content_summary	/misc/appmsganalysis	子 tab + 日期范围 + 顶部 KPI 卡 + paginator 摘要（用于快速自检）
READ	wechat_mp_content_trend	/misc/appmsganalysis	走 get_article_stat_tendency_and_source：每日各场景 read_uv / share_uv（scene=9999 为合计）。v0.4 起支持可选 msgid / publishDate，端点会按单篇维度返回
READ	wechat_mp_content_sources	/misc/appmsganalysis	复用同一 XHR 的 all_article_stat_source.list：各来源渠道聚合。v0.4 起支持可选 msgid / publishDate
READ	wechat_mp_content_tables_dump	/misc/appmsganalysis	调试用：按表头 + 前 N 行 dump 当前页所有表格，便于踩点改版
READ	wechat_mp_content_detail	/misc/appmsganalysis?action=detailpage	单篇图文 KPI + 地域表 + v0.4 新增 charts 字段（9 张 Highcharts 全提取）：readTrend / readChannel / subscribeFunnel（阅读后关注漏斗）/ shareTrans（分享转化）/ shareTrend / shareChannel（分享去向）/ gender / age / map（地域）。全部走 SVG <text> 解析，不依赖私有 XHR
INTERACTIVE	wechat_mp_content_navigate	/misc/appmsganalysis	仅通过 location.assign 修改 URL 参数（切子 tab / 切日期 / 跳详情页）；绝不模拟点击。v0.4 起 action ∈ {report,all,detailpage}、front_type ∈ {空,without_notice}，传 download_summary_tendency 直接拒绝
INTERACTIVE	wechat_mp_user_navigate	/misc/useranalysis	v0.5 新增。仅通过 location.assign 切换 user-analysis 子 tab：action ∈ {attr,activity_analysis_page}，clear=true 回 "用户增长" 默认 tab；不模拟点击

全部工具都是 optional: true（按需加载），入参详见 skill.contract.js::TOOL_DEFINITIONS。

内部踩点 CLI（不进 skill.contract.js，仅供本仓库开发者排查）

下面两条只在 CLI 暴露、不暴露给 AI tool 列表，用于改版后定位 DOM 结构变化或抓 XHR 形态：

CLI	用途
node index.js content-detail-dump [--anchors] [--with-outer-html]	一次性 snapshot detailpage 上的关键 DOM 节点（[id*=js_] / <dl> / <table> / .data_list / [class*=card] / Highcharts 容器），输出 tag/class/role + text outline；--anchors 加锚点链接清单，--with-outer-html 顺带每节点首屏 outerHTML（仅本地调试用）
node index.js content-xhr-log [--filter <substr>]	读 performance.getEntriesByType('resource')，过滤 mp.weixin.qq.com/misc/appmsganalysis 命中条目，按 action 聚合并解析 querystring（最多 30 个参数），用来判断改版后端点是否新增

这两条不写 listener、不挂 hook，纯靠浏览器内置 buffer，可放心反复跑。

CLI

cd /Volumes/home_x/github/my/js-wechat-mp-ops-skill
npm install

# 通路 + 登录态 + bridge 注入 + probe + state 一站诊断
node index.js doctor

# 用户增长（默认 --page user-analysis）
node index.js user-overview --range 30d

# 用户属性
node index.js user-attrs

# v0.5：用户分析子 tab 导航（INTERACTIVE，仅改 URL）
node index.js user-navigate --to-action attr               # 切到"用户属性"
node index.js user-navigate --to-action activity_analysis_page  # 切到"常读用户分析"
node index.js user-navigate --clear                         # 回"用户增长" tab

# 近期图文列表
node index.js content-list --limit 10

# 单篇详情（先在浏览器里切到 detailpage URL；v0.4 起返回阅读时长 / 完读率 / 分享去向等）
node index.js content-detail 2247484081_1 2026-04-14

# v0.4：单篇维度的趋势 / 来源（在 trend 端点上加 msgid/publish_date）
node index.js content-trend --range 7d --msgid 2247484081_1 --publish-date 2026-04-14
node index.js content-sources --range 7d --msgid 2247484081_1 --publish-date 2026-04-14

# v0.4：内部踩点（仅本仓库开发者用）
node index.js content-detail-dump --anchors
node index.js content-xhr-log

# 也可通过 js-eyes 统一入口
js-eyes skill run js-wechat-mp-ops-skill doctor

架构概要

CLI / Tool call
  └── skill.contract.js  (createRuntime / TOOL_DEFINITIONS)
        └── lib/session.js  (connect → resolveTarget → ensureBridge → callApi)
              ├── lib/config.js         PAGE_PROFILES
              ├── lib/js-eyes-client.js BrowserAutomation (token-auth)
              └── bridges/*-bridge.js   + bridges/common.js (@@include)
                      └── DOM read | fetchCgiBin replay

Page profiles

profile	targetUrlFragment	bridgeGlobal	bridgePath
content-analysis	mp.weixin.qq.com/misc/appmsganalysis	__jse_mp_content__	bridges/content-analysis-bridge.js
user-analysis	mp.weixin.qq.com/misc/useranalysis	__jse_mp_user__	bridges/user-analysis-bridge.js

Bridge 热更新

每个 bridge 顶部维护 const VERSION = 'x.y.z'。session.ensureBridge() 会读当前 bridge 版本，不一致时重注。共享 helpers 写在 bridges/common.js，通过 // @@include ./common.js 在注入前内联（不是运行时 require），所以所有 helpers 仍然是纯浏览器 JS。

内存保护与大响应限制

bridge 注入后不注册事件监听器、定时器或 MutationObserver，只在 window.__jse_mp_*__ 上挂载当前版本 API。为避免页面上下文和浏览器扩展之间传递过大的对象，当前版本做了以下限制：

• detectToken() / detectFingerprint() 按当前 URL 缓存结果；fallback 扫描 inline script 时逐个短路匹配，不再拼接全部脚本文本。
• fetchCgiBin() 优先按 JSON 解析响应；非 JSON 响应只返回短文本摘要，避免把完整 HTML/文本跨进程传出。
• 列表、趋势、来源、详情表格和调试 dump 都有默认返回上限和最大上限；响应会附带 total* / returned* 字段说明是否被截断。
• content-list --range/--from/--to 不再返回完整 XHR 原始响应，只返回 tendencySummary，完整趋势数据请使用 content-trend / content-sources 的结构化结果。

为什么用 XHR 重放（v0.2+）

v0.1 主要靠 DOM（表格 + KPI 卡）。v0.2+ 在 bridges/common.js::fetchCgiBin 里重放 /misc/appmsganalysis 的 action=get_article_stat_tendency_and_source 接口拿趋势/来源。DOM 读不到的数据走 XHR；可以读到就优先 DOM。

detailpage 的 Highcharts：为什么走 SVG 文本而不是 XHR（v0.4 决策）

v0.4 规划阶段原本想给 detailpage 上 9 张 Highcharts 的数据走 XHR 重放，结论是端点数 = 0：

• Stage A 用 content-xhr-log 在 detailpage 完整加载 + 切 panel + 翻日期的全过程都没抓到任何额外的 appmsganalysis XHR（仅 get_article_stat_tendency_and_source 一个，已在 trend/sources 用）。
• Highcharts 11+ 实例没挂在 window.Highcharts.charts 上（多版本 ESM bundle），从 JS 侧拿不到原始数据。
• 数据是页面 SSR 阶段一次性嵌进 <svg> 里的——所以 v0.4 改成对每张图直接读 SVG 中的 <text> 节点，做 Highcharts 11 anti-aliasing 伪重复去重（mirrored / pairwise 两道判别），按 kind（read-channel / share-channel / gender / age / read-time / finish-rate / follow-after / share-dest 等）做语义结构化。

这样不依赖未声明的私有 XHR 端点，向前/向后兼容只受 SVG 类名 + 文本格式约束。

启用方式

1. cd /Volumes/home_x/github/my/js-wechat-mp-ops-skill && npm install
2. js-eyes skills link /Volumes/home_x/github/my/js-wechat-mp-ops-skill
   • 会追加到 ~/.js-eyes/config/config.json 的 extraSkillDirs
   • 会把 skillsEnabled["js-wechat-mp-ops-skill"] = true
3. js-eyes skills reload（OpenClaw 插件 300ms 内热载）
4. js-eyes skills list 应看到 Source: extra (/Volumes/home_x/github/my/js-wechat-mp-ops-skill)
5. 浏览器里登录公众号后台并打开目标分析页（否则 tool 返回 E_NO_TAB）
6. js-eyes doctor 确认整体安全态

卸载：js-eyes skills unlink /Volumes/home_x/github/my/js-wechat-mp-ops-skill

明确不做的事

这些是 skill 在任何版本都不会做的事（DESTRUCTIVE 档位），避免后续补能力时跑偏：

• 不模拟点击任何业务 CTA（发文 / 删文 / 改菜单 / 关注 / 拉黑 / 回复 / 删评）
• 不触发「下载数据明细」等服务端导出（哪怕只是点 CTA 不下载）
• 不尝试任何 POST / 写 XHR；fetchCgiBin 硬约束为 GET
• 不实现扫码登录自动化 / cookie 注入 / token 伪造
• 不使用未在浏览器里实际发生过的 XHR 端点；改版前先靠 DOM 兜底 + probe 侦察
• 不代替用户做决策性操作（例如批量跳转、连续 navigate 累计筛选状态）

路线图

• v0.2：视频号 / 菜单分析 / 流量来源（按同样模板增 profile + bridge）
• v0.2：接入 @js-eyes/skill-recording，给每次 tool 调用留调试记录
• v0.3：content-analysis 读全（summary / list-all / trend / sources / tables-dump）+ INTERACTIVE 档位的 navigateContent
• v0.4：detailpage 二级 panel 全展开（阅读时长/完读率/阅读后关注/分享去向/渠道占比/性别年龄）走 SVG 文本提取；trend/sources 加 msgid 维度；navigateContent 白名单校验 + front_type enum；download_summary_tendency 显式拒绝；新增内部踩点 CLI content-detail-dump / content-xhr-log
• v0.5（当前版本）：user-analysis 加 navigateUser INTERACTIVE 档位（切 attr / activity_analysis_page / clear 回增长，与 navigateContent 同模式，仅 location.assign）；CLI 抽出 runNavigate 公共流程；新增通用业务脚本 scripts/batch-detail.js（批量拉单篇详情）、scripts/aggregate-content.js（聚合详情产报表）
• v0.6：user-analysis 补齐 trend / sources；list-all 真分页实测；download_summary_tendency 加更显眼的黑名单提示
• 一直不会做：见「明确不做的事」

故障排查

现象	可能原因	处理
E_NO_TAB	浏览器没打开对应分析页	在浏览器里打开 /misc/appmsganalysis 或 /misc/useranalysis
RAW_EVAL_DISABLED	一侧 allowRawEval=false	宿主 config + 扩展 popup 都要开
not_logged_in	登录态判据失败（URL token 缺失 / URL 在 login path / 无 weui-desktop-page_base）	在浏览器里重新扫码登录
ready: false, reason: fans_lt_100	账号关注数 <100，后台未开放用户属性	后台原生限制，不是 bug
ready: false, reason: wrong_subtab	当前 URL 不在目标 action 子 tab	按 hint 提示的 URL 切换 tab
bridge 注入后仍 method_not_found	bridge VERSION 可能未 bump	改 bridge 后 bump VERSION，CLI 会自动重注