TrendRadar 轻量级热点聚合工具

编辑文章

项目介绍

TrendRadar 是一款轻量、易部署、低成本的全网热点聚合工具，核心目标是帮助用户告别无效信息刷屏，精准获取自己关心的多平台新闻资讯，最快 30 秒即可完成部署，仅依托 GitHub 生态（GitHub Actions + GitHub Pages）就能实现热点的自动爬取、整理和网页展示，适合希望高效获取多平台热点、拒绝信息过载的用户。

https://github.com/joyce677/TrendRadar

核心功能

多平台热点全覆盖

默认聚合 11 个主流平台的实时热点，覆盖综合、财经、社交、视频等多类型渠道：
– 综合类：今日头条、百度热搜、澎湃新闻、凤凰网、财联社；
– 社交/内容类：微博、知乎、抖音、bilibili 热搜、贴吧；
– 财经类：华尔街见闻。

支持自定义增减监控平台（修改配置文件即可）。

自动化热点爬取与整理

  • 依托 GitHub Actions 实现定时自动爬取（默认每小时运行一次），也支持手动触发爬取；
  • 爬取结果按「时间+平台」结构化整理，每条热点附带原始链接，归档在 output 目录（如 2025年12月07日/txt/10时14分.txt）；
  • 自动生成网页版、图片版热点内容，还提供 API 接口（/api/trends.json）方便其他程序调用。

个性化定制能力

  • 自定义监控关键词：编辑 config/frequency_words.txt，可添加/删除关注的关键词，过滤无关热点；
  • 自定义监控平台：编辑 config/config.yaml，可保留核心平台、删除不需要的监控渠道；
  • 无需推送配置：可完全禁用所有手机/办公软件推送（如企业微信、飞书、钉钉等），仅保留网页访问功能。

呈现形式

  • GitHub Pages 网页：部署后可通过 https://你的GitHub用户名.github.io/TrendRadar/ 访问，直接查看最新聚合热点；
  • 结构化文本文件：热点按时间归档为 TXT 文件，每条内容标注平台、标题和原始链接，便于查阅；
  • 图片版热点：自动生成 /img/news.jpg，以图片形式汇总热点，适合快速预览；
  • API 接口：提供 /api/trends.json 接口，可对接其他工具/程序调用热点数据。

核心优势

  • 易上手：零基础用户也能完成部署（仅需 Fork 仓库 + 开启 GitHub Pages）；
  • 时效性：定时自动爬取，保证热点内容的实时性；
  • 个性化：支持关键词/平台定制，只看自己关心的内容；
  • 无依赖：无需配置第三方推送密钥、无需本地安装依赖，仅依托 GitHub 生态即可运行。

适用场景

  • 个人用户：快速获取多平台热点，避免逐个 App 刷取；
  • 小团队/社群：聚合热点后通过网页分享，无需手动整理；
  • 开发者：基于提供的 API 接口对接自有工具，扩展热点使用场景。

项目部署配置

以下步骤仅聚焦 GitHub Pages 网页访问功能，无需配置任何手机推送相关内容，全程零推送配置、零额外依赖：

复刻（Fork）项目

  1. 打开原项目仓库（https://github.com/sansan0/TrendRadar）；
  2. 点击页面右上角的 Fork 按钮，等待几秒即可将项目复刻到你的 GitHub 账户下。

启用 GitHub Pages

复刻完成后，在你的复刻仓库中操作：
– 点击仓库顶部的 Settings（设置）选项卡；
– 滚动左侧菜单栏，找到并点击 Pages（页面）选项；
– 在「Build and deployment」（构建和部署）区域：
– Source（来源）选择 Deploy from a branch（从分支部署）；
– Branch（分支）选择 main（或 master，看仓库默认分支名），Folder（文件夹）选择 /root（根目录）；
– 点击 Save（保存）；
– 保存后页面会自动刷新，等待 1-2 分钟（GitHub 会自动构建 Pages），页面顶部会显示「Your site is live at xxx」，即 GitHub Pages 访问地址（格式：https://你的GitHub用户名.github.io/TrendRadar/）。

禁用推送功能（可选，避免运行报错）

原项目默认会尝试推送通知，无需推送时可关闭该功能，避免 GitHub Actions 运行时出现无关报错：
– 在你的复刻仓库中，打开 config/config.yaml 文件；
– 找到 notification 配置段，将 enable_notification 的值改为 false：

notification:
 enable_notification: false  # 关闭所有推送通知
 # 其他推送相关配置无需修改，保持默认即可
  • 点击页面底部的 Commit changes（提交更改），提交修改（备注可填「禁用推送功能」）。

确认自动运行

原项目已配置 .github/workflows/crawler.yml（每小时自动爬取热点并生成页面文件），该配置会自动生效：
– 爬取的结果会保存在仓库的 output 目录中；
– GitHub Pages 会自动同步这些文件，你访问 Pages 地址时就能看到最新的热点内容；
– 若想手动触发爬取：点击仓库顶部的 Actions（动作）选项卡 → 左侧选择 crawler → 点击 Run workflow → 再次点击 Run workflow 即可手动运行一次。

验证访问效果

  • 等待第一次爬取完成（可通过 Actions 查看运行状态，显示 ✅ 即完成）；
  • 打开第二步中生成的 GitHub Pages 地址，即可看到热点监控的网页版内容（效果参考原项目说明的「Github Pages效果」截图）。

可选自定义配置（按需调整）

如果想修改监控的内容/平台，可编辑以下文件：
– 修改监控关键词：打开 config/frequency_words.txt，按文件内注释规则添加/删除你关心的关键词（比如只监控「人工智能」「新能源」等）；
– 修改监控平台：打开 config/config.yaml，找到 platforms 配置段，删除不需要监控的平台（比如保留 weibo（微博）、zhihu（知乎），删除其他）。

核心注意事项

  • 无需配置任何 GitHub Secrets（如 WEWORK_WEBHOOK_URL、FEISHU_WEBHOOK_URL 等），因为完全不需要推送；
  • GitHub Pages 首次部署可能需要 1-5 分钟，若访问 404，可等待几分钟后刷新；
  • 若想停止自动爬取：进入 Actions → crawler → 点击 Disable workflow 即可关闭定时任务（关闭后 Pages 内容不会再更新）。