点击跳转 AI 分析部署专区 使用 AI 功能 的最佳前提是已使用本项目至少推送一天(积累新闻数据)

本项目以轻量，易部署为目标。开源路上，感谢有你~😉

• 感谢耐心反馈 bug 的贡献者,你们的每一条反馈让项目更加完善;
• 感谢为项目点 star 的观众们,你们的每一个 star 都是对开源精神最好的支持;
• 感谢关注公众号并积极互动 的读者们,你们的留言、点赞、分享和推荐让内容更有温度;
• 感谢给予资金支持 的朋友们,你们的慷慨已化身为键盘旁的零食饮料,陪伴着项目的每一次迭代。

• 知乎
• 抖音
• bilibili 热搜
• 华尔街见闻
• 贴吧
• 百度热搜
• 财联社热门
• 澎湃新闻
• 凤凰网
• 今日头条
• 微博

默认监控 11 个主流平台，也可自行增加额外的平台

platforms:
  - id: "toutiao"
    name: "今日头条"
  - id: "baidu"  
    name: "百度热搜"
  - id: "wallstreetcn-hot"
    name: "华尔街见闻"
  # 添加更多平台...

三种推送模式：

附加功能 - 推送时间窗口控制（可选）：

此功能独立于上述三种推送模式,可与任意模式搭配使用:

• 时间窗口限制: 设定推送时间范围（如 09:00-18:00 或 20:00-22:00）,只在指定时间内推送
• 推送频率控制:
  • 窗口内多次推送: 时间窗口内每次执行都推送
  • 每天仅推送一次: 时间窗口内只推送一次（适合当日汇总或当前榜单模式）
• 典型场景:
  • 工作时间推送: 只在工作日 09:00-18:00 接收消息
  • 晚间汇总推送: 希望在晚上固定时间（如 20:00-22:00）收到汇总
  • 避免打扰: 防止非工作时间收到推送通知

提示: 此功能默认关闭,需在 config/config.yaml 中手动启用 push_window.enabled

设置个人关键词（如：AI、比亚迪、教育政策），只推送相关热点，过滤无关信息

• 支持普通词、必须词(+)、过滤词(!)三种语法，见【frequency_words.txt 配置教程】
• 词组化管理，独立统计不同主题热点

也可以不做筛选，完整的推送所有热点，具体见【历史更新】中的 v2.0.1

华为
OPPO
苹果

华为
OPPO
+手机

苹果
华为
!水果
!价格

iPhone
华为
OPPO
+发布

A股
上证
深证
+涨跌
!预测

世界杯
欧洲杯
亚洲杯
+比赛

# 第一步：先用宽泛关键词测试
人工智能
AI
ChatGPT

# 第二步：发现误匹配后，加入必须词限定
人工智能  
AI
ChatGPT
+技术

# 第三步：发现干扰内容后，加入过滤词
人工智能
AI  
ChatGPT
+技术
!广告
!培训

华为
OPPO
苹果
三星
vivo
一加
魅族
+手机
+发布
+销量
!假货
!维修
!二手

华为
OPPO
+新品

苹果
三星  
+发布

手机
销量
+市场

实时追踪新闻热度变化，让你不仅知道"什么在热搜"，更了解"热点如何演变"

• 时间轴追踪：记录每条新闻从首次出现到最后出现的完整时间跨度
• 热度变化：统计新闻在不同时间段的排名变化和出现频次
• 新增检测：实时识别新出现的热点话题，用🆕标记第一时间提醒
• 持续性分析：区分一次性热点话题和持续发酵的深度新闻
• 跨平台对比：同一新闻在不同平台的排名表现，看出媒体关注度差异

不再错过重要新闻的完整发展过程，从话题萌芽到高峰热议，全程掌握

不再被各个平台的算法牵着走，TrendRadar 会重新整理全网热搜：

• 看重排名高的新闻（占60%）：各平台前几名的新闻优先显示
• 关注持续出现的话题（占30%）：反复出现的新闻更重要
• 考虑排名质量（占10%）：不仅多次出现，还经常排在前列

把分散在各个平台的热搜合并起来，按照你关心的热度重新排序，这三个比例可以选择适合自己的场景进行调整

