sansan0/TrendRadar

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/sansan0/TrendRadar.svg?style=card)](https://bestofgithub.dev/repo/sansan0/TrendRadar)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/sansan0/TrendRadar.svg)](https://bestofgithub.dev/repo/sansan0/TrendRadar)

Loading README…


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

点赞人	金额	日期	备注
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	支持一下

模式	适用场景	推送特点
当日汇总 (daily)	企业管理者/普通用户	按时推送当日所有匹配新闻（会包含之前推送过的）
当前榜单 (current)	自媒体人/内容创作者	按时推送当前榜单匹配新闻（持续在榜的每次都出现）
增量监控 (incremental)	投资者/交易员	仅推送新增内容，零重复

功能	说明	默认
调度系统	按周一到周日逐日编排：为每天分配不同时间段、推送模式和 AI 分析策略。每个时段可独立设置筛选方式（关键词/AI）和关注方向，实现不同时间看不同类型新闻。内置 5 种预设（always_on / morning_evening / office_hours / night_owl / custom），也可自定义。支持工作日/周末差异化、跨午夜时段、per-period 去重、时段冲突检测（v6.0.0 + v6.5.0）	morning_evening
内容顺序配置	通过 `display.region_order` 调整各区域（热榜、新增热点、RSS、独立展示区、AI 分析）的显示顺序；通过 `display.regions` 控制各区域是否显示（v5.2.0）	见配置文件
显示模式切换	`keyword`=按关键词分组，`platform`=按平台分组（v4.6.0 新增）	keyword

Name（名称）	Secret（值）
`CLOUDFLARE_API_TOKEN`	上一步创建的 API Token
`CLOUDFLARE_ACCOUNT_ID`	你的 Cloudflare Account ID
`CLOUDFLARE_PROJECT_NAME`	Cloudflare Pages 项目名（如 `trendradar`）

邮箱服务商	域名	SMTP 服务器	端口	加密方式
Gmail	gmail.com	smtp.gmail.com	587	TLS
QQ邮箱	qq.com	smtp.qq.com	465	SSL
Outlook	outlook.com	smtp-mail.outlook.com	587	TLS
Hotmail	hotmail.com	smtp-mail.outlook.com	587	TLS
Live	live.com	smtp-mail.outlook.com	587	TLS
163邮箱	163.com	smtp.163.com	465	SSL
126邮箱	126.com	smtp.126.com	465	SSL
新浪邮箱	sina.com	smtp.sina.com	465	SSL
搜狐邮箱	sohu.com	smtp.sohu.com	465	SSL
天翼邮箱	189.cn	smtp.189.cn	465	SSL
阿里云邮箱	aliyun.com	smtp.aliyun.com	465	TLS
Yandex邮箱	yandex.com	smtp.yandex.com	465	TLS
iCloud邮箱	icloud.com	smtp.mail.me.com	587	SSL

用户类型	推荐方案	理由
普通用户	方式一（免费）	简单快速，够用
技术用户	方式二（自托管）	完全控制，无限制
高频用户	方式三（付费）	这个自己去官网看吧

文件	作用
`config/config.yaml`	主配置文件：推送模式、时间窗口、平台列表、热点权重等
`config/frequency_words.txt`	关键词文件：设置你关心的词汇，筛选推送内容
`config/ai_analysis_prompt.txt`	AI 提示词模板：自定义 AI 分析师的角色和分析维度
`.github/workflows/crawler.yml`	执行频率：控制多久运行一次（⚠️ 谨慎修改）

Name（名称）	Secret（值）说明
`S3_BUCKET_NAME`	存储桶名称（如 `trendradar-data`）
`S3_ACCESS_KEY_ID`	访问密钥 ID（Access Key ID）
`S3_SECRET_ACCESS_KEY`	访问密钥（Secret Access Key）
`S3_ENDPOINT_URL`	S3 API 端点（如 R2：`https://<account-id>.r2.cloudflarestorage.com`）

特性	✨ AI 分析推送	🧠 AI 智能分析
模式	被动接收 (每日日报)	主动对话 (深度调研)
场景	"今天有什么大事？"	"分析一下过去一周 AI 行业的变化"
部署	极简 (填 Key 即可)	进阶 (需本地运行/Docker)
客户端	手机	电脑

语法类型	符号	作用	示例	匹配逻辑
普通词	无	基础匹配	`华为`	包含任意一个即可
必须词	`+`	限定范围	`+手机`	必须同时包含
过滤词	`!`	排除干扰	`!广告`	包含则直接排除
数量限制	`@`	控制显示数量	`@10`	最多显示10条新闻（v3.2.0新增）
全局过滤	`[GLOBAL_FILTER]`	全局排除指定内容	见下方示例	任何情况下都过滤（v3.5.0新增）
正则表达式	`/pattern/`	精确匹配模式	`/\bai\b/`	使用正则表达式匹配（v4.7.0新增）
显示名称	`=> 备注`	自定义显示文本	`/\bai\b/ => AI相关`	推送和HTML显示备注名称（v4.7.0新增）

需求	正则写法	说明
英文单词边界	`/\bword\b/`	匹配独立单词，如 `/\bai\b/` 匹配 "AI" 但不匹配 "training"
前后非字母	`/(?<![a-z])ai(?![a-z])/`	更宽松的边界，适合中英混合场景
开头匹配	`/^breaking/`	只匹配以 "breaking" 开头的标题
结尾匹配	`/发布$/`	只匹配以 "发布" 结尾的标题
多选一	`/苹果\|华为\|小米/`	匹配其中任意一个（注意转义 `\|`）

原始配置	推送/HTML 显示
`/(?<![a-z])ai(?![a-z])/` + `人工智能`	`(?<![a-z])ai(?![a-z]) 人工智能`
`/(?<![a-z])ai(?![a-z])/ => AI 相关` + `人工智能`	`AI 相关`

配置值	排序规则	适用场景
`false`（默认）	热点条数 ↓ → 配置位置 ↑	关注热度趋势
`true`	配置位置 ↑ → 热点条数 ↓	关注个人优先级

模式	适用人群	推送时机	显示内容	典型使用场景
当日汇总 `daily`	📋 企业管理者/普通用户	按时推送(默认每小时推送一次)	当日所有匹配新闻 + 新增新闻区域	案例：每天下午6点查看今天所有重要新闻特点：看全天完整趋势，不漏掉任何热点提醒：会包含之前推送过的新闻
当前榜单 `current`	📰 自媒体人/内容创作者	按时推送(默认每小时推送一次)	当前榜单匹配新闻 + 新增新闻区域	案例：每小时追踪"哪些话题现在最火" 特点：实时了解当前热度排名变化提醒：持续在榜的新闻每次都会出现
增量监控 `incremental`	📈 投资者/交易员	有新增才推送	新出现的匹配频率词新闻	案例：监控"特斯拉"，只在有新消息时通知特点：零重复，只看首次出现的新闻适合：高频监控、避免信息打扰

时间	daily 模式推送	current 模式推送	incremental 模式推送
10:00	新闻A、新闻B	新闻A、新闻B	新闻A、新闻B
11:00	新闻A、新闻B、新闻C	新闻B、新闻C、新闻D	仅新闻C
12:00	新闻A、新闻B、新闻C	新闻C、新闻D、新闻E	仅新闻D、新闻E

格式元素	示例	含义	说明
🔥📈📌	🔥 [1/3] AI ChatGPT	热度等级	🔥高热度(≥10条) 📈中热度(5-9条) 📌普通热度(<5条)
[序号/总数]	[1/3]	排序位置	当前词组在所有匹配词组中的排名
频率词组	AI ChatGPT	关键词组	配置文件中的词组，标题必须包含其中词汇
: N 条	: 2 条	匹配数量	该词组匹配的新闻总数
[平台名]	[百度热搜]	来源平台	新闻所属的平台名称
🆕	🆕 ChatGPT-5正式发布	新增标记	本轮抓取中首次出现的热点
[数字]	[1]	高排名	排名≤阈值的热搜，红色加粗显示
[数字]	[7]	普通排名	排名>阈值的热搜，普通显示
- 时间	- 09时15分	首次时间	该新闻首次被发现的时间
[时间~时间]	[08时30分 ~ 10时45分]	持续时间	从首次出现到最后出现的时间范围
(N次)	(3次)	出现频率	在监控期间出现的总次数
新增区域	🆕 本次新增热点新闻	新话题汇总	单独展示本轮新出现的热点话题

镜像名称	用途	说明
`wantcat/trendradar`	新闻推送服务	定时抓取新闻、推送通知（必选）
`wantcat/trendradar-mcp`	AI 分析服务	MCP 协议支持、AI 对话分析（可选）

文件	用途	修改频率	说明
`config/config.yaml`	核心功能配置	低	报告模式、推送设置、存储格式、推送窗口、AI 分析开关、平台启用等全局行为控制
`config/frequency_words.txt`	关键词配置	高	设置你关心的热点词汇，支持分组、正则、别名等高级语法
`config/timeline.yaml`	时间线配置	低	控制新闻时间线的展示和过滤规则
`config/ai_analysis_prompt.txt`	AI 分析提示词	中	自定义 AI 分析的角色定义和输出格式（v5.0.0+）
`config/ai_translation_prompt.txt`	AI 翻译提示词	低	自定义 AI 翻译的提示词模板
`config/ai_interests.txt`	AI 兴趣过滤	中	定义 AI 基于兴趣自动过滤新闻的规则
`config/ai_filter/`	AI 过滤提示词	低	AI 过滤模块的内部提示词（一般无需修改）
`config/custom/`	用户自定义扩展	按需	`custom/ai/` 放自定义 AI 提示词，`custom/keyword/` 放自定义关键词文件
`docker/.env`	敏感信息 + Docker 特有配置	低	webhook URLs、API Key、S3 密钥、定时任务等，不会被 git 追踪

环境变量	对应配置	示例值	说明
`WEBSERVER_PORT`	-	`8080`	Web 服务器端口
`FEISHU_WEBHOOK_URL`	`notification.channels.feishu.webhook_url`	`https://...`	飞书 Webhook（多账号用 `;` 分隔）
`AI_ANALYSIS_ENABLED`	`ai_analysis.enabled`	`true` / `false`	是否启用 AI 分析（v5.0.0 新增）
`AI_API_KEY`	`ai.api_key`	`sk-xxx...`	AI API Key（ai_analysis 和 ai_translation 共享）
`AI_PROVIDER`	`ai.provider`	`deepseek` / `openai` / `gemini`	AI 提供商
`S3_*`	`storage.remote.*`	-	远程存储配置（5 个参数）

镜像名称	用途	说明
`wantcat/trendradar`	新闻推送服务	定时抓取新闻、推送通知
`wantcat/trendradar-mcp`	MCP 服务	AI 分析功能（可选）

文件位置	访问方式	适用场景
`output/index.html`	宿主机直接访问	Docker 部署（通过 Volume 挂载，宿主机可见）
`index.html`	根目录访问	GitHub Pages（仓库根目录，Pages 自动识别）
`output/html/YYYY-MM-DD/当日汇总.html`	历史报告访问	所有环境（按日期归档）

我想调整什么	修改哪个参数	默认值	说明
推送模式	`mode`	`daily`	决定推送时机和内容，详见推送模式详解
分组方式	`display_mode`	`keyword`	`keyword`=按关键词分组(如"AI")，`platform`=按平台分组(如"微博")
高亮重点	`rank_threshold`	`5`	排名在前 5 的新闻会加粗显示，一眼看到最火的
排序规则	`sort_by_position_first`	`false`	`false`=热度高的排前面，`true`=你配置的词排前面
数量限制	`max_news_per_keyword`	`0`	每个关键词最多看几条？`0`表示不限制
显示顺序	`display.region_order`	见上方配置	调整列表顺序即可控制各区域的显示位置

模式	分组方式	标题前缀	适用场景
`keyword`（默认）	按关键词聚合	`[平台名]`	我关注"AI"，想看各平台关于AI的新闻
`platform`	按平台聚合	`[关键词]`	我关注"微博"，想看微博上关于我关注词的新闻

区域	配置键	默认值	说明
热榜	`hotlist`	`true`	按关键词匹配的热点新闻聚合
新增热点	`new_items`	`false`	本轮新出现的热点话题（含热榜新增 + RSS 新增）。注：热榜区域中的 🆕 标记不受此开关影响
RSS	`rss`	`true`	按关键词匹配的 RSS 订阅内容。关闭后跳过 RSS 分析，但独立展示区中的 RSS 不受影响
独立展示区	`standalone`	`false`	指定平台/RSS 的完整内容展示，不受关键词过滤
AI 分析	`ai_analysis`	`true`	AI 生成的热点分析摘要

配置值	排序结果	你的想法
`false`（默认）	比亚迪(10条) → 特斯拉(3条)	"谁火谁排前面"
`true`	特斯拉(3条) → 比亚迪(10条)	"我配置的顺序就是优先级，不管它火不火"

模板名	说明	推送行为
`morning_evening`	全天增量 + 晚间汇总（推荐）	全天有新增就推 + 19:00-21:00 晚间当日汇总
`always_on`	全天候监控	全天有新增就推送，不划分时间段
`office_hours`	办公时间	工作日三段式（到岗速览→午间热点→收工汇总），周末增量自由推
`night_owl`	夜猫子	午后速览 + 深夜全天汇总（22:00-01:00 跨午夜）
`custom`	完全自定义	编辑 `timeline.yaml` 底部的 custom 段

我想要...	复制这行代码	说明
每小时一次	`- cron: "0 * * * *"`	默认配置，第 0 分钟运行
每 30 分钟	`- cron: "/30 * * *"`	每隔 30 分钟运行一次
每天早 8 点	`- cron: "0 0 * * *"`	⚠️ 写 `0` 是因为 UTC 时间 (0点) = 北京时间 (8点)
工作时间每半小时	`- cron: "/30 0-14 * *"`	对应北京时间 8:00 - 22:00
一日三餐点	`- cron: "0 0,6,12 * * *"`	对应北京时间 8:00、14:00、20:00

平台	配置方法	注意事项
飞书/钉钉/企微	用 `;` 分隔多个 Webhook URL	最简单，直接串起来就行
Bark (iOS)	用 `;` 分隔多个 Key URL	推送到多台 iPhone
Telegram	Token 和 ChatID 都要用 `;` 分隔	⚠️ 注意顺序要对应： Token1 对应 ChatID1 Token2 对应 ChatID2
ntfy	Topic 和 Token 都要用 `;` 分隔	如果某个Topic不需要Token，留空即可： `token1;;token3` (中间那个是空的)

📑 快速导航

早期支持者致谢

基础设施支持

数据支持

推广助力

观众支持

🪄 赞助商

🤝 二次开发与引用

💬 社区交流

🧩 作者的另一款工具：SanFrame

📝 更新日志

2026/10/13 - v6.11.0

2026/02/09 - mcp-v4.0.0

2026/06/19 - v6.10.0

2026/06/02 - v6.9.0

2026/05/23 - v6.8.0

2026/05/15 - v6.7.0

2026/03/28 - v6.6.0

2026/03/12 - v6.5.0

2026/02/09 - v6.0.0

2026/01/28 - v5.5.0

2026/02/02 - mcp-v3.2.0

2026/01/10 - mcp-v3.0.0~v3.1.5

2026/01/23 - v5.4.0

2026/01/19 - v5.3.0

2026/01/17 - v5.2.0

2026/01/10 - v5.0.0

2026/01/02 - v4.7.0

2025/12/30 - mcp-v2.0.0

2026/01/01 - v4.6.0

2025/12/30 - v4.5.0

2025/12/26 - mcp-v1.2.0

2025/12/20 - v4.0.3

2025/12/17 - v4.0.1

2025/12/13 - mcp-v1.1.0

2025/12/13 - v4.0.0

2025/12/03 - v3.5.0

2025/11/26 - mcp-v1.0.3

2025/11/28 - v3.4.1

2025/11/25 - v3.4.0

2025/11/24 - v3.3.0

2025/11/23 - v3.2.0

2025/11/18 - mcp-v1.0.2

2025/11/22 - v3.1.1

2025/11/20 - v3.1.0

2025/11/12 - v3.0.5

2025/10/26 - mcp-v1.0.1

2025/10/31 - v3.0.4

2025/10/23 - v3.0.3

2025/10/21 - v3.0.2

2025/10/20 - v3.0.0

2025/10/15 - v2.4.4

2025/10/10 - v2.4.3

2025/10/8 - v2.4.2

2025/10/2 - v2.4.0

2025/09/26 - v2.3.2

2025/09/22 - v2.3.1

2025/09/17 - v2.2.0

2025/09/13 - v2.1.2

2025/09/04 - v2.1.1

2025/08/30 - v2.1.0

2025/08/27 - v2.0.4

2025/08/06 - v2.0.3

2025/07/28 - v2.0.2

2025/07/27 - v2.0.1

2025/07/17 - v2.0.0

2025/07/09 - v1.4.1

2025/06/23 - v1.3.0

2025/06/21 - v1.2.1

2025/06/19 - v1.2.0

2025/06/18 - v1.1.0

2025/06/16 - v1.0.0

2025/06/13+14

2025/06/09

2025/06/02

2025/05/26

✨ 核心功能

全网热点聚合

RSS 订阅源支持（v4.5.0 新增）

可视化配置编辑器

2. 必须词 `+词汇` - 限定范围

3. 过滤词 `!词汇` - 排除干扰

4. 数量限制 `@数字` - 控制显示数量（v3.2.0 新增）

5. 全局过滤 `[GLOBAL_FILTER]` - 全局排除指定内容（v3.5.0 新增）

6. 正则表达式 `/pattern/` - 精确匹配模式（v4.7.0 新增）

7. 显示名称 `=> 备注` - 自定义显示文本（v4.7.0 新增）

你的运行环境	数据存在哪	说明
Docker / 本地运行	本地硬盘	存在项目目录下的 `output/` 文件夹里，随时可以查看。
GitHub Actions	云端存储	因为 GitHub Actions 运行完就会销毁环境，所以必须配置云存储（例如 Cloudflare R2）。

变量名	填什么
`STORAGE_BACKEND`	`remote`
`S3_BUCKET_NAME`	你的存储桶名字
`S3_ACCESS_KEY_ID`	你的 Access Key
`S3_SECRET_ACCESS_KEY`	你的 Secret Key
`S3_ENDPOINT_URL`	你的 R2 接口地址

变量名	填什么	说明
`AI_ANALYSIS_ENABLED`	`true`	开启开关
`AI_API_KEY`	`sk-xxxxxx`	你的 API Key
`AI_MODEL`	`deepseek/deepseek-chat`	模型标识（格式：`provider/model`）

提供商	AI_MODEL 填什么	说明
DeepSeek (推荐)	`deepseek/deepseek-chat`	性价比极高，适合高频分析
OpenAI	`openai/gpt-4o` `openai/gpt-4o-mini`	GPT-4o 系列
Google Gemini	`gemini/gemini-1.5-flash` `gemini/gemini-1.5-pro`	Gemini 系列
自定义 API	任意格式	配合 `AI_API_BASE` 使用

变量名	默认值	说明
`AI_API_BASE`	(自动)	自定义 API 地址（如 OneAPI、本地模型）
`AI_TEMPERATURE`	`1.0`	采样温度（0-2，越高越随机）
`AI_MAX_TOKENS`	`5000`	最大生成 token 数
`AI_TIMEOUT`	`120`	请求超时时间（秒）
`AI_NUM_RETRIES`	`2`	失败重试次数