@wecode-ai/weibo-openclaw-plugin 2.2.9 → 2.2.11

package/skills/weibo-adincentive/scripts/weibo-adincentive.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+
+/**
+ * 微博激励计划数据摘要脚本
+ *
+ * 使用方法:
+ *   node weibo-adincentive.js summary --token=<token>
+ *
+ * 命令:
+ *   summary    获取激励计划数据摘要（在线计划列表、计划高收益博文示例、博主优质博文）
+ *   help       显示帮助信息
+ */
+
+import https from 'https';
+import http from 'http';
+import { URL } from 'url';
+
+const BASE_URL = 'https://open-im.api.weibo.com';
+
+// ============================================================================
+// HTTP 请求
+// ============================================================================
+
+/**
+ * 发送 HTTP 请求
+ * @param {string} method - HTTP 方法
+ * @param {string} url - 请求 URL
+ * @param {object|null} data - 请求数据（POST 时使用）
+ * @returns {Promise<object>} 响应数据
+ */
+function request(method, url, data = null) {
+  return new Promise((resolve, reject) => {
+    const urlObj = new URL(url);
+    const isHttps = urlObj.protocol === 'https:';
+    const httpModule = isHttps ? https : http;
+
+    const options = {
+      hostname: urlObj.hostname,
+      port: urlObj.port || (isHttps ? 443 : 80),
+      path: urlObj.pathname + urlObj.search,
+      method: method,
+      headers: {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+      },
+    };
+
+    const req = httpModule.request(options, (res) => {
+      let body = '';
+      res.on('data', (chunk) => { body += chunk; });
+      res.on('end', () => {
+        try { resolve(JSON.parse(body)); }
+        catch (e) { reject(new Error(`解析响应失败: ${body}`)); }
+      });
+    });
+
+    req.on('error', (e) => { reject(e); });
+    if (data) req.write(JSON.stringify(data));
+    req.end();
+  });
+}
+
+// ============================================================================
+// API 函数
+// ============================================================================
+
+/**
+ * 获取激励计划数据摘要
+ *
+ * 返回结构（AdIncentiveSummary）包含：
+ *   - uid: 用户 uid
+ *   - userLevel: 用户认证等级（如"金V"、"蓝V"、"普通用户"等）
+ *   - plans: 在线激励计划列表（IncentivePlan[]）
+ *   - totalPlans: 在线激励计划总数
+ *   - planRanks: 计划高收益博文示例（Map<key, PlanRank>，通过planName与plans关联）
+ *   - myBlogs: 博主近7日高收益博文列表（MyBlog[]）
+ *
+ * @param {string} token - 认证令牌
+ * @returns {Promise<object>} 激励计划数据摘要
+ */
+async function getAdIncentiveSummary(token) {
+  const params = new URLSearchParams({ token });
+  const url = `${BASE_URL}/open/adincentive/summary?${params.toString()}`;
+  return request('GET', url);
+}
+
+// ============================================================================
+// 命令行参数解析
+// ============================================================================
+
+/**
+ * 解析命令行参数
+ * @param {string[]} args - 命令行参数
+ * @returns {object} 解析后的参数对象
+ */
+function parseArgs(args) {
+  const result = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith('--')) {
+      const [key, ...valueParts] = arg.slice(2).split('=');
+      const value = valueParts.join('=') || args[++i] || true;
+      result[key] = value;
+    }
+  }
+  return result;
+}
+
+// ============================================================================
+// 帮助信息
+// ============================================================================
+
+function printHelp() {
+  console.log(`
+微博激励计划数据摘要脚本
+
+使用方法:
+  node weibo-adincentive.js <command> [options]
+
+命令:
+  summary    获取激励计划数据摘要
+  help       显示帮助信息
+
+选项:
+  --token=<token>    微博 API 访问令牌（必填，通过 weibo_token 工具获取）
+
+示例:
+  node weibo-adincentive.js summary --token=<your_token>
+
+返回数据说明:
+  data.uid                       用户 uid
+  data.userLevel                 用户认证等级（如"金V"、"蓝V"、"普通用户"等）
+  data.plans                     在线激励计划列表
+    .name                        计划名称
+    .desc                        计划描述/规则简介
+    .category                    业务分类标识（hot/video/campus/cross/other）
+    .categoryName                业务分类中文名
+    .prUrl                       计划PR博文链接
+    .hasRank                     是否有高收益博文示例（周榜数据）
+    .tags[]                      激励内容方向标签列表
+      .name                      方向标签名称
+  data.totalPlans                在线激励计划总数
+  data.planRanks                 计划高收益博文示例（Map结构，通过planName与plans关联）
+    .<key>.planName              计划名称
+    .<key>.rankRule              高收益博文示例规则说明
+    .<key>.prUrl                 计划PR博文链接
+    .<key>.period                当前示例周期（最新一周）
+    .<key>.categories[]          分类tab列表
+      .cateId                    分类ID
+      .name                      分类名称
+    .<key>.blogs[]               高收益博文示例列表
+      .mid                       博文mid
+      .text                      博文正文内容
+      .topics[]                  命中话题列表
+      .category                  所属类别/tab名称
+      .hasVideo                  是否含视频
+    .<key>.totalInPage           当前页博文数量
+    .<key>.hasMore               是否有更多数据
+  data.myBlogs                   博主近7日高收益博文列表
+    .mid                         博文mid
+    .text                        博文正文内容
+    .createTime                  发博日期（Y-m-d）
+    .topics[]                    命中话题列表
+    .hasVideo                    是否含视频
+    .matchedPlans[]              命中的激励计划列表
+      .name                      计划名称
+      .prUrl                     计划PR链接
+`);
+}
+
+// ============================================================================
+// 主函数
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const options = parseArgs(args.slice(1));
+
+  if (!command || command === 'help') {
+    printHelp();
+    return;
+  }
+
+  try {
+    let result;
+
+    switch (command) {
+      case 'summary': {
+        if (!options.token) {
+          console.error('需要指定 --token 参数，请先通过 weibo_token 工具获取');
+          process.exit(1);
+        }
+        result = await getAdIncentiveSummary(options.token);
+        break;
+      }
+
+      default:
+        console.error(`未知命令: ${command}`);
+        console.log('使用 "node weibo-adincentive.js help" 查看帮助信息');
+        process.exit(1);
+    }
+
+    console.log(JSON.stringify(result, null, 2));
+
+  } catch (error) {
+    console.error(`请求失败: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+// 导出函数供模块使用
+export {
+  getAdIncentiveSummary,
+};
+
+main();

package/skills/weibo-creator/SKILL.md

@@ -9,7 +9,7 @@ description: |
   或当用户询问自己的 V榜排名、得分、与同领域博主对比、哪些方面需要提升时激活；
   或当用户询问粉丝群运营情况、群活跃度、铁粉在群率、视频播放数据时激活。
 metadata:
-  version: "1.0.3"
+  version: "1.0.5"
 ---
 
 # 微博创作者数据工具
@@ -36,6 +36,20 @@ node scripts/weibo-creator.js summary --token=<token>
 
 返回的 `data` 字段为 `CreatorSummary` 对象，包含以下维度：
 
+### 0. 用户基本信息
+
+#### `data.uid` — 用户 uid
+
+#### `data.userLevel` — 用户认证等级
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `userLevel` | string | 用户认证等级（如 "金V"、"橙V"、"蓝V"、"黄V"、"普通用户" 等） |
+
+> `userLevel` 反映博主当前的认证身份，在金橙V升级分析中可直接用于判断当前状态，无需从其他数据推断。
+
+---
+
 ### 1. 近30天阅读数据
 
 #### `data.readTrend30Days` — 每日阅读趋势（数组，T-1 至 T-30，共30条）
@@ -219,15 +233,25 @@ node scripts/weibo-creator.js summary --token=<token>
 
 #### `data.groupDetails` — 单个粉丝群活跃数据列表（数组，每个群一条）
 
+**T-1 当前值字段**：
+
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `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 日） |
+| `genderRate` | object | 群内性别分布：key 为 "男"/"女"，value 为百分比整数字符串（如 "56"） |
+| `bigfanRate` | string | 铁粉占比（T-1 日，%） |
+| `loveFanRate` | string | 真爱粉占比（T-1 日，%） |
+
+**近7日趋势字段**（每个字段均为数组，共7条，每条含 `date`（yyyy-MM-dd）和 `num`（指标值字符串））：
+
+| 字段 | 说明 |
+|------|------|
+| `memberCountTrend` | 单个群成员人数近7日趋势 |
+| `openCountTrend` | 单个群打开人数近7日趋势 |
+| `speakCountTrend` | 单个群发言人数近7日趋势 |
+| `speakTimesTrend` | 单个群发言条数近7日趋势 |
+| `joinCountTrend` | 单个群进群人数近7日趋势 |
 
 ---
 
@@ -313,6 +337,7 @@ node scripts/weibo-creator.js help
   "message": "success",
   "data": {
     "uid": 1234567890,
+    "userLevel": "黄V",
     "readTrend30Days": [
       { "date": "2026-05-07", "totalReadCount": 12500 },
       { "date": "2026-05-06", "totalReadCount": 9800 }
@@ -463,8 +488,11 @@ node scripts/weibo-creator.js help
 
 **第一步：判断当前状态**
 
-- **已是黄V，尚未达到橙V**：铁粉数 < 100 或近30天排水阅读量 < 30 万
-- **已是橙V，尚未达到金V**：粉丝量 < 1 万 或 铁粉数 < 1000 或 近30天排水阅读量 < 1000 万
+根据 `userLevel` 字段直接判断当前认证等级：
+
+- **已是黄V，尚未达到橙V**：`userLevel` 为 "黄V"，且铁粉数 < 100 或近30天排水阅读量 < 30 万
+- **已是橙V，尚未达到金V**：`userLevel` 为 "橙V"，且粉丝量 < 1 万 或 铁粉数 < 1000 或 近30天排水阅读量 < 1000 万
+- **已是金V**：`userLevel` 为 "金V"
 
 **第二步：计算各项达标差距**
 
@@ -625,7 +653,7 @@ node scripts/weibo-creator.js help
 
 **第四步：分析各群详情（如有多个群）**
 
-从 `groupDetails` 中对比各群的 `memberCount`、`speakCount`、`bigfanCount`，找出最活跃的群和需要重点运营的群。
+从 `groupDetails` 中对比各群的 `bigfanRate`，以及 `speakCountTrend`、`memberCountTrend` 近7日趋势，找出最活跃的群和需要重点运营的群。
 
 **第五步：输出分析报告**
 

package/skills/weibo-creator/scripts/weibo-creator.js

@@ -69,6 +69,7 @@ function request(method, url, data = null) {
  *
  * 返回结构（CreatorSummary）包含：
  *   - uid: 用户 uid
+ *   - userLevel: 用户认证等级（如"金V"、"橙V"、"蓝V"、"黄V"、"普通用户"等）
  *   - readTrend30Days: 近30天每日阅读趋势（DailyReadData[]）
  *   - readSourceSummary30Days: 近30日分场景阅读汇总（ReadSourceSummary）
  *   - postTrend30Days: 近30天每日发博趋势（DailyPostData[]）
@@ -131,6 +132,7 @@ function printHelp() {
 
 返回数据说明:
   data.uid                      用户 uid
+  data.userLevel                用户认证等级（如"金V"、"橙V"、"蓝V"、"黄V"、"普通用户"等）
   data.readTrend30Days          近30天每日阅读趋势（date, totalReadCount）
   data.readSourceSummary30Days  近30日分场景阅读汇总
     .followReadCount / followReadRate   关注流阅读数/占比（私域）