weibo-creator

Files (3)

• SKILL.md
• creator-v-upgrade.md · references/
• weibo-creator.js · scripts/

SKILL.md (first lines)

# 微博创作者数据工具

本技能通过脚本 `scripts/weibo-creator.js` 调用创作者中心接口，一次性获取多维度创作数据摘要；并内置金橙V升级分析能力，可根据数据自动计算达标差距与策略规划。

## 脚本调用方式

```bash
node scripts/weibo-creator.js summary --token=<token>
```

**参数说明**：

| 参数 | 必填 | 说明 |
|------|------|------|
| `--token` | 是 | 微博 API 访问令牌，通过 `weibo_token` 工具获取 |

---

## 返回数据结构

接口路径：`GET /open/creator/summary`

返回的 `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条）

| 字段 | 类型 | 说明 |
|------|------|------|
| `date` | string | 日期（格式：yyyy-MM-dd） |
| `totalReadCount` | number | 当日总排水阅读数 |

#### `data.readSourceSummary30Days` — 近30日分场景阅读汇总

| 字段 | 类型 | 说明 |
|------|------|------|
| `followReadCount` | number | 关注流阅读数（私域流量） |
| `followReadRate` | string | 关注流阅读占比（%，如 "55.8"） |
| `profileReadCount` | number | 个人主页阅读数（私域流量） |
| `profileReadRate` | string | 个人主页阅读占比（%） |
| `searchReadCount` | number | 搜索阅读数（公域流量） |
| `searchReadRate` | string | 搜索阅读占比（%） |
| `hotReadCount` | number | 推荐阅读数（公域流量） |
| `hotReadRate` | string | 推荐阅读占比（%） |
| `othersReadCount` | number | 其他阅读数 |
| `othersReadRate` | string | 其他阅读占比（%） |

> 关注流 + 个人主页 = 私域流量；搜索 + 推荐 = 公域流量。

---

### 2. 近30天发博活跃数据

#### `data.postTrend30Days` — 每日发博趋势（数组，T-1 至 T-30，共30条）

| 字段 | 类型 | 说明 |
|------|------|------|
| `date` | string | 日期（格式：yyyy-MM-dd） |
| `statusCount` | number | 当日发博数 |

---

### 3. 近30天互动数据

#### `data.interactTrend30Days` — 每日互动趋势（数组，T-1 至 T-30，共30条）

| 字段 | 类型 | 说明 |
|------|------|------|
| `date` | string | 日期（格式：yyyy-MM-dd） |
| `repostCount` | number | 当日收到的转发数 |
| `commentCount` | number | 当日收到的评论数 |
| `likeCount` | number | 当日收到的点赞数 |

---

### 4. 近7天粉丝&铁粉数据

#### `data.fanTrend7Days` — 每日粉丝&铁粉趋势（数组，T-1 至 T-7，共7条）

| 字段 | 类型 | 说明 |
|------|------|------|
| `date` | string | 日期（格式：yyyy-MM-dd） |
| `fansTotal` | number | 当日粉丝总数（仅昨日有值，其余可能为 null） |
| `newFansCount` | number | 当日新增粉丝数 |
| `bigFanTotal` | number | 当日铁粉总数 |
| `newBigFanCount` | number | 当日新增铁粉数 |

---

### 5. 铁粉画像数据

#### `data.bigFanPortrait` — 铁粉画像（截止昨日 T-1 的当前值）

| 字段 | 类型 | 说明 |
|------|------|------|
| `pyramid` | object | 铁粉分布：key 为 "钻粉"/"金粉"/"铁粉"，value 为百分比字符串（如 "2.1"） |
| `gender` | object | 性别分布：key 为 "男性"/"女性"，value 为百分比字符串 |
| `age` | object | 年龄分布：key 为 "小于18"/"18-24"/"25-34"/"35-44"/"大于44"，value 为百分比字符串 |
| `province` | object | 地区分布 TOP5：key 为省份名，value 为百分比字符串 |
| `tags` | object | 兴趣分布 TOP5：key 为兴趣标签，value 为百分比字符串 |
| `source` | object | 来源场景 TOP5：key 为来源名称，value 为百分比字符串 |

---

From wecode-ai/openclaw-weibo, Apache-2.0.

More from wecode-ai/openclaw-weibo