TrendRadar

# 🎯 TrendRadar **你的专属热点助手 —— 让手机只推送你真正关心的新闻** 🚀 最快一分钟部署完毕！从此告别无效刷屏，只看有价值的信息 [](https://github.com/sansan0/TrendRadar/stargazers) [](https://github.com/sansan0/TrendRadar/network/members) [](LICENSE) [](https://www.python.org/) [](https://github.com/sansan0/TrendRadar) [](https://work.weixin.qq.com/) [](https://telegram.org/) [](#) [](https://www.feishu.cn/) [](https://github.com/sansan0/TrendRadar) [](https://sansan0.github.io/TrendRadar)

---

如果本项目对你有所帮助，点个 Star ⭐ 就是对我最大的支持。

遇到问题可以直接提 issues，我会认真回复每一个。也可以关注【硅基茶水间】公众号，那里我会分享开源项目的思路和经验。

我从 2025 年 4 月末开始经常开源项目，之前一直各种使用其他大佬的开源项目，虽然也勤于 star, 但确实更多的是在"白嫖"。现在想通过自己的项目回馈开源社区，同时记录这个过程中的收获和思考。

本账号专门用来维护开源项目。如果你也在做开源，或者对开源感兴趣，欢迎一起交流。

---

✨ 核心功能

全网热点聚合

一次监控 11+ 个主流平台（微博、知乎、抖音、百度等），再也不用逐个 APP 刷新闻）

理论上支持 35 个左右的平台，我默认只放了 11 个，想增加什么股票等金融相关资讯的，需要你自己手动添加，有需求的看最下方的高级用法

智能推送策略

提供两种工作模式满足不同需求：默认模式持续追踪热点排名变化、出现频次和时间跨度，定时推送完整分析报告（也包括新增热点）；增量模式仅检测新增热点，无新内容时不推送，避免信息噪音

默认模式适合全面了解热点趋势，增量模式适合高频监控（≤30 分钟）场景，专注最新动态而非持续热度

精准内容筛选

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

比如关注"新能源"，自动筛选出特斯拉降价、政策补贴等相关新闻

多渠道实时推送

支持企业微信、飞书、钉钉、Telegram 主流聊天工具，消息直达手机

零技术门槛部署

GitHub 一键 Fork 即可使用，无需服务器，无需编程基础。如果要手机接收通知， 要达到 1 分钟部署完毕的效果，请选择企业微信

就，很快

减少 APP 依赖

不再需要频繁打开各种资讯 APP，有效控制手机使用时间

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

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

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

💡 提示： 想要网页版？启用 GitHub Pages 即可获得自动更新的新闻页面。进入你的仓库 Settings → Pages，启用后就能获得专属链接，比如我这里TrendRadar。

📝 更新日志

升级说明： 已fork的同学，如果想获得最新功能：只需把本项目中 main.py 的所有代码替换掉你的旧代码即可（直接 GitHub 网页上编辑）。

2025/07/08 - v1.4.1

功能新增：增加增量推送(在 main.py 头部配置 FOCUS_NEW_ONLY)，该开关只关心新话题而非持续热度，只在有新内容时才发通知。

修复问题: 某些情况下，由于新闻本身含有特殊符号导致的偶发性排版异常。

📝 查看历史更新

