TrendRadar README

The project's README from github.com/sansan0/TrendRadar. As one markdown file: README.md.

TrendRadar Banner

最快30秒部署的热点助手 —— 告别无效刷屏,只看真正关心的新闻资讯

🌐 官方网站 · 📖 官网文档

sansan0%2FTrendRadar | Trendshift

GitHub Stars GitHub Forks License Version MCP Docker Pulls Docker Pulls RSS AI翻译 MCP Support AI分析推送 AI智能筛选

企业微信通知 个人微信通知 Telegram通知 dingtalk通知 飞书通知 邮件通知 ntfy通知 Bark通知 Slack通知 通用Webhook

GitHub Actions GitHub Pages Docker 本地部署 Cloudflare Pages

中文 | English

本项目以轻量,易部署为目标


📑 快速导航

💡 点击下方链接可快速跳转到对应章节。部署推荐从「快速开始」入手,需要详细自定义请看「配置详解」

🚀 快速开始 AI 智能分析 ⚙️ 配置详解
Docker部署 / 本地部署 MCP客户端 📝 更新日志
🎯 核心功能 ☕ 支持项目 📚 项目相关

👉 点击展开:致谢名单 (天使轮荣誉榜 🔥73+🔥 位)

早期支持者致谢

💡 特别说明:

  1. 关于名单:下方表格记录了项目起步阶段(天使轮)的支持者。因早期人工统计繁琐,难免存在疏漏或记录不全的情况,如有遗漏,实非本意,万望海涵。
  2. 未来规划:为了将有限的精力回归代码与功能迭代,即日起不再人工维护此名单。

无论名字是否上榜,你们的每一份支持都是 TrendRadar 能够走到今天的基石。🙏

基础设施支持

感谢 GitHub 免费提供的基础设施,这是本项目得以一键 fork便捷运行的最大前提。

数据支持

本项目使用 newsnow 项目的 API 获取多平台数据,特别感谢作者提供的服务。

经联系,作者表示无需担心服务器压力,但这是基于他的善意和信任。请大家:

  • 前往 newsnow 项目 点 star 支持
  • Docker 部署时,请合理控制推送频率,勿竭泽而渔

推广助力

感谢以下平台和个人的推荐(按时间排列)

观众支持

感谢给予资金支持的朋友们,你们的慷慨已化身为键盘旁的零食饮料,陪伴着项目的每一次迭代。

关于"一元点赞"的回归: 随着 v5.0.0 版本的发布,项目迈入了一个新的阶段。为了支持日益增长的 API 成本和咖啡因消耗,"一元点赞"通道现已重新开启。你的每一份心意,都将转化为代码世界里的 Token 和动力。🚀 前往支持

点赞人 金额 日期 备注
D*5 1.8 * 3 2025.11.24
*鬼 1 2025.11.17
*超 10 2025.11.17
R*w 10 2025.11.17 这 agent 做的牛逼啊,兄弟
J*o 1 2025.11.17 感谢开源,祝大佬事业有成
*晨 8.88 2025.11.16 项目不错,研究学习中
*海 1 2025.11.15
*德 1.99 2025.11.15
*疏 8.8 2025.11.14 感谢开源,项目很棒,支持一下
M*e 10 2025.11.14 开源不易,大佬辛苦了
**柯 1 2025.11.14
*云 88 2025.11.13 好项目,感谢开源
*W 6 2025.11.13
*凯 1 2025.11.13
对*. 1 2025.11.13 Thanks for your TrendRadar
s*y 1 2025.11.13
**翔 10 2025.11.13 好项目,相见恨晚,感谢开源!
*韦 9.9 2025.11.13 TrendRadar超赞,请老师喝咖啡~
h*p 5 2025.11.12 支持中国开源力量,加油!
c*r 6 2025.11.12
a*n 5 2025.11.12
。*c 1 2025.11.12 感谢开源分享
*记 1 2025.11.11
*主 1 2025.11.10
*了 10 2025.11.09
*杰 5 2025.11.08
*点 8.80 2025.11.07 开发不易,支持一下。
Q*Q 6.66 2025.11.07 感谢开源!
C*e 1 2025.11.05
Peter Fan 20 2025.10.29
M*n 1 2025.10.27 感谢开源
*许 8.88 2025.10.23 老师 小白一枚,摸了几天了还没整起来,求教
Eason 1 2025.10.22 还没整明白,但你在做好事
P*n 1 2025.10.20
*杰 1 2025.10.19
*徐 1 2025.10.18
*志 1 2025.10.17
*😀 10 2025.10.16 点赞
**杰 10 2025.10.16
*啸 10 2025.10.16
*纪 5 2025.10.14 TrendRadar
J*d 1 2025.10.14 谢谢你的工具,很好玩...
*H 1 2025.10.14
那*O 10 2025.10.13
*圆 1 2025.10.13
P*g 6 2025.10.13
Ocean 20 2025.10.12 ...真的太棒了!!!小白级别也能直接用...
**培 5.2 2025.10.2 github-yzyf1312:开源万岁
*椿 3 2025.9.23 加油,很不错
*🍍 10 2025.9.21
E*f 1 2025.9.20
*记 1 2025.9.20
z*u 2 2025.9.19
**昊 5 2025.9.17
*号 1 2025.9.15
T*T 2 2025.9.15 点赞
*家 10 2025.9.10
*X 1.11 2025.9.3
*飙 20 2025.8.31 来自老童谢谢
*下 1 2025.8.30
2*D 88 2025.8.13 下午
2*D 1 2025.8.13 上午
S*o 1 2025.8.05 支持一下
*侠 10 2025.8.04
x*x 2 2025.8.03 trendRadar 好项目 点赞
*远 1 2025.8.01
*邪 5 2025.8.01
*梦 0.1 2025.7.30
**龙 10 2025.7.29 支持一下

