@wecode-ai/weibo-openclaw-plugin 2.2.7 → 2.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecode-ai/weibo-openclaw-plugin",
-  "version": "2.2.7",
+  "version": "2.2.8",
   "type": "module",
   "description": "OpenClaw Weibo DM channel plugin",
   "license": "MIT",

package/skills/manifest.json

@@ -1,6 +1,6 @@
 {
   "skills": {
-    "weibo-creator": "1.0.1",
+    "weibo-creator": "1.0.3",
     "weibo-cron": "1.0.4",
     "weibo-crowd": "1.0.5",
     "weibo-hot-search": "1.0.0",

package/skills/weibo-creator/SKILL.md

@@ -2,13 +2,14 @@
 name: weibo-creator
 description: |
   微博创作者数据工具。获取创作者中心的综合数据摘要，包含近30天阅读/发博/互动趋势、
-  近7天粉丝与铁粉数据、铁粉画像（分布/性别/年龄/地区/兴趣/来源）、近期热门博文详情
-  以及最近4周 V影响力榜周榜得分与排名数据。
-  当用户需要了解自己的创作数据、粉丝增长情况、内容表现或铁粉画像时激活；
+  近7天粉丝与铁粉数据、铁粉画像（分布/性别/年龄/地区/兴趣/来源）、粉丝画像（性别/年龄/地区/兴趣）、
+  近期热门博文详情、最近4周 V影响力榜周榜得分与排名、粉丝群运营数据以及近30天视频播放数据。
+  当用户需要了解自己的创作数据、粉丝增长情况、内容表现或铁粉/粉丝画像时激活；
   或当用户询问如何升级橙V/金V、距离升级还差多少、需要多长时间能达标时激活；
-  或当用户询问自己的 V榜排名、得分、与同领域博主对比、哪些方面需要提升时激活。
+  或当用户询问自己的 V榜排名、得分、与同领域博主对比、哪些方面需要提升时激活；
+  或当用户询问粉丝群运营情况、群活跃度、铁粉在群率、视频播放数据时激活。
 metadata:
-  version: "1.0.2"
+  version: "1.0.3"
 ---
 
 # 微博创作者数据工具
@@ -182,6 +183,118 @@ node scripts/weibo-creator.js summary --token=<token>
 
 ---
 
+### 8. 粉丝群汇总数据
+
+#### `data.groupSummary` — 粉丝群汇总数据
+
+包含群成员活跃、互动、铁粉在群率、人数变化（近7天趋势）及成员构成分布（T-1）。
+
+**近7日趋势字段**（每个字段均为数组，共7条，每条含 `date`（yyyyMMdd）和 `num`（指标值字符串））：
+
+| 字段 | 说明 |
+|------|------|
+| `speakCountTrend` | 发言人数近7日趋势 |
+| `openCountTrend` | 打开人数近7日趋势 |
+| `avgSpeakTrend` | 人均发言条数近7日趋势 |
+| `interactCountTrend` | 群成员互动量近7日趋势 |
+| `readCountTrend` | 群成员阅读量近7日趋势 |
+| `bigfanInRateTrend` | 铁粉在群率近7日趋势（%） |
+| `memberTotalTrend` | 群成员总数近7日趋势 |
+| `joinCountTrend` | 进群人数近7日趋势 |
+| `leaveCountTrend` | 退群人数近7日趋势 |
+
+**成员构成分布（T-1 当前值）**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `coreFanRate` | string | 铁粉百分比（%，如 "24.2"） |
+| `loveFanRate` | string | 真爱粉百分比（%，铁粉子分类） |
+| `otherBigFanRate` | string | 其他铁粉百分比（%，铁粉子分类） |
+| `otherFanRate` | string | 粉丝百分比（%） |
+| `nonFanRate` | string | 非粉百分比（%） |
+
+---
+
+### 9. 单个粉丝群活跃数据
+
+#### `data.groupDetails` — 单个粉丝群活跃数据列表（数组，每个群一条）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `gid` | string | 粉丝群 ID |
+| `name` | string | 粉丝群名称 |
+| `memberCount` | string | 群成员人数（近7日，T-1 当前值） |
+| `openCount` | string | 群内打开人数（近7日，T-1 当前值） |
+| `speakCount` | string | 群内发言人数（T-1 日） |
+| `avgSpeak` | string | 人均发言条数（T-1 日） |
+| `bigfanCount` | string | 群内铁粉人数（T-1 日） |
+
+---
+
+### 10. 近30天视频播放数据
+
+#### `data.videoSummary` — 视频播放汇总数据
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `trendLast30Days` | array | 近30天视频播放趋势（共30条，见下表） |
+| `last7Days` | object | 近7天视频汇总数据（见下表） |
+| `yesterday` | object | 昨日视频数据（含较前日增量，见下表） |
+
+**`trendLast30Days[]` — 每日视频数据**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `date` | string | 日期（格式：yyyy-MM-dd） |
+| `uploadCount` | number | 当日视频发布量 |
+| `playCount` | number | 当日视频播放量 |
+| `playDuraCount` | number | 当日视频播放时长（秒） |
+| `repostCount` | number | 当日视频转发量 |
+| `commentCount` | number | 当日视频评论量 |
+| `likeCount` | number | 当日视频点赞量 |
+
+**`last7Days` — 近7天汇总**（字段同 `trendLast30Days[]`，无 `date`）
+
+**`yesterday` — 昨日数据**（含以下额外增量字段）：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `uploadCountIncre` | number | 发布量较前日增量 |
+| `playCountIncre` | number | 播放量较前日增量 |
+| `playDuraCountIncre` | number | 播放时长较前日增量（秒） |
+| `repostCountIncre` | number | 转发量较前日增量 |
+| `commentCountIncre` | number | 评论量较前日增量 |
+| `likeCountIncre` | number | 点赞量较前日增量 |
+
+---
+
+### 11. 粉丝画像数据
+
+#### `data.fanPortrait` — 粉丝画像（截止昨日 T-1 的当前值）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `gender` | object | 粉丝性别分布：key 为 "男性"/"女性"，value 为百分比字符串 |
+| `age` | object | 粉丝年龄分布：key 为 "小于18"/"18-24"/"25-34"/"35-44"/"大于44"，value 为百分比字符串 |
+| `province` | object | 粉丝地区分布 TOP10：key 为省份名，value 为百分比字符串 |
+| `tags` | object | 粉丝兴趣分布：key 为兴趣标签，value 为百分比字符串 |
+| `fansPotential` | string | 昨日潜在粉丝量 |
+| `fansPotentialIncre` | number | 潜在粉丝较前日增量（可为负数） |
+| `fansTrans` | string | 昨日粉丝转化量 |
+| `fansTransIncre` | number | 粉丝转化较前日增量（可为负数） |
+| `bigvList` | array | 昨日新增大V关注列表（最多100个，见下表） |
+
+**`bigvList[]` — 大V用户信息**：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `uid` | string | 大V用户ID |
+| `screenName` | string | 大V昵称 |
+| `followersCountStr` | string | 大V粉丝数（格式化字符串，如 "123.4万"） |
+| `relation` | number | 关注关系：0=互未关注 / 1=对方关注我 / 2=我关注对方 / 3=互关 |
+
+---
+
 ## 使用示例
 
 ```bash
@@ -285,12 +398,15 @@ node scripts/weibo-creator.js help
 5. `topBlogs` 最多返回5条近期热门博文
 6. `rankDetails` 返回最近4次周榜数据；若用户尚未上榜或数据不足，可能少于4条
 7. `details` 中 `fullScore` 和 `avgScore` 为空字符串时表示该项无满分/均值数据
+8. `groupSummary` 和 `groupDetails` 仅在用户开通粉丝群功能后有数据；未开通时可能为 `null`
+9. `videoSummary` 仅在用户有视频发布记录时有数据；无视频时可能为 `null`
+10. `fanPortrait` 为截止昨日的当前值，非趋势数据；`bigvList` 最多返回100个大V
 
 ---
 
 ## 数据分析能力
 
-本技能在基础数据之上，提供以下加工数据和分析能力。当用户询问创作数据分析、金橙V升级、V榜排名等问题时，综合运用以下能力输出分析报告。
+本技能在基础数据之上，提供以下加工数据和分析能力。当用户询问创作数据分析、金橙V升级、V榜排名、粉丝群运营等问题时，综合运用以下能力输出分析报告。
 
 ---
 
@@ -466,9 +582,76 @@ node scripts/weibo-creator.js help
   ├ 被互动：  16.2 vs 均值 13.8 → 领先 17.4% ✅
   ├ 粉丝吸引：12.2 vs 均值 10.3 → 领先 18.4% ✅
   └ 主动活跃：16.0 vs 均值 14.5 → 领先 10.3% ✅
-
 总结：
   - 各维度全面领先同领域均值，整体表现优秀
   - 公域流量得分近4周进步最为显著，建议继续保持
   - 主动活跃度满分25分，当前得分16.0，仍有较大提升空间，建议增加发博频率
 ```
+
+---
+
+### 四、粉丝群数据分析
+
+若用户询问粉丝群运营情况、群活跃度、铁粉在群率等问题，请按以下步骤进行分析：
+
+#### 加工数据
+
+| 加工数据 | 计算方式 | 数据来源 |
+|----------|----------|----------|
+| 粉丝群发言人数占比 | 发言人数 ÷ 群成员总数 × 100% | `groupSummary.speakCountTrend` + `groupSummary.memberTotalTrend` |
+
+> **发言人数占比**越高，表明群越活跃，说明更多成员养成了在群内发言的习惯。
+
+#### 分析步骤
+
+**第一步：分析群成员总数趋势**
+
+从 `groupSummary.memberTotalTrend` 中按 `date` 升序排列（最旧 → 最新），对比首日与末日数值：
+- **增长**：末日 > 首日，说明群成员在扩大
+- **下降**：末日 < 首日，说明群成员在流失（结合 `joinCountTrend` 和 `leaveCountTrend` 分析原因）
+- **平稳**：差距 < 5%
+
+**第二步：分析群活跃度趋势**
+
+从 `groupSummary.speakCountTrend` 中分析发言人数近7日变化趋势，并计算每日**发言人数占比**（发言人数 ÷ 群成员总数）：
+- 占比越高，群越活跃
+- 结合 `openCountTrend`（打开人数）分析：打开人数高但发言人数低，说明用户有阅读习惯但互动意愿不足
+
+**第三步：分析铁粉在群率**
+
+从 `groupSummary.bigfanInRateTrend` 中分析铁粉在群率近7日变化趋势：
+- **铁粉在群率**越高，说明通过粉丝群运营铁粉越有效
+- 若铁粉在群率低，建议主动邀请铁粉加入粉丝群
+
+**第四步：分析各群详情（如有多个群）**
+
+从 `groupDetails` 中对比各群的 `memberCount`、`speakCount`、`bigfanCount`，找出最活跃的群和需要重点运营的群。
+
+**第五步：输出分析报告**
+
+报告包含：群成员总数趋势、群活跃度（发言人数及占比趋势）、铁粉在群率趋势、各群对比（如有多群）、运营建议。
+
+#### 示例输出
+
+```
+📊 粉丝群数据分析报告
+
+群成员总数趋势（近7日）：
+  05/08: 1,250人 → 05/14: 1,312人（+62人，增长 5.0%）✅
+  进群 85人，退群 23人，净增 62人
+
+群活跃度（近7日）：
+  发言人数：日均 42人，占比约 3.3%
+  打开人数：日均 186人，占比约 14.7%
+  → 打开率较高，但发言率偏低，建议增加互动话题引导发言
+
+铁粉在群率（近7日）：
+  05/08: 18.2% → 05/14: 21.5%（持续上升）✅
+  → 铁粉在群率稳步提升，粉丝群运营效果良好
+
+建议：
+  - 定期在群内发起话题讨论，提升发言人数占比
+  - 主动邀请铁粉加入粉丝群，进一步提升铁粉在群率
+  - 关注退群原因，减少群成员流失
+```
+```