### 2025/06/23 - v1.3.0 企业微信 和 Telegram 的推送消息有长度限制，对此我采用将消息拆分推送的方式。开发文档详见[企业微信](https://developer.work.weixin.qq.com/document/path/91770) 和 [Telegram](https://core.telegram.org/bots/api) ### 2025/06/21 - v1.2.1 在本版本之前的旧版本，不仅 main.py 需要复制替换， crawler.yml 也需要你复制替换 https://github.com/sansan0/TrendRadar/blob/master/.github/workflows/crawler.yml ### 2025/06/19 - v1.2.0 > 感谢 claude research 整理的各平台 api ,让我快速完成各平台适配（虽然代码更多冗余了~ 1. 支持 telegram ，企业微信，钉钉推送渠道, 支持多渠道配置和同时推送 ### 2025/06/18 - v1.1.0 > **200 star⭐** 了, 继续给大伙儿助兴~近期，在我的"怂恿"下，挺多人在我公众号点赞分享推荐助力了我，我都在后台看见了具体账号的鼓励数据，很多都成了天使轮老粉（我玩公众号才一个多月，虽然注册是七八年前的事了哈哈，属于上车早，发车晚），但因为你们没有留言或私信我，所以我也无法一一回应并感谢支持，在此一并谢谢！ 1. 重要的更新，加了权重，你现在看到的新闻都是最热点最有关注度的出现在最上面 2. 更新文档使用，因为近期更新了很多功能，而且之前的使用文档我偷懒写的简单（见下面的 ⚙️ frequency_words.txt 配置完整教程） ### 2025/06/16 - v1.0.0 1. 增加了一个项目新版本更新提示，默认打开，如要关掉，可以在 main.py 中把 "FEISHU_SHOW_VERSION_UPDATE": True 中的 True 改成 False 即可 ### 2025/06/13+14 1. 去掉了兼容代码，之前 fork 的同学，直接复制代码会在当天显示异常（第二天会恢复正常） 2. feishu 和 html 底部增加一个新增新闻显示 ### 2025/06/09 **100 star⭐** 了，写个小功能给大伙儿助助兴 frequency_words.txt 文件增加了一个【必须词】功能，使用 + 号 1. 必须词语法如下： 唐僧或者猪八戒必须在标题里同时出现，才会收录到推送新闻中 ``` +唐僧 +猪八戒 ``` 2. 过滤词的优先级更高： 如果标题中过滤词匹配到唐僧念经，那么即使必须词里有唐僧，也不显示 ``` +唐僧 !唐僧念经 ``` ### 2025/06/02 1. **网页**和**飞书消息**支持手机直接跳转详情新闻 2. 优化显示效果 + 1 ### 2025/05/26 1. 飞书消息显示效果优化

优化前

优化后

🔍 支持的平台

目前已支持以下 11 个热门平台:

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

🚀 使用方式

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. 点击"添加" → 点击"新建" → 设置机器人昵称
4. 复制 Webhook 地址，配置到上方的 GitHub Secret 中

#### PC 端设置流程类似

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

GitHub Secret 配置：

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

机器人设置步骤：

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": "{{内容}}"
    }
   }
   

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

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

9. 最关键的部分来了，点击 + 按钮，选择"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

自定义关键词:

• 修改frequency_words.txt文件，添加你关心的关键词
  

⚙️ 点击查看 frequency_words.txt 完整配置教程

在 `frequency_words.txt` 文件中配置监控的关键词，支持三种语法和词组功能。 ### 📋 基础语法说明 #### 1. **普通关键词** - 基础匹配 ```txt 华为 OPPO 苹果 ``` **作用：** 新闻标题包含其中**任意一个词**就会被捕获 #### 2. **必须词** `+词汇` - 限定范围 ```txt 华为 OPPO +手机 ``` **作用：** 必须同时包含普通词**和**必须词才会被捕获 #### 3. **过滤词** `!词汇` - 排除干扰 ```txt 苹果 华为 !水果 !价格 ``` **作用：** 包含过滤词的新闻会被**直接排除**，即使包含关键词 ### 🔗 词组功能 - 空行分隔的重要作用 **核心规则：** 用**空行**分隔不同的词组，每个词组独立统计 #### 示例配置： ```txt iPhone 华为 OPPO +发布 A股 上证 深证 +涨跌 !预测 世界杯 欧洲杯 亚洲杯 +比赛 ``` #### 词组解释及匹配效果： **第1组 - 手机新品类：** - 关键词：iPhone、华为、OPPO - 必须词：发布 - 效果：必须包含手机品牌名，同时包含"发布" **匹配示例：** - ✅ "iPhone 15正式发布售价公布" ← 有"iPhone"+"发布" - ✅ "华为Mate60系列发布会直播" ← 有"华为"+"发布" - ✅ "OPPO Find X7发布时间确定" ← 有"OPPO"+"发布" - ❌ "iPhone销量创新高" ← 有"iPhone"但缺少"发布" **第2组 - 股市行情类：** - 关键词：A股、上证、深证 - 必须词：涨跌 - 过滤词：预测 - 效果：包含股市相关词，同时包含"涨跌"，但排除包含"预测"的内容 **匹配示例：** - ✅ "A股今日大幅涨跌分析" ← 有"A股"+"涨跌" - ✅ "上证指数涨跌原因解读" ← 有"上证"+"涨跌" - ❌ "专家预测A股涨跌趋势" ← 有"A股"+"涨跌"但包含"预测" - ❌ "A股成交量创新高" ← 有"A股"但缺少"涨跌" **第3组 - 足球赛事类：** - 关键词：世界杯、欧洲杯、亚洲杯 - 必须词：比赛 - 效果：必须包含杯赛名称，同时包含"比赛" **匹配示例：** - ✅ "世界杯小组赛比赛结果" ← 有"世界杯"+"比赛" - ✅ "欧洲杯决赛比赛时间" ← 有"欧洲杯"+"比赛" - ❌ "世界杯门票开售" ← 有"世界杯"但缺少"比赛" ### 🎯 配置技巧 #### 1. **从宽到严的配置策略** ```txt # 第一步：先用宽泛关键词测试 人工智能 AI ChatGPT # 第二步：发现误匹配后，加入必须词限定 人工智能 AI ChatGPT +技术 # 第三步：发现干扰内容后，加入过滤词 人工智能 AI ChatGPT +技术 !广告 !培训 ``` #### 2. **避免过度复杂** ❌ **不推荐：** 一个词组包含太多词汇 ```txt 华为 OPPO 苹果 三星 vivo 一加 魅族 +手机 +发布 +销量 !假货 !维修 !二手 ``` ✅ **推荐：** 拆分成多个精确的词组 ```txt 华为 OPPO +新品 苹果 三星 +发布 手机 销量 +市场 ```