weight:
  rank_weight: 0.8    # 主要看排名
  frequency_weight: 0.1  # 不太在乎持续性
  hotness_weight: 0.1

weight:
  rank_weight: 0.4    # 适度看排名
  frequency_weight: 0.5  # 重视当天内的持续热度
  hotness_weight: 0.1

支持企业微信(+ 微信推送方案)、飞书、钉钉、Telegram、邮件、ntfy，消息直达手机和邮箱

• GitHub Pages：自动生成精美网页报告，PC/移动端适配
• Docker部署：支持多架构容器化运行
• 数据持久化：HTML/TXT多格式历史记录保存

基于 MCP (Model Context Protocol) 协议的 AI 对话分析系统，让你用自然语言深度挖掘新闻数据

• 对话式查询：用自然语言提问，如"查询昨天知乎的热点"、"分析比特币最近的热度趋势"
• 13 种分析工具：涵盖基础查询、智能检索、趋势分析、数据洞察、情感分析等
• 多客户端支持：Cherry Studio（GUI 配置）、Claude Desktop、Cursor、Cline 等
• 深度分析能力：
  • 话题趋势追踪（热度变化、生命周期、爆火检测、趋势预测）
  • 跨平台数据对比（活跃度统计、关键词共现）
  • 智能摘要生���、相似新闻查找、历史关联检索

告别手动翻阅数据文件，AI 助手帮你秒懂新闻背后的故事

GitHub 一键 Fork 即可使用，无需编程基础。

30秒部署： GitHub Pages（网页浏览）支持一键保存成图片，随时分享给他人

1分钟部署： 企业微信（手机通���）

💡 提示： 想要实时更新的网页版？fork 后，进入你的仓库 Settings → Pages，启用 GitHub Pages。效果预览。

从"被算法推荐绑架"变成"主动获取自己想要的信息"

适合人群： 投资者、自媒体人、企业公关、关心��事的普通用户

典型场景： 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取

升级说明：

• 提示：不要通过 Sync fork 更新本项目, 建议查看【历史更新】，明确具体的【升级方式】和【功能内容】
• 小版本更新：从 v2.x 升级到 v2.y, 用本项目的 main.py 代码替换你 fork 仓库中的对应文件
• 大版本升级：从 v1.x 升级到 v2.y, 建议删除现有 fork 后重新 fork，这样更省力且避免配置冲突

MCP 模块更新:

• 修复日期查询参数传递错误
• 统一所有工具的时间参数格式

• 扩大 ntfy 错误信息显示范围

+唐僧
+猪八戒

+唐僧
!唐僧念经

1. Fork 本项目到你的 GitHub 账户

   • 点击本页面右上角的"Fork"按钮

