斩获GitHub趋势榜!TrendRadar,让AI帮你24小时洞察全网热点!已有超三万收藏!(部署)
https://github.com/sansan0/TrendRadarTrendRadar 是一个开源的多平台热点聚合与 AI 分析工具,支持监控 35 个平台(如抖音、知乎、B站、华尔街见闻等),通过关键词筛选、自动推送和 AI 对话分析,帮助用户高效处理新闻资讯。项目支持 GitHub 一键部署、Docker 容器化运行,无需编程。项目开源地址:https://github.com/sansan0/TrendRadar,目前该项目已在Github上已收获近3.5w的star,首先感谢开源作者做出的贡献!


本文将基于项目介绍提供的方案,提供一个详细的关于本项目的GitHub Fork 部署(适合无本地环境)方法,协助新用户快速使用。
关键要点
- 部署方式:优先推荐 Docker(一行命令启动),或 GitHub Fork(无需本地环境)。
- 核心配置:修改 config.yaml(平台、推送、AI 设置)和 frequency_words.txt(关键词),并设置 API Keys(如 Webhook)。
- 时间估算:30 秒网页部署,1-5 分钟完成通知推送和 AI 分析配置。
- 依赖:Python 3+(本地运行时),Docker(推荐),GitHub Secrets(Fork 部署)。
- 注意事项:配置 API Keys 时,确保名称严格匹配;测试时使用项目自带样本数据。
第一步: 准备环境
前置条件:
- 拥有一个 GitHub 账号。
- 拥有一个用于接收通知的渠道(推荐:企业微信、飞书、钉钉、Telegram 或 Bark)。
GitHub Fork 部署(适合无本地环境):Fork 项目仓库 https://github.com/sansan0/TrendRadar,无需安装软件。
- 访问项目主页:https://github.com/sansan0/TrendRadar
- 点击右上角的 Fork 按钮。
- 在弹出的页面中,点击 Create fork。注意:这会将项目完整的复制一份到你的 GitHub 账号下。

第二步:配置推送渠道 (GitHub Secrets)
为了保护你的隐私(如 Webhook 地址),不要直接修改代码文件,而是使用 GitHub Secrets。
根据你使用的推送方式,添加对应的 Secret(Name 必须严格一致,Secret 填入你的实际地址):
| 推送渠道 | Secret Name (名称) | Secret Value (值) 的获取方式 |
| 企业微信 (推荐) | WEWORK_WEBHOOK_URL | 企业微信群 -> 右上角... -> 添加群机器人 -> 复制 Webhook 地址 |
| 飞书 | FEISHU_WEBHOOK_URL | 飞书群 -> 设置 -> 群机器人 -> 添加机器人 -> 复制 Webhook 地址 |
| 钉钉 | DINGTALK_WEBHOOK_URL | 钉钉群 -> 智能群助手 -> 添加机器人 -> 复制 Webhook |
| Telegram | TELEGRAM_BOT_TOKEN | 找 @BotFather 创建机器人获取 Token |
| Telegram | TELEGRAM_CHAT_ID | 获取你与机器人的 Chat ID |
| Bark (iOS) | BARK_URL | 下载 Bark App -> 复制服务器地址 (如 https://api.day.app/你的Key/) |
| Slack | SLACK_WEBHOOK_URL | Slack App -> Incoming Webhooks -> 复制 Webhook URL |
点击右上角的绿色按钮 New repository secret。

在左侧侧边栏找到 Secrets and variables -> 点击 Actions。

点击顶部导航栏的 Settings (设置)。

进入你刚刚 Fork 的仓库页面。

重要说明(请务必仔细阅读):
- ✅ 一个 Name 对应一个 Secret:每添加一个配置项,点击一次"New repository secret"按钮,填写一对"Name"和"Secret"
- ✅ 保存后看不到值是正常的:出于安全考虑,保存后重新编辑时,只能看到 Name(名称),看不到 Secret(值)的内容
- ⚠️ 严禁自创名称:Secret 的 Name(名称)必须严格使用下方列出的名称(如
WEWORK_WEBHOOK_URL、FEISHU_WEBHOOK_URL等),不能自己随意修改或创造新名称,否则系统无法识别
💡 可以同时配置多个平台:系统会向所有配置的平台发送通知

这里以飞书为例。
- 电脑浏览器打开 https://botbuilder.feishu.cn/home/my-command,登录飞书账号。
- 点击"新建机器人指令"

- 点击"选择操作" > "通过官方机器人发消息"
"参数"里面放上下面的内容,然后点击"完成"
{ "message_type": "text", "content": { "total_titles": "{{内容}}", "timestamp": "{{内容}}", "report_type": "{{内容}}", "text": "{{内容}}" } }
此时你会看到"Webhook 地址",把这个链接先复制到本地记事本暂存,继续接下来的操作

点击"选择触发器",往下滑动,点击"Webhook 触发"




- 消息标题填写"TrendRadar 热点监控"
最关键的部分来了,点击 + 按钮,选择"Webhook 触发",然后按照下面的图片摆放


回到github的New repository secret中,添加值,保存。

点击完成并启用,如此处报错系统错误,请在手机端飞书搜索机器人并获取机器人助手应用,再启用即可解决。


第三步:启用 GitHub Actions (自动运行)
因为 Fork 的项目默认会禁用 Actions,你需要手动开启。回到自己Fork仓库的界面,注意是自己Fork的分支,不是官方主界面。
你会看到一个绿色按钮 I understand my workflows, go ahead and enable them,点击它。

点击仓库顶部的 Actions 标签页。

第四步:测试运行 (验证是否可用)
不需要等待定时任务,我们手动触发一次来测试。
- 观察结果:
点击 Run workflow (绿色按钮)。

在右侧你会看到一个 Run workflow 的下拉菜单。如果是Disabled状态,在界面右侧有一个enable按钮,点击后即可看到Run workflow。

在左侧列表中点击 Hot News Crawler (或者叫 Crawler / Daily Push)。

点击仓库顶部的 Actions 标签页。

检查手机: 此时你的飞书/微信/Bark 应该已经收到了热点推送消息。

如果变成 ✅ 绿色对号,说明运行成功。

页面会出现一个黄色的圆圈在转,表示正在运行(通常需要 1-3 分钟)。


至此,一个飞书的github网页推送流程就部署好了。
常见问题排查
- Action 运行失败 (红色叉号):
- 点击失败的任务进去看 Run crawler 步骤的日志。
- 错误:Permission denied -> 检查 Settings -> Actions -> General -> Workflow permissions,确保勾选了 Read and write permissions。
- 错误:Secrets not found -> 检查第二步 Secret 的名称是否拼写正确(全大写,下划线)。
- 没有收到推送:
- 检查 Webhook 地址是否包含了 https://。
- 企业微信/钉钉机器人通常有安全设置,需要在机器人后台勾选“自定义关键词”,并确保推送的内容里包含这个关键词(TrendRadar 默认通常包含“热点”、“榜单”等词,建议关键词设为“热点”)。
总结
- 状态: 🟢 可用 (截至 2025年12月)
- 维护情况: 项目更新非常活跃(GitHub 显示最近几天有代码提交),文档较新。本文将持续更新,后续将详细介绍该项目如何进行高级配置调整、AI分析等,敬请期待!
- 最后,如果你喜欢本文内容,不要忘了点点关注点点赞!再次感谢开源项目的各位贡献者。https://github.com/sansan0/TrendRadar