TrendRadar：聚合多平台热点新闻并按关键词推送到即时通讯软件

TrendRadar 是一个帮助用户聚合多个网络平台热点信息的工具，旨在解决信息过载问题。 它能自动监控包括今日头条、百度、微博、知乎在内的超过35个平台的热搜榜单。 用户可以设置自己关心的关键词，TrendRadar 会筛选出只与这些关键词相关的新闻，并将结果生成分析报告。 这份报告可以通过企业微信、飞书、钉钉或Telegram 等多种渠道直接推送到用户的手机上，实现快速提醒。 该项目最大的特点是部署简单，普通用户不需要编程知识，只需要在GitHub上进行简单操作，最快30秒就能部署一个网页版，1分钟就能设置好手机通知。 它让用户从被动接收算法推荐信息，转变为主动获取自己真正需要的新闻。

Function List

• 全网热点聚合: 自动监控今日头条、百度热搜、微博、B站等超过35个主流平台的热点新闻。
• 智能推送策略: 提供三种信息推送模式：incremental模式仅在出现新内容时推送，适合需要及时获取新增资讯的投资者；current模式推送当前实时热点，适合媒体工作者；daily模式每日定时发送汇总报告，适合普通用户。
• 精准内容筛选: 用户可以自定义关键词文件，通过“必须包含词”、“过滤词”等规则，精确筛选出自己关心的特定新闻，有效过滤无关信息。
• 多渠道实时推送: 支持将筛选后的热点信息推送到企业微信、飞书、钉钉和Telegram，方便用户在手机端实时接收。
• 零门槛快速部署: 无需编程基础，通过Fork GitHub仓库的方式即可完成部署。支持生成公开网页（GitHub Pages）或通过Docker进行私有化部署。
• 减少应用依赖: 用户无需在手机上安装多个新闻客户端，通过一个推送渠道就能掌握所有关心的信息。

Using Help

TrendRadar 的设计目标是让没有编程基础的用户也能轻松上手，主要通过在GitHub网站上直接操作来完成部署和配置。

方式一：30秒部署网页版（最简单）

这种方式会生成一个公开的网页，展示你所关心的热点新闻。

1. Project Fork: 在浏览器中打开TrendRadar的GitHub页面 https://github.com/sansan0/TrendRadar，点击页面右上角的 Fork 按钮，将项目复制到你自己的GitHub账户下。
2. 启用GitHub Pages: 在你Fork后的仓库页面，点击上方的 Settings 标签，然后在左侧菜单中选择 PagesThe In Branch 部分，选择 master 分支，并点击 Save。等待几分钟，页面会显示你的网页地址，之后便可通过该网址访问。

方式二：1分钟配置手机推送（推荐）

这种方式可以将筛选后的新闻直接推送到你的手机聊天软件中，实现实时提醒。

第一步：Fork项目
同上，首先需要将项目 Fork 到你自己的GitHub账户。

第二步：配置推送渠道的机器人
你需要选择一个接收消息的平台（企业微信、飞书、钉钉、Telegram），并获取其机器人 Webhook 地址。 Webhook 地址就像一个专属的收信地址，TrendRadar会将消息发送到这个地址。

in order to企业微信为例，它的配置最简单快捷：

1. 在企业微信的群聊中，点击右上角的“…”图标，选择“群机器人”。
2. 点击“添加”，然后“新建一个机器人”，给它取一个名字。
3. 创建成功后，复制生成的 Webhook 地址，这是一串以 https://qyapi.weixin.qq.com/... 开头的网址。

第三步：在GitHub中设置Secrets
Secrets 是GitHub用来存放私密信息（如密码、密钥）的地方，非常安全。

1. 在你Fork后的仓库页面，点击上方的 Settings Tags.
2. 在左侧菜单中选择 Secrets and variablesand then click ActionsThe
3. Click on the green New repository secret Button.
4. 根据你选择的平台，填写对应的名称和值：
   • 企业微信: 名称填写 WEWORK_WEBHOOK_URL，值粘贴上一步复制的 Webhook 地址。
   • obscure or illegible writing: 名称填写 FEISHU_WEBHOOK_URLThe
   • staple: 名称填写 DINGTALK_WEBHOOK_URLThe
   • Telegram: 需要配置两个，分别是 TELEGRAM_BOT_TOKEN cap (a poem) TELEGRAM_CHAT_IDThe