2. 设置 GitHub Secrets（选择你需要的平台）:

   在你 Fork 后的仓库中，进入 Settings > Secrets and variables > Actions > New repository secret，然后根据需要配置以下任一或多个通知平台：

   可以同时配置多个平台，系统会向所有配置的平台发送通知。

   👉 企业微信机器人（配置最简单最迅速）

   
   

   GitHub Secret 配置：

   • 名称：WEWORK_WEBHOOK_URL
   • 值：你的企业微信机器人 Webhook 地址

   机器人设置步骤：

   手机端设置：

   1. 打开企业微信 App → 进入目标内部群聊
   2. 点击右上角"…"按钮 → 选择"消息推送"
   3. 点击"添加" → 名称输入"TrendRadar"
   4. 复制 Webhook 地址，点击保存，复制的内容配置到上方的 GitHub Secret 中

   PC 端设置流程类似

   👉 飞书机器人（消息显示最友好）

   
   

   GitHub Secret 配置：

   • 名称：FEISHU_WEBHOOK_URL
   • 值：你的飞书机器人 Webhook 地址

   
   

   有两个方案，方案一配置简单，方案二配置复杂(老方法)

   其中方案一，由 ziventian发现并提供建议，在这里感谢他，默认是个人推送，也可以配置群组推送操作#97

   方案一：

   1. 电脑浏览器打开 https://botbuilder.feishu.cn/home/my-command

   2. 点击"新建机器人指令"

   3. 点击"选择触发器"，往下滑动，点击"Webhook 触发"

   4. 此时你会看到"Webhook 地址"，把这个链接先复制到本地记事本暂存，继续接下来的操作

   5. "参数"里面放上下面的内容，然后点击"完成"

   {
     "message_type": "text",
     "content": {
       "total_titles": "{{内容}}",
       "timestamp": "{{内容}}",
       "report_type": "{{内容}}",
       "text": "{{内容}}"
     }
   }

   1. 点击"选择操作" > "通过官方机器人发消息"

   2. 消息标题填写"TrendRadar 热点监控"

   3. 最关键的部分来了，点击 + 按钮，选择"Webhook 触发"，然后按照下面的图片摆放

   1. 配置完成后，将第 4 步复制的 Webhook 地址配置到 GitHub Secrets 中的 FEISHU_WEBHOOK_URL

   
   

   方案二：

   1. 电脑浏览器打开 https://botbuilder.feishu.cn/home/my-app

   2. 点击"新建机器人应用"

   3. 进入创建的应用后，点击"流程涉及" > "创建流程" > "选择触发器"

   4. 往下滑动，点击"Webhook 触发"

   5. 此时你会看到"Webhook 地址"，把这个链接先复制到本地记事本暂存，继续接下来的操作

   6. "参数"里面放上下面的内容，然后点击"完成"

   {
     "message_type": "text",
     "content": {
       "total_titles": "{{内容}}",
       "timestamp": "{{内容}}",
       "report_type": "{{内容}}",
       "text": "{{内容}}"
     }
   }

   1. 点击"选择操作" > "发送飞书消息"，勾选 "群消息"，然后点击下面的输入框，点击"我管理的群组"（如果没有群组，你可以在飞书 app 上创建群组）

   2. 消息标题填写"TrendRadar 热点监控"

   3. 最关键的部分来了，点击 + 按钮，选择"Webhook 触发"，然后按照下面的图片摆放

   1. 配置完成后，将第 5 步复制的 Webhook 地址配置到 GitHub Secrets 中的 FEISHU_WEBHOOK_URL
   👉 钉钉机器人

   
   

   GitHub Secret 配置：

   • 名称：DINGTALK_WEBHOOK_URL
   • 值：你的钉钉机器人 Webhook 地址

   机器人设置步骤：

   1. 创建机器人（仅 PC 端支持）：

      • 打开钉钉 PC 客户端，进入目标群聊
      • 点击群设置图标（⚙️）→ 往下翻找到"机器人"点开
      • 选择"添加机器人" → "自定义"

   2. ��置机器人：

      • 设置机器人名称
      • 安全设置：
        • 自定义关键词：设置 "热点"

   3. 完成设置：

      • 勾选服务条款协议 → 点击"完成"
      • 复制获得的 Webhook URL
      • 将 URL 配置到 GitHub Secrets 中的 DINGTALK_WEBHOOK_URL

   注意：移动端只能接收消息，无法创建新机器人。

   👉 Telegram Bot

   
   

   GitHub Secret 配置：

   • 名称：TELEGRAM_BOT_TOKEN - 你的 Telegram Bot Token
   • 名称：TELEGRAM_CHAT_ID - 你的 Telegram Chat ID

   机器人设置步骤：

   1. 创建机器人：

      • 在 Telegram 中搜索 @BotFather（大小写注意，有蓝色徽章勾勾，有类似 37849827 monthly users，这个才是官方的，有一些仿官方的账号注意辨别）
      • 发送 /newbot 命令创建新机器人
      • 设置机器人名称（必须以"bot"结尾，很容��遇到重复名字，所以你要绞尽脑汁想不同的名字）
      • 获取 Bot Token（格式如：123456789:AAHfiqksKZ8WmR2zSjiQ7_v4TMAKdiHm9T0）

   2. 获取 Chat ID：

      方法一：通过官方 API 获取

      • 先向你的机器人发送一条消息
      • 访问：https://api.telegram.org/bot<你的Bot Token>/getUpdates
      • 在返回的 JSON 中找到 "chat":{"id":数字} 中的数字

      方法二：使用第三方工具

      • 搜索 @userinfobot 并发送 /start
      • 获取你的用户 ID 作为 Chat ID

   3. 配置到 GitHub：

      • TELEGRAM_BOT_TOKEN：填入第 1 步获得的 Bot Token
      • TELEGRAM_CHAT_ID：填入第 2 步获得的 Chat ID
   👉 邮件推送（支持所有主流邮箱）

   
   

   • 注意事项：为防止邮件群发功能被滥用，当前的群发是所有收件人都能看到彼此的邮箱地址，适合熟人间交流资讯。
   • 仅供参考：请根据实际情况调整，邮箱方面并没有一一验证，是按照 SMTP 的标准配置的

   GitHub Secret 配置：

   • 名称：EMAIL_FROM - 发件人邮箱地址
   • 名称：EMAIL_PASSWORD - 邮箱密码或授权码
   • 名称：EMAIL_TO - 收件人邮箱地址（多个收件人用英文逗号分隔）
   • 名称：EMAIL_SMTP_SERVER - SMTP服务器地址（可选，留空则自动识别）
   • 名称：EMAIL_SMTP_PORT - SMTP端口（可选，留空则自动识别）

   常见邮箱设置：

   QQ邮箱：

   1. 登录 QQ邮箱网页版 → 设置 → 账户
   2. 开启 POP3/SMTP 服务
   3. 生成授权码（16位字母）
   4. EMAIL_PASSWORD 填写授权码，而非 QQ 密码

   Gmail：

   1. 开启两步验证
   2. 生成应用专用密码
   3. EMAIL_PASSWORD 填写应用专用密码

   163/126邮箱：

   1. 登录网页版 → 设置 → POP3/SMTP/IMAP
   2. 开启 SMTP 服务
   3. 设置客户端授权码
   4. EMAIL_PASSWORD 填写授权码

   高级配置： 如果自动识别失败，可手动配置 SMTP：

   • EMAIL_SMTP_SERVER：如 smtp.gmail.com
   • EMAIL_SMTP_PORT：如 587（TLS）或 465（SSL）

   ��收件人设置：

   • EMAIL_TO="user1@example.com,user2@example.com,user3@example.com"
   👉 ntfy 推送（开源免费，支持自托管）

   
   

   两种使用方式：

   方式一：免费使用（推荐新手） 🆓

   特点：

   • ✅ 无需注册账号，立即使用
   • ✅ 每天 250 条消息（足够 90% 用户）
   • ✅ Topic 名称即"密码"（需选择不易猜测的名称）
   • ⚠️ 消息未加密，不适合敏感信息, 但适合我们这个项目的不敏感信息

   快速开始：

   1. 下载 ntfy 应用：

      • Android：Google Play / F-Droid
      • iOS：App Store
      • 桌面：访问 ntfy.sh

   2. 订阅主题（选择一个难猜的名称）：

      建议格式：trendradar-{你的名字缩写}-{随机数字}
      
      不能使用中文
      
      ✅ 好例子：trendradar-zs-8492
      ❌ 坏例子：news、alerts（太容易被猜到）
      

   3. 配置 GitHub Secret：

      • NTFY_TOPIC：填写你刚才订阅的主题名称
      • NTFY_SERVER_URL：留空（默认使用 ntfy.sh）
      • NTFY_TOKEN：留空

   4. 测试：

      curl -d "测试消息" ntfy.sh/你的主题名称

   ---

   方式二：自托管（完全隐私控制） 🔒

   适合人群：有服务器、追求完全隐私、技术能力强

   优势：

   • ✅ 完全开源（Apache 2.0 + GPLv2）
   • ✅ 数据完全自主控制
   • ✅ 无任何限制
   • ✅ 零费用

   Docker 一键部署：

   docker run -d \
     --name ntfy \
     -p 80:80 \
     -v /var/cache/ntfy:/var/cache/ntfy \
     binwiederhier/ntfy \
     serve --cache-file /var/cache/ntfy/cache.db

   配置 TrendRadar：

   NTFY_SERVER_URL: https://ntfy.yourdomain.com
   NTFY_TOPIC: trendradar-alerts  # 自托管可用简单名称
   NTFY_TOKEN: tk_your_token  # 可选：启用访问控制

   在应用中订阅：

   • 点击"Use another server"
   • 输入你的服务器地址
   • 输入主题名称
   • （可选）输入登录凭据

   ---

   常见问题：

   Q1: 免费版够用吗？

   每天 250 条消息对大多数用户足够。按 30 分钟抓取一次计算，每天约 48 次推送，完全够用。

   Q2: Topic 名称真的安全吗？

   如果你选择随机的、足够长的名称（如 trendradar-zs-8492-news），暴力破解几乎不可能：

   • ntfy 有严格的速率限制（1 秒 1 次请求）
   • 64 个字符选择（A-Z, a-z, 0-9, _, -）
   • 10 位随机字符串有 64^10 种可能性（需要数年才能破解）

   ---

   推荐选择：

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

   相关链接：

   • ntfy 官方文档
   • 自托管教程
   • GitHub 仓库

