weibo-adincentive

Files (2)

• SKILL.md
• weibo-adincentive.js · scripts/

SKILL.md (first lines)

# 微博激励计划数据工具

本技能通过脚本 `scripts/weibo-adincentive.js` 调用激励计划接口，一次性获取多维度激励计划数据摘要；并内置激励计划参与建议分析能力，可根据数据为博主推荐适合的计划并提供发博规划。

## 脚本调用方式

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

**参数说明**：

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

---

## 返回数据结构

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

返回的 `data` 字段为 `AdIncentiveSummary` 对象，包含以下维度：

### 0. 用户基本信息

#### `data.uid` — 用户 uid

#### `data.userLevel` — 用户认证等级

| 字段 | 类型 | 说明 |
|------|------|------|
| `userLevel` | string | 用户认证等级（如 "金V"、"蓝V"、"普通用户" 等） |

> `userLevel` 反映博主的认证身份，不同激励计划可能面向不同认证等级的创作者，推荐计划时需结合此字段判断博主是否符合计划的面向对象。

---

### 1. 在线激励计划列表

#### `data.plans` — 在线激励计划列表（来自 plans 接口）

| 字段 | 类型 | 说明 |
|------|------|------|
| `name` | string | 计划名称 |
| `desc` | string | 计划描述/规则简介 |
| `category` | string | 业务分类标识（hot/video/campus/cross/other） |
| `categoryName` | string | 业务分类中文名 |
| `prUrl` | string | 计划PR博文链接（详细了解规则的博文地址） |
| `hasRank` | boolean | 是否有高收益博文示例（周榜数据） |
| `tags` | array | 激励内容方向标签列表（PlanTag[]） |

#### `data.plans[].tags[]` — 激励内容方向标签

| 字段 | 类型 | 说明 |
|------|------|------|
| `name` | string | 方向标签名称 |

#### `data.totalPlans` — 在线激励计划总数

| 字段 | 类型 | 说明 |
|------|------|------|
| `totalPlans` | integer | 当前在线且在前端展示的激励计划总数 |

> 仅提供前端【展示】且【在线】的计划数据。

---

### 2. 计划高收益博文示例

#### `data.planRanks` — 计划高收益博文示例（来自 planrank 接口）

Map 结构，key 为整数标识，value 为该计划的榜单数据 `PlanRank` 对象。通过 `planName` 与 `plans` 中的计划关联。

#### `data.planRanks[<key>]` — 单个计划的榜单数据

| 字段 | 类型 | 说明 |
|------|------|------|
| `planName` | string | 计划名称 |
| `rankRule` | string | 高收益博文示例规则说明 |
| `prUrl` | string | 计划PR博文链接 |
| `period` | string | 当前示例周期（最新一周） |
| `categories` | array | 分类tab列表（RankCategory[]） |
| `blogs` | array | 高收益博文示例列表（RankBlog[]） |
| `totalInPage` | integer | 当前页博文数量 |
| `hasMore` | boolean | 是否有更多数据 |

#### `data.planRanks[<key>].categories[]` — 榜单分类tab

| 字段 | 类型 | 说明 |
|------|------|------|
| `cateId` | string | 分类ID |
| `name` | string | 分类名称 |

#### `data.planRanks[<key>].blogs[]` — 高收益博文示例

| 字段 | 类型 | 说明 |
|------|------|------|
| `mid` | string | 博文mid |
| `text` | string | 博文正文内容 |
| `topics` | array | 命中话题列表（string[]） |
| `category` | string | 所属类别/tab名称（若有） |
| `hasVideo` | boolean | 是否含视频 |

> 对用户无需强调是"周榜"，对用户称"计划高收益博文示例"即可。仅提供最新周数据。上榜博文信息包括博文内容、所属类别（tab，若有），**不给金额**。

---

### 3. 博主优质博文

#### `data.myBlogs` — 博主近7日高收益博文列表（来自 myblogs 接口）

| 字段 | 类型 | 说明 |
|------|------|------|
| `mid` | string | 博文mid |
| `text` | string | 博文正文内容 |
| `createTime` | string | 发博日期（格式：yyyy-MM-dd） |
| `topics` | array | 命中话题列表（string[]） |
| `hasVideo` | boolean | 是否含视频 |

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

More from wecode-ai/openclaw-weibo