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…

What is this?TrendRadar is an AI-driven public opinion and trend monitoring tool that aggregates trending topics from many Chinese platforms plus RSS feeds, filters them with keywords or AI, and pushes a smart briefing to your phone or desktop.
Is this a cloud service or something I host myself?It's a self-hosted Python project you run via Docker or locally; it doesn't scrape sites itself but pulls multi-platform hot-topic data from the open-source newsnow project's API.
How do I get it running?You can fork the repo and deploy it with Docker, or run it locally with Python; the README advertises a roughly 30-second Docker deployment for the lightest setup.
Do I need an AI API key to use the smart filtering?Basic keyword filtering works out of the box with no AI key, but the AI-based filtering, translation and summary features (and MCP) need an LLM API key configured in config.yaml, plus separate tokens/webhooks for whichever push channels you enable (WeChat, Feishu, DingTalk, Telegram, email, ntfy, bark, Slack).
What happens if the underlying newsnow API has problems?TrendRadar depends entirely on the third-party newsnow project's free API for its multi-platform data, so the maintainer asks self-hosters to keep push frequency reasonable to avoid overloading that shared service.
What does the MCP integration let AI assistants do?TrendRadar exposes an MCP server so an AI client can query it in natural language for trend analysis, sentiment insights and prediction, and even trigger pushes to all configured channels itself.
How does AI smart filtering differ from keyword filtering?Instead of setting keywords, you describe your interests in plain language in aiinterests.txt (e.g. 'news about AI and new energy') and the AI tags and scores each headline, automatically falling back to keyword matching if the AI filter fails.
Can I read the reports comfortably in a browser?Yes, the HTML report supports a dark mode, wide-screen layout, tab switching between keyword groups, live search, one-click headline copying, and Markdown/screenshot export, while emails keep a simpler fixed layout.
Creator
sansan0
Size
33.3 MB
Stars
62.9K
Updated
CommitOct 15
Age
1y
Commits · 90 Days