3. 配置说明：:

   • 推送设置：在 config/config.yaml 中配置推送模式和通知选项
   • 关键词设置：在 config/frequency_words.txt 中添加你关心的关键词

   注意：建议只调整文档中明确说明的配置项，其他选项主要供作者开发时测试使用

# 创建配置目录并下载配置文件
mkdir -p config output
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/config.yaml -P config/
wget https://raw.githubusercontent.com/sansan0/TrendRadar/master/config/frequency_words.txt -P config/

当前目录/
└── config/
    ├── config.yaml
    └── frequency_words.txt

docker run -d --name trend-radar \
  -v ./config:/app/config:ro \
  -v ./output:/app/output \
  -e FEISHU_WEBHOOK_URL="你的飞书webhook" \
  -e DINGTALK_WEBHOOK_URL="你的钉钉webhook" \
  -e WEWORK_WEBHOOK_URL="你的企业微信webhook" \
  -e TELEGRAM_BOT_TOKEN="你的telegram_bot_token" \
  -e TELEGRAM_CHAT_ID="你的telegram_chat_id" \
  -e EMAIL_FROM="你的发件邮箱" \
  -e EMAIL_PASSWORD="你的邮箱密码或授权码" \
  -e EMAIL_TO="收件人邮箱" \
  -e CRON_SCHEDULE="*/30 * * * *" \
  -e RUN_MODE="cron" \
  -e IMMEDIATE_RUN="true" \
  wantcat/trendradar:latest

