ac0f086821
- 完成 T-001A: 前端项目初始化 (Next.js 14 + TypeScript + Tailwind CSS) - 完成 T-001B: 后端项目初始化 (FastAPI + SQLAlchemy + asyncpg) - 完成 T-002: 数据库配置 (KolVideo 模型 + 索引 + 测试) - 完成 T-003: 基础 UI 框架 (Header/Footer 组件 + 品牌色系) - 完成 T-004: 环境变量配置 (前后端环境变量) Co-Authored-By: Claude <noreply@anthropic.com>
66 lines
1.7 KiB
Markdown
66 lines
1.7 KiB
Markdown
[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 /预估自然看后搜人数
|
||
|