自动运行:

• 项目已包含.github/workflows/crawler.yml配置文件，默认每 50 分钟自动运行一次
• 你也可以在 GitHub 仓库的 Actions 页面手动触发运行

查看结果:

• 运行结果将自动保存在仓库的output目录中
• 同时通过配置的机器人发送通知到你的群组

📊 输出示例

通知示例：

📊 热点词汇统计

🔥 人工智能 AI : 12 条

  1. [百度热搜] 科技巨头发布新AI模型 [1] - 12时30分 (4次)

  2. [今日头条] AI技术最新突破 [2] - [13时15分 ~ 14时30分] (2次)

消息格式说明

格式元素	示例	含义	说明
关键词	人工智能 AI	频率词组	表示本组匹配的关键词
: N 条	: 12 条	匹配数量	该关键词组匹配的标题总数
[平台名]	[百度热搜]	来源平台	标题所属的平台名称
[数字]	[1]	高排名标记	排名 ≤ 阈值(默认 5)的热搜，红色加粗显示
[数字]	[7]	普通排名标记	排名>阈值的热搜，普通显示
- 时间	- 12 时 30 分	首次发现时间	标题首次被发现的时间
[时间 ~ 时间]	[12 时 30 分 ~ 14 时 00 分]	时间范围	标题出现的时间范围(首次~最后)
(N 次)	(4 次)	出现次数	标题在监控期间出现的总次数

🔧 高级用法

自定义监控平台

本项目的数据来源于 newsnow 项目，你可以点击这个网站，点击里面的【更多】，可以看到所有支持的平台。如果你想支持更多平台或者不想看某些平台，可以访问 https://github.com/ourongxing/newsnow/tree/main/server/sources ，根据里面的文件名来调整 main.py 中的下面代码(如果不懂怎么看这些代码，也可以去我公众号留言)：

ids = [
    ("toutiao", "今日头条"),
    ("baidu", "百度热搜"),
    ("wallstreetcn-hot", "华尔街见闻"),
    ("thepaper", "澎湃新闻"),
    ("bilibili-hot-search", "bilibili 热搜"),
    ("cls-hot", "财联社热门"),
    ("ifeng", "凤凰网"),
    "tieba",
    "weibo",
    "douyin",
    "zhihu",
]

❓ 常见问题

1. GitHub Actions 不执行怎么办？

   • 检查.github/workflows/crawler.yml文件是否存在
   • 在 Actions 页面手动触发一次 workflow
   • 确认你有足够的 GitHub Actions 免费分钟数

2. 没有收到飞书通知怎么办？

   • 检查FEISHU_WEBHOOK_URL是否正确设置（环境变量或 CONFIG 中）
   • 检查飞书机器人是否仍在群内且启用
   • 查看程序输出中是否有发送失败的错误信息
   • 确认飞书流程配置中的参数结构正确

3. 想要停止手机接收新闻通知消息？

   • 将ENABLE_NOTIFICATION设置为False

4. 想要停止在本地继续生成新闻数据？

   • 将ENABLE_CRAWLER设置为False

📧 学习交流

扫码关注微信公众号，里面有文章是讲我写的这些项目的，咳如果对你有了点帮助，献上【点赞,转发,推荐】三连，就算支持了俺这个作者的开发了，顺便也可以反馈使用问题：


Star History

🙏 致谢

本项目使用了 newsnow 提供的 API 服务，感谢其提供的数据支持。

📄 许可证

GPL-3.0 License

---

**⭐ 如果这个工具对你有帮助，请给项目点个 Star 支持开发！** [🔝 回到顶部](#TrendRadar-多平台热点资讯监控分析系统)