🪄 赞助商

虚位以待

有意赞助?点击查看赞助与合作详情


❤️ 觉得好用?支持一下

若 TrendRadar 曾为你捕捉价值,不妨为它注入动力,助其持续进化

金额随意,1 元也是对开源的鼓励。欢迎在赞赏时备注留言 (´▽`ʃ♡ƪ)

微信赞赏 支付宝赞赏
微信赞赏 支付宝赞赏

🤝 二次开发与引用

如果你在项目中使用或借鉴了本项目的思路、核心代码,非常欢迎在 README 或文档中注明来源并附上本仓库链接。

这将有助于项目的持续维护和社区发展,感谢你的尊重与支持!❤️

💬 交流与反馈

友情提示: 本项目为开源分享,非商业产品。把作者当朋友而非客服,沟通效率会更高哦!

公众号关注

📝 更新日志

📌 查看最新更新:原仓库更新日志 :

2026/06/19 - v6.10.0

2026/02/09 - mcp-v4.0.0

👉 点击展开:历史更新

2026/06/02 - v6.9.0

  • 热榜域名安全校验:新增 expected_domain 配置项,校验返回数据链接的域名合法性,不匹配时自动丢弃数据并警告,有效防范链接劫持或数据篡改
  • 自定义热榜 API 地址:支持自部署 newsnow 并配置 api_url 使用自己的数据源

2026/05/23 - v6.8.0

  • HTML 报告全面增强:新增报告元数据展示(生成时间、数据来源、版本号)、暗色模式自动适配、Tab 栏交互优化、趋势箭头可视化,浏览器阅读体验大幅提升
  • 版本检查 CDN 多源回退:版本检查接口支持 GitHub → jsDelivr → Cloudflare 等多个 CDN 源自动回退,国内网络环境也能稳定获取更新提示
  • 展示区域开关生效:HTML 报告和邮件现在正确尊重 display.regions.ai_analysis 和 display.regions.standalone 开关,关闭即不渲染
  • 导出按钮修复:修复导出按钮点击后下拉菜单图标消失的问题
  • Markdown 导出修复:修复 HTML 报告 Markdown 导出中 JS 换行符转义错误

2026/05/15 - v6.7.0

  • Markdown 导出:报告导出下拉菜单新增 Markdown 格式,一键生成带链接的结构化文本,方便 LLM 二次加工和跨平台分享(#1121)
  • RSS guid 去重:RSS 存储新增 guid 字段,去重优先级改为 guid > url,解决同一文章因 URL 变化导致重复入库的问题
  • 空标题防护:解析器、渲染层、翻译回填全链路增加空标题兜底逻辑,确保无标题条目也能正常显示
  • 翻译质量增强:翻译提示词要求保留编号顺序,空翻译结果不再覆盖原始标题

2026/03/28 - v6.6.0

  • HTML 报告浏览器增强:在浏览器中打开报告可自动切换宽屏布局,关键词分组和独立展区均支持 Tab 快速切换,搜索框实时过滤新闻标题,邮件客户端仍显示原始窄屏布局,零回归
  • 暗色模式:一键切换深色主题,自动记住偏好,适合夜间阅读
  • 一键复制新闻:鼠标悬停新闻序号即可复制标题和链接,方便快速分享
  • 导出优化:整页截图和分段截图合并为下拉式导出按钮,截图时自动还原干净布局
  • 快捷键系统:支持 W 宽屏切换、D 暗色模式、/ 搜索、? 查看快捷键提示
  • 阅读进度条:页面顶部实时显示阅读进度

2026/03/12 - v6.5.0

  • AI 智能筛选系统:不用再手动设关键词!在 ai_interests.txt 里用日常语言写下你关注的方向(如"我想看 AI 和新能源相关新闻"),AI 会自动提取标签并对每条新闻打分,只推送真正和你相关的内容。万一 AI 筛选出了问题,会自动切回关键词匹配,推送不中断
  • 每个时段支持不同的筛选方式和关注方向:Timeline 中的每个时间段现在可以独立设置用什么方式筛选、看什么类型的新闻。比如:早上用"科技关键词"快速过滤,晚上换成"金融 AI 兴趣描述"做深度筛选——同一个系统,不同时段看不同内容
  • AI 分析范围独立于推送:AI 分析的数据范围可以和推送内容不同。比如推送只发新增消息(避免重复打扰),但 AI 分析当天全部新闻(看完整趋势)。每个时段也能单独设置 AI 分析模式
  • AI 筛选智能省钱:已分析过的新闻不会重复消耗 token;兴趣描述修改后,AI 自动判断变化幅度——小改动只更新受影响的标签,大改动才全量重新分类
  • 多文件配置与标签隔离:自定义关键词文件放 config/custom/keyword/,AI 兴趣文件放 config/custom/ai/,不同文件产生的标签各自独立、互不干扰
  • AI 翻译精准控制:可分别控制热榜、RSS、独立展示区是否翻译,没开启显示的区域自动跳过,不浪费 token
  • 远程存储批量上传:多次写操作攒在一起统一提交云端,减少 API �

TrendRadar (sansan0/TrendRadar)

Searching Database…

这是什么?TrendRadar 是一款由 AI 驱动的舆情与热点趋势监测工具。它汇总国内多个平台以及 RSS 订阅源的热门话题,用关键词或 AI 进行筛选,并把智能简报推送到你的手机或电脑上。
这是云服务,还是要我自己部署?这是一个自托管的 Python 项目,可以通过 Docker 或在本地运行。它本身不抓取网站,而是从开源项目 newsnow 的 API 获取多平台热点数据。
我该怎么把它跑起来?你可以 Fork 仓库并用 Docker 部署,也可以在本地用 Python 运行。README 中提到,Docker 部署大约只需 30 秒,是最轻量的部署方式。
用智能筛选需要 AI API 密钥吗?基础的关键词筛选无需 AI 密钥即可直接使用。但 AI 筛选、翻译和摘要功能(以及 MCP)需要在 config.yaml 中配置 LLM API 密钥。此外,你启用的每个推送渠道(微信、飞书、钉钉、Telegram、邮件、ntfy、bark、Slack)还需要单独的令牌或 Webhook。
如果底层的 newsnow API 出问题了怎么办?TrendRadar 的多平台数据完全依赖第三方项目 newsnow 的免费 API。因此,维护者建议自托管用户合理控制推送频率,避免给这一共享服务造成过大负担。
MCP 集成能让 AI 助手做什么?TrendRadar 提供了 MCP 服务器,AI 客户端可以用自然语言向它查询,进行趋势分析、情绪洞察和预测,甚至可以自行触发向所有已配置渠道的推送。
AI 智能筛选和关键词筛选有什么不同?你不需要设置关键词,而是用自然语言在 aiinterests.txt 中描述你的兴趣(例如“关于 AI 和新能源的新闻”)。AI 会为每条标题打标签并评分;如果 AI 筛选失败,则会自动回退到关键词匹配。
我能在浏览器里舒服地看报告吗?可以。HTML 报告支持深色模式、宽屏布局、按关键词分组切换标签页、实时搜索、一键复制标题,以及 Markdown 和截图导出;邮件则保持更简单的固定版式。
Creator
sansan0
Size
33.3 MB
Stars
63K
Updated
CommitOct 15
Age
1y
Commits · 90 Days