当前目录/
├── config/
│   ├── config.yaml
│   └── frequency_words.txt
└── docker/
    ├── .env
    └── docker-compose.yml

# 克隆项目
git clone https://github.com/sansan0/TrendRadar.git
cd TrendRadar

# 修改配置文件
vim config/config.yaml
vim config/frequency_words.txt

# 使用构建版本的 docker-compose
cd docker
cp docker-compose-build.yml docker-compose.yml

# 构建并启动
docker-compose build
docker-compose up -d

# 方式一：手动更新
docker pull wantcat/trendradar:latest
docker-compose down
docker-compose up -d

# 方式二：使用 docker-compose 更新
docker-compose pull
docker-compose up -d

# 查看运行状态
docker exec -it trend-radar python manage.py status

# 手动执行一次爬虫
docker exec -it trend-radar python manage.py run

# 查看实时日志
docker exec -it trend-radar python manage.py logs

# 显示当前配置
docker exec -it trend-radar python manage.py config

# 显示输出文件
docker exec -it trend-radar python manage.py files

# 查看帮助信息
docker exec -it trend-radar python manage.py help

# 重启容器
docker restart trend-radar

# 停止容器
docker stop trend-radar

# 删除容器（保留数据）
docker rm trend-radar

# 检查容器状态
docker inspect trend-radar

# 查看容器日志
docker logs --tail 100 trend-radar

# 进入容器调试
docker exec -it trend-radar /bin/bash

# 验证配置文件
docker exec -it trend-radar ls -la /app/config/

TrendRadar v3.0.0 新增了基于 MCP (Model Context Protocol) 的 AI 分析功能，让你可以通过自然语言与新闻数据对话，进行深度分析。部署的话在 5 分钟左右。最复杂的部分我都用一键双击操作替你们解决好了。

