# API接口与评分逻辑

## 接口请求

**请求方式**：POST
**请求地址**：https://redfox.hk/story/api/xhsUser/query

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| userIds | Array<String> | 否 | 小红书账号ID列表，与nicknames至少传一个 |
| nicknames | Array<String> | 否 | 小红书账号昵称列表，与userIds至少传一个 |

**请求体示例**：
```json
{
  "userIds": ["26112666886"],
  "nicknames": ["小美的生活"]
}
```

## 接口响应字段

### 账号数据

| 字段 | 说明 | 示例 |
|------|------|------|
| nickname | 账号名 | "小小希" |
| desc | 简介 | "准八 丨26届生地会考 丨27届中考定期搞福利🥺谢谢支持" |
| redId | 账号ID | "26112666886" |
| fans | 粉丝数 | 4431 |
| level | 官方等级（可为null） | 7 或 null |
| userAttribute | 账号标识 | "素人"/"尾部kol"/"腰部kol"/"头部kol"/"企业"/"品牌" |
| avatar | 头像URL | "https://..." |
| totalWork | 作品总数 | 127 |
| liked | 总点赞数 | 217035 |
| collected | 总收藏数 | 24745 |
| noteCountThirty | 近30天发作品数 | 70 |
| interactiveCountThirty | 近30天作品互动量 | 133547 |
| recentIndex | 周指数 | 827.32 |
| topProvinces | 粉丝省份偏向 | "广东" |
| topAges | 粉丝年龄偏向 | "<18" |
| fansGender | 粉丝性别偏向 | {"male_ratio": "0.13", "female_ratio": "0.87"} |
| gmtCreate | 数据获取时间 | "2025-04-22 10:30:00" |

### 作品数据（works数组，最多5篇）

| 字段 | 说明 | 示例 |
|------|------|------|
| id | 作品ID | "69e478b70000000021007e7b" |
| title | 作品标题 | "姚译添疯了" |
| createTime | 发布时间（毫秒时间戳） | "1776580791000" |
| likedCount | 点赞数 | 22 |
| collectedCount | 收藏数 | 0 |
| workUrl | 作品链接 | "https://www.xiaohongshu.com/..." |

### 相似账号数据（similarAccounts数组）

| 字段 | 兼容字段 | 说明 |
|------|---------|------|
| redId | accountId, userId | 账号ID |
| nickname | accountName, name | 账号名称 |
| fans | followerCount, fansCount | 粉丝数 |
| liked | totalLikeCount | 总点赞数 |
| interactiveCountThirty | interactiveCountThirty | 总互动数 |

## 评分计算逻辑

**综合评分（100分）** = 账号定位(10) + 粉丝画像与需求(15) + 选题体系(15) + 封面风格(10) + 爆文能力(15) + 互动规模(20) + 更新产能(15)

### 1. 账号定位（10分）

**粉丝数>5000的账号**（以夸赞为主）：
- 基础分6分（满分10）
- 有简介+1分，简介清晰+1分，内容垂直+1分，有差异化定位+1分
- 评分原则：肯定账号已有成就，在差异化优势中指出可优化的方向

**粉丝数≤5000的账号**：
- 基础分3分（满分10）
- 有简介+1分，简介清晰+2分，内容垂直+2分，有差异化定位+2分

### 2. 粉丝画像与需求（15分）

| 评估项 | 得分标准 |
|--------|---------|
| 基础分 | 5分 |
| 收藏率评估 | >30%得3分/>20%得2分/>10%得1分 |
| 粉丝画像集中度 | >70%或<30%得3分/>60%或<40%得2分 |
| 粉丝数规模 | ≥10w得4分/≥5w得3分/≥1w得2分/≥5000得1分 |

### 3. 选题体系（15分）

**核心逻辑：选题方向单一/聚焦是加分项，专注某一赛道深耕是好事**

| 评估项 | 得分标准 |
|--------|---------|
| 基础分 | 5分 |
| 选题方向聚焦度 | 高度聚焦(1-2方向)+4分/较为聚焦(3方向)+3分/有一定聚焦(4方向)+2分 |
| 标签统一度 | 固定栏目≤3个+3分/≤5个+2分/其他+1分 |
| 人格一致性 | 统一+3分/一般+1分/混乱0分 |

### 4. 封面风格（10分）

**粉丝数>5000的账号**（以夸赞为主）：
- 基础分6分（满分10）
- 视觉特征明显+1分，信息层级清晰+1分，风格一致+2分
- 评分原则：肯定账号视觉呈现，在分析中给出优化建议

**粉丝数≤5000的账号**：
- 基础分3分（满分10）
- 视觉特征明显+2分，信息层级清晰+2分，风格一致+3分

### 5. 爆文能力（15分）

**爆文标准**（基于互动数=点赞+收藏）：
| 账号标识 | 爆文标准（互动数） |
|----------|------------------|
| 素人 | >1000 |
| 尾部KOL | >5000 |
| 腰部KOL | >10000 |
| 头部KOL | >20000 |
| 明星 | >20000 |
| 品牌/企业 | >1000 |

**评分规则**：
- **爆文率（10分）**：
  - 爆文率>=30%：10分
  - 爆文率>=20%：8分
  - 爆文率>=10%：6分
  - 爆文率>=5%：4分
  - 爆文率>0%：2分
  - 无爆文：1分
- **近30天互动表现（5分）**：基于互动量/粉丝数比值评估
  - 平均互动>爆文标准：5分
  - 平均互动>爆文标准50%：3分
  - 平均互动>爆文标准20%：2分
  - 平均互动<爆文标准20%：1分

### 6. 互动规模（20分）

**互动率** = 近30天作品互动量（点赞+收藏）/ 粉丝数 × 100%
**收藏率** = 总收藏数 / 总点赞数 × 100%

**评分规则**：
- **互动量维度（10分）**：基于近30天作品互动量
  - >优秀值：10分
  - >中位数：6分
  - 其他：1分
- **收藏量维度（10分）**：基于总收藏数
  - >优秀值：10分
  - >中位数：6分
  - 其他：1分

**水平衡量**：对比接口返回的中位数参考和优秀值参考，等级判断为优秀/良好/待提升

### 7. 更新产能（15分）

| 评估项 | 得分标准 |
|--------|---------|
| 基础分 | 5分 |
| 周更频率 | ≥5篇得5分/3-4篇得4分/2篇得2分/1篇得1分 |
| 间隔标准差 | <0.5天得5分/0.5-1天得3分/1-2天得1分/>2天得0分 |

### 评分保底规则

- 粉丝数>5000的账号，评分必须>60分
- 当粉丝>5000且总分<61时，自动提升各维度最低分：
  - 账号定位至少5分（满分10）
  - 粉丝画像与需求至少8分（满分15）
  - 选题体系至少8分（满分15）
  - 封面风格至少5分（满分10）
  - 爆文能力至少8分（满分15）
  - 互动规模至少10分（满分20）
  - 更新产能至少8分（满分15）

## 注意事项

- 脚本根据账号标识动态计算爆文标准
- 爆文判断基于互动数（点赞+收藏），而非仅点赞数
- 作品数据取近30天内的作品
- level、avatar、部分works字段值可为null，脚本已做兼容处理