title	HotTrack - YouTube & TikTok Analyzer
emoji	📹
colorFrom	blue
colorTo	purple
sdk	docker
pinned	false
license	mit
short_description	Real-time analysis of trending videos on YouTube and TikTok

🎬 HotTrack - YouTube & TikTok 热门视频分析平台

实时分析 YouTube 和 TikTok 上最热门、增长最快的视频，包括收入估算

🌐 在线演示

🚀 点击这里体验 HotTrack

📍 演示地址: https://huggingface.co/spaces/chanfasf/HotTrack

---

✨ 功能特性

功能	描述
📊 热门排行榜	查看播放量最高的视频，支持按平台筛选
🔥 趋势分析	发现正在爆红的视频，追踪增长趋势
⚡ 爆红速度	分析视频增长速度，预测下一个爆款
💰 收入估算	基于播放量的广告收入预测，包含详细分成
🎯 AI 分析	标题评分、领域推荐、趋势预测

🛠️ 技术栈

• 后端: FastAPI + SQLAlchemy + APScheduler
• 前端: Vue 3 + Vite + Chart.js
• 数据源: YouTube Data API v3 + TikHub API
• 部署: Docker + Hugging Face Spaces

📸 界面展示

核心功能：

• 📊 实时排名 - 追踪爆红速度最快的视频
• 🔥 多平台支持 - YouTube (YT) + TikTok (TT) 数据整合
• ⚡ 增长指标 - 爆红指数、爆红速度实时计算
• 💰 收入预估 - 基于CPM模型的广告收入预测
• 🎯 智能筛选 - 按平台、时间范围灵活筛选

🚀 快速开始

环境要求

• Python 3.11+
• Node.js 18+
• YouTube API Key（可选）
• TikHub API Key（可选）

本地运行

# 克隆项目
git clone https://github.com/chanzsam/hottrack.git
cd hottrack

# 后端
cd backend
pip install -r requirements.txt
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000

# 前端（新终端）
cd frontend
npm install
npm run dev

环境变量

创建 backend/.env 文件：

YOUTUBE_API_KEY=your_youtube_api_key
TIKHUB_API_KEY=your_tikhub_api_key

💡 即使不配置 API Key，应用也会使用演示数据运行

📊 API 文档

启动后访问：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

📝 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

👤 作者

chanzsam

• 🐙 GitHub: https://github.com/chanzsam
• 🤗 Hugging Face: https://huggingface.co/chanfasf

---

⭐ 如果这个项目对你有帮助，请给一个 Star！