我发现大家都很善于靠自己解决未知的问题，这种勇气是值得鼓励和赞许的，但如果你卡住了好久，也可以在 issues 或者在公众号底部留言提问，这样我既能帮你，也能帮到更多其他探索中的小伙伴。

Cherry Studio 提供 GUI 配置界面，可快速部署。

详细教程：README-Cherry-Studio.md

注意：实际不建议一次性问多个问题。如果你选择的 ai 模型连按顺序调用都无法做到，建议换一个。

 我想了解'ai'这个话题，请依次完成以下步骤，并【展示每个步骤的完整结果】：

1. 搜索今天的相关新闻

2. 分析最近一周的热度趋势

3. 对比各平台的关注度

4. 分析最近一周的情感倾向

  【重要】：请将4个步骤的结果全部展示出来，不要只展示最后一步。

效果图：

详细教程：README-MCP-FAQ.md

图文教程现已更新到我的公众号，回复 "mcp" 即可

心意到就行，收到的点赞用于提高开发者开源的积极性。点赞已收录于致谢名单

• GitHub Issues：适合针对性强的解答。提问时请提供完整信息（截图、错误日志、系统环境等）。
• 公众号交流：适合快速咨询。建议优先在相关文章下的公共留言区交流，如私信，请文明礼貌用语😉

4 篇文章：

• 可在该文章下方留言，方便项目作者用手机答疑
• 2个月破 1000 star，我的GitHub项目推广实战经验
• github fork 运行本项目的注意事项
• 基于本项目，如何开展公众号或者新闻资讯类文章写作

AI 开发：

• 如果你有小众需求，完全可以基于我的项目自行开发，零编程基础的也可以试试
• 我所有的开源项目或多或少都使用了自己写的AI辅助软件来提升开发效率，这款工具已开源
• 核心功能：迅速筛选项目代码喂给AI，你只需要补充个人需求即可
• 项目地址：https://github.com/sansan0/ai-code-context-helper

📍 毛主席足迹地图 - 交互式动态展示1893-1976年完整轨迹。欢迎诸位同志贡献数据

• https://github.com/sansan0/mao-map

哔哩哔哩(bilibili)评论区数据可视化分析软件

• https://github.com/sansan0/bilibili-comment-analyzer

flowchart TD
    A[👤 用户开始] --> B{🚀 选择部署方式}
    
    B -->|云端部署| C1[🍴 Fork 项目到 GitHub]
    B -->|本地部署| C2[🐳 Docker 部署]
    
    C1 --> D[⚙️ 配置通知渠道<br/>可同时配置多个]
    C2 --> D
    
    D --> E[选择通知方式：<br/>📱企业微信 💬飞书 🔔钉钉<br/>📟Telegram 📧邮件]
    
    E --> F[🔑 填写通知参数<br/>GitHub Secrets 或环境变量]
    
    F --> G[📝 配置关键词<br/>config/frequency_words.txt<br/>普通词/必须词+/过滤词!]
    
    G --> H[🎯 选择运行模式<br/>config/config.yaml]
    
    H --> H1[📋 daily - 当日汇总<br/>定时推送所有匹配新闻]
    H --> H2[📰 current - 当前榜单<br/>定时推送最新榜单]
    H --> H3[📈 incremental - 增量监控<br/>仅推送新增内容]
    
    H1 --> I[可选：推送时间窗口控制<br/>⏰ 限制推送时间范围]
    H2 --> I
    H3 --> I
    
    I --> J[✅ 配置完成]
    
    J --> K[🤖 系统自动运行]
    
    K --> L[🕷️ 爬取11+平台热点]
    L --> M[🔍 关键词筛选]
    M --> N[⚖️ 权重算法排序<br/>排名60% + 频次30% + 热度10%]
    N --> O[📊 生成报告<br/>HTML网页 + 推送消息]
    O --> P[📱 多渠道推送通知]
    
    P --> Q[🎉 持续接收精准推送<br/>告别信息过载]
    
    style A fill:#e3f2fd
    style B fill:#f3e5f5
    style D fill:#fff3e0
    style F fill:#fff9c4
    style G fill:#e8f5e9
    style H fill:#e0f2f1
    style I fill:#fce4ec
    style O fill:#e1bee7
    style Q fill:#c8e6c9

GPL-3.0 License