[text](README.md)# KOL Insight

云图 KOL 数据查询与分析工具。

## 功能

- 批量查询 KOL 视频数据
- 支持星图ID、达人unique_id、达人昵称搜索
- 计算预估自然CPM、看后搜成本等指标
- 数据导出

## 技术栈

- **前端/后端**: Next.js (App Router)
- **数据库**: PostgreSQL
- **部署**: Docker / PM2

## 快速开始

```bash
# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env.local

# 开发模式
pnpm dev

# 构建
pnpm build

# 生产运行
pnpm start
```

## 环境变量

```env
DATABASE_URL=postgresql://user:password@host:5432/yuntu_kol
```

## License

MIT

查询输入：批量  星图id（精准匹配）  或 达人unique_id (精准匹配） 或达人昵称（包含匹配）


星图ID → 匹配 star_id 字段
达人unique_id → 匹配 star_unique_id 字段
达人昵称 → 模糊匹配 star_nickname 字段

输出：
中文名	视频ID	视频标题	爆文类型	视频链接	新增A3率	看后搜次数	回搜次数	自然曝光数	加热曝光数	总曝光数	总互动	点赞	转发	评论	合作行业ID	合作行业	合作品牌ID	合作品牌	发布时间	达人昵称	达人unique_id	预估视频价格	预估自然CPM	预估自然看后搜	预估自然看后搜成本
指标名	item_id	title																							

合作品牌要使用合作品牌id 调用另一个API查找 
https://api.internal.intelligrow.cn/docs#/%E4%BA%91%E5%9B%BE/get_yuntu_cookies_v1_yuntu_get_cookie_get
/v1/yuntu/brands/{brand_id}

预估自然CPM =estimated_video_cost /   natural_play_cnt *1000
预估自然看后搜人数 =  natural_play_cnt  / total_play_cnt *  after_view_search_uv
预估自然看后搜人数成本  = estimated_video_cost  /预估自然看后搜人数