背景

作为一个关注互联网热点的开发者，我经常需要在不同平台之间来回切换查看热搜榜——微博的热搜、知乎的热问、抖音的挑战话题、今日头条的资讯……每次都要打开多个应用，效率低下且容易遗漏重要信息。

市面上虽然有一些聚合工具，但要么收费、要么广告繁多、要么平台覆盖不全。后来我发现了一个宝藏 API —— UApiPro，它提供了一个统一的热搜接口，可以一次性获取多个平台的热搜数据，解决了数据源的难题。

于是，我基于这个 API 开发了一个开源、免费、可自部署的热搜监控工具（hotsearch-monitor）。这个工具已经支持 45+ 个主流平台，并且通过 Docker 实现了一键部署。今天分享给大家，希望能帮助到同样需要关注网络热点的你。

项目地址: https://github.com/baoxinwen/hotsearch-monitor

项目简介

热搜监控工具（hotsearch-monitor） 是一个实时监控各大平台热搜榜的 Web 应用，核心功能包括：

• 多平台聚合：支持 45+ 个中国主流平台，涵盖视频社区、新闻资讯、技术博客、游戏资讯等
• 关键词筛选：自定义关键词，自动筛选出感兴趣的热搜内容
• 历史快照：定期保存热搜快照，支持历史数据回溯
• 邮件推送：定时发送热搜日报到邮箱
• 响应式界面：支持深色/浅色主题，完美适配移动端

支持的平台分类

快速部署（Docker Compose）

步骤 1：克隆项目仓库

git clone https://github.com/baoxinwen/hotsearch-monitor.git
cd hotsearch-monitor

步骤 2：创建环境变量文件（可选）

复制示例配置文件并根据需要修改：

cp .env.example .env

常用配置项说明：

# 基础配置
HOST_PORT=5000              # 主机端口

# 历史数据功能
HISTORY_ENABLED=True
HISTORY_RETENTION_DAYS=7

# 自动禁用失败平台
AUTO_DISABLE_FAILED_PLATFORMS=True

# API 并发数
API_MAX_WORKERS=10

# 速率限制
RATE_LIMIT_ENABLED=True
RATE_LIMIT_REQUESTS=60

步骤 3：启动服务

docker compose up -d

首次启动需要拉取镜像，等待几分钟后，访问 http://localhost:5000 即可看到监控界面。

通过源码启动

如果你想从源码运行，或者想对项目进行二次开发，可以按照以下步骤操作：

步骤 1：克隆项目并安装依赖

# 克隆项目
git clone https://github.com/baoxinwen/hotsearch-monitor.git
cd hotsearch-monitor

# 安装 Python 依赖
pip install -r requirements.txt

步骤 2：启动后端服务

cd backend
python app.py

服务启动后，访问 http://127.0.0.1:5000 即可使用。

使用指南

1. 主页概览

启动后，你会看到一个实时更新的热搜监控面板，展示所有已启用平台的热搜数据。

每个平台卡片显示：

• 平台名称和分类标签
• 热搜条目数量
• 最后更新时间
• 操作按钮（刷新、禁用）

2. 设置关键词筛选

点击右上角的 设置 按钮，进入配置页面。

在 监控关键词 输入框中，每行输入一个关键词：

黄金
金价
贵金属

保存后，系统会自动筛选出包含这些关键词的热搜内容，并在 筛选结果 标签页中显示。

3. 管理监控平台

在设置页面，你可以：

• 按分类选择平台：每个分类旁边都有"全选"按钮，快速选择整个分类
• 单独启用/禁用平台：取消勾选即可禁用某个平台
• 设置更新间隔：默认 5 分钟自动刷新，可自定义

小贴士：在主页也可以快速禁用某个平台——点击平台卡片右上角的禁用按钮即可。如需重新启用，请在设置中勾选该平台。

4. 配置邮件推送

设置页面底部提供邮件推送功能，支持定时发送热搜日报：

1. 开启邮件推送：勾选"启用邮件推送"
2. 配置发件邮箱：填写邮箱地址和 SMTP 授权码（注意是授权码，不是登录密码）
3. 添加收件人：点击"+"号添加多个收件人
4. 设置发送时间：默认每天 22:00 发送
5. 测试邮件：点击"发送测试邮件"验证配置

注意：163 邮箱需要在设置中开启 SMTP 服务才能获取授权码。

5. 查看历史快照

点击 历史数据 标签页，可以按日期查看历史热搜快照。系统会自动保存每日快照，默认保留 7 天。

点击日期可展开/收起该日期的所有快照列表。

常见问题

Q: 为什么某个平台显示"HTTP错误 500"？

A: 这是 UApiPro API 服务的问题，不是代码 bug。第三方 API 服务偶尔会出现不稳定，建议暂时禁用该平台或稍后重试。

Q: 数据多久更新一次？

A: 默认每 5 分钟自动更新，可在设置中修改更新间隔（最小 60 秒），也可以手动点击刷新按钮。

Q: Docker 部署数据会丢失吗？

A: 不会。配置、数据和日志目录都通过 volume 挂载到宿主机，删除容器后数据仍然保留。

项目地址

GitHub: https://github.com/baoxinwen/hotsearch-monitor

Docker 镜像: ghcr.io/baoxinwen/hotsearch-monitor:latest

欢迎 Star ⭐ 和 Fork，也欢迎提交 Issue 和 PR！