5. strike (on the keyboard) Add secret 保存即可。你可以同时配置多个平台的Secret，系统会向所有已配置的平台发送通知。

第四步：配置关键词
这是最核心的一步，决定了你会收到哪些新闻。

1. 在你的仓库页面，找到并点击 config 文件夹，然后点击 frequency_words.txt Documentation.
2. 点击文件右上角的铅笔图标（Edit this file）来编辑内容。
3. 文件支持三种语法：
   • 普通词: 直接输入词语，如 人工智能。标题中包含该词就会被选中。
   • 必须词: 在词语前加 + 号，如 +手机。标题中必须同时包含普通词和带 + 的词才会被选中。例如，你可以配置 苹果 +发布会，这样就不会匹配到关于“苹果”水果的新闻。
   • 过滤词: 在词语前加 ! 号，如 !广告。标题如果包含带 ! 的词，即使它也包含了普通词，也会被直接排除。
4. 词组功能: 用一个空行来分隔不同的关键词组。每个词组会独立统计和推送，逻辑更清晰。
   • typical example::

     # 第一组：关于科技公司新品
     苹果 华为 +发布会 !二手
     # 第二组：关于股市动态
     A股 上证 +涨跌 !预测
     ```        这个配置会推送“苹果”或“华为”的“发布会”新闻（但排除“二手”信息），同时也会推送“A股”或“上证”的“涨跌”新闻（但排除“预测”类信息）。
     

第五步：手动触发运行
配置完成后，可以立即测试一次。

1. 点击仓库上方的 Actions Tags.
2. 在左侧选择 All workflows lower CrawlerThe
3. Click on the right side of the Run workflow 按钮，再次点击弹出的绿色 Run workflow Button.
   程序会自动运行，几分钟后，你配置的手机软件就会收到第一条热点推送。之后，它会根据预设的配置（默认每小时）自动运行。

application scenario

1. 投资者和交易员
   监控股市相关信息，可以设置 A股,美股,财报,涨跌 等关键词，并结合 + 号来精确匹配 +收购,+融资 等必须词，同时使用增量模式（incremental），确保第一时间获取可能影响市场的最新资讯。
2. 自媒体和内容创作者
   追踪行业热点和突发事件，可以设置自己创作领域相关的关键词，如 AI,游戏,电影，并使用当前榜单模式（current），快速掌握实时热点，寻找创作灵感。
3. 企业公关和市场人员
   进行品牌舆情监控，可以设置公司自身品牌、竞品品牌以及行业相关的关键词，及时发现网络上的相关讨论和新闻，并过滤掉 !招聘,!广告 等无关信息。
4. regular user
   替代多个新闻APP，只关注自己感兴趣的话题。例如，可以设置 世界杯 +比赛 来关注体育赛事，或设置 教育 +政策 来了解相关动态，使用每日汇总模式（daily），每天定时接收一份定制的新闻简报。

QA

1. 使用这个工具需要自己有服务器吗？
   不需要。最基础的用法完全依赖GitHub的免费服务（GitHub Actions和GitHub Pages），你只需要一个GitHub账号即可，整个过程都在网页上完成。
2. Is this tool free?
   是的，TrendRadar是一个开源项目，所有核心功能都可以免费使用。
3. 信息更新的频率是多久？
   默认配置是每小时自动运行一次。用户如果懂GitHub Actions的配置，也可以自行修改 .github/workflows/crawler.yml in the file cron 表达式来调整运行频率。
4. 我能添加默认列表之外的新闻网站吗？
   可以。TrendRadar的数据依赖于一个名为newsnow的项目。你可以在 config/config.yaml 文件中参照现有格式，添加该项目支持的其他平台ID。
5. 如果我不想看所有新闻，只想看和关键词匹配的，该如何设置？
   (coll.) fail (a student) config/frequency_words.txt 文件不为空时，系统默认只推送和关键词匹配的新闻。如果该文件为空，则会推送所有平台的热点新闻。