kol-insight/doc/RequirementsDoc.md
zfc ac0f086821 feat(init): 完成 Phase 1 基础架构搭建
- 完成 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>
2026-01-28 14:26:46 +08:00

1.7 KiB
Raw Permalink Blame History

text# KOL Insight

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

功能

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

技术栈

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

快速开始

# 安装依赖
pnpm install

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

# 开发模式
pnpm dev

# 构建
pnpm build

# 生产运行
pnpm start

环境变量

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 /预估自然看后搜人数