⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载,你的 AI 舆情监控助手与热点筛选工具!聚合多平台热点 + RSS 订阅,支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机,也支持接入 MCP 架构,赋能 AI 自然语言对话分析、情感洞察与趋势预测等。支持 Docker ,数据本地/云端自持。集成微信/飞书/钉钉/Telegram/邮件/ntfy/bark/slack 等渠道智能推送。
Python aibarkdata-analysisdockerhot-newsllmmailmcpmcp-servernewsntfypythonrsstrending-topicswechatwework
docs: 重构 README 文档结构,优化使用体验
sansan8258b798f0d2
diff --git a/README-EN.md b/README-EN.mdindex 05b40f435e..c47b468642 100644--- a/README-EN.md+++ b/README-EN.md@@ -44,10 +44,10 @@<div align="center">-| [🎯 Core Features](#-core-features) | [🚀 Quick Start](#-quick-start) | [🐳 Docker Deployment](#-docker-deployment) | [🤖 AI Analysis](#-ai-analysis-deployment) |+| [🎯 Core Features](#-core-features) | [🚀 Quick Start](#-quick-start) | [⚙️ Configuration Guide](#-configuration-guide) | [🐳 Docker Deployment](#-docker-deployment) ||:---:|:---:|:---:|:---:|-| [📝 Changelog](#-changelog) | [🔌 MCP Clients](#-mcp-clients) | [❓ FAQ & Support](#-faq--support) | [⭐ Related Projects](#-related-projects) |-| [🔧 Custom Platforms](#custom-monitoring-platforms) | [📝 Keywords Config](#frequencywordstxt-configuration) | [🪄 Sponsors](#-sponsors) | |+| [🤖 AI Analysis](#-ai-analysis) | [🔌 MCP Clients](#-mcp-clients) | [📝 Changelog](#-changelog) | [❓ FAQ & Support](#-faq--support) |+| [⭐ Related Projects](#-related-projects) | [🪄 Sponsors](#-sponsors) | | |</div>@@ -56,11 +56,19 @@- Thanks to **followers**, your interactions make the content more meaningful 😎<details>-<summary>👉 Click to view <strong>Acknowledgments</strong> (Current <strong>🔥71🔥</strong> supporters)</summary>+<summary>👉 Click to view <strong>Acknowledgments</strong> (Current <strong>🔥72🔥</strong> supporters)</summary>++### Infrastructure Support++Thanks to **GitHub** for providing free infrastructure, which is the biggest prerequisite for this project to run conveniently with **one-click fork**.### Data Support-This project uses the API from [newsnow](https://github.com/ourongxing/newsnow) to fetch multi-platform data+This project uses the API from [newsnow](https://github.com/ourongxing/newsnow) to fetch multi-platform data. Special thanks to the author for providing this service.++After communication, the author indicated no concerns about server pressure, but this is based on their goodwill and trust. Please everyone:+- **Visit the [newsnow project](https://github.com/ourongxing/newsnow) and give it a star**+- When deploying with Docker, please control the frequency reasonably and avoid being overly greedy### Promotion Support@@ -73,6 +81,8 @@ This project uses the API from [newsnow](https://github.com/ourongxing/newsnow)### Community Support> Thanks to **financial supporters**. Your generosity has transformed into snacks and drinks beside my keyboard, accompanying every iteration of this project+>+> **"One-yuan appreciation"** has been suspended. If you still want to support the author, please visit the [official account](#-faq--support) article and click "Like Author" at the bottom.| Supporter | Amount (CNY) | Date | Note || :-------: | :----------: | :--: | :--: |@@ -120,53 +130,32 @@ This project uses the API from [newsnow](https://github.com/ourongxing/newsnow)Default monitoring of 11 mainstream platforms, with support for adding custom platforms.-<details id="custom-monitoring-platforms">-<summary><strong>👉 Click to expand: Custom Monitoring Platforms</strong></summary>-<br>--The news data comes from [newsnow](https://github.com/ourongxing/newsnow). You can visit the [website](https://newsnow.busiyi.world/) and click [More] to see if your desired platform is available.--To add platforms, visit the [source code](https://github.com/ourongxing/newsnow/tree/main/server/sources), and modify the `platforms` configuration in `config/config.yaml`:--```yaml-platforms:- - id: "toutiao"- name: "Toutiao"- - id: "baidu"- name: "Baidu Hot"- - id: "wallstreetcn-hot"- name: "Wallstreetcn"- # Add more platforms...-```--If you're unsure, you can copy from [community-shared configurations](https://github.com/sansan0/TrendRadar/issues/95).--</details>+> 💡 For detailed configuration, see [Configuration Guide - Platform Configuration](#1-platform-configuration)### **Smart Push Strategies****Three Push Modes**:-| Mode | Target Users | Push Timing | Display Content | Use Case |-|------|--------------|-------------|-----------------|----------|-| **Daily Summary**<br/>`daily` | 📋 Managers/Regular Users | Scheduled push (default: hourly) | All matched news of the day<br/>+ New news section | Daily reports<br/>Comprehensive trend overview |-| **Current Rankings**<br/>`current` | 📰 Content Creators | Scheduled push (default: hourly) | Current ranking matches<br/>+ New news section | Real-time hot topics<br/>What's trending now |-| **Incremental Monitor**<br/>`incremental` | 📈 Traders/Investors | Push only when new | Newly appeared matching news | Avoid duplicate info<br/>High-frequency monitoring |+| Mode | Target Users | Push Feature |+|------|--------------|--------------|+| **Daily Summary** (daily) | Managers/Regular Users | Push all matched news of the day (includes previously pushed) |+| **Current Rankings** (current) | Content Creators | Push current ranking matches (continuously ranked news appear each time) |+| **Incremental Monitor** (incremental) | Traders/Investors | Push only new content, zero duplication |-**Additional Feature - Push Time Window Control** (Optional):+> 💡 **Quick Selection Guide:**+> - 🔄 Don't want duplicate news → Use `incremental`+> - 📊 Want complete ranking trends → Use `current`+> - 📝 Need daily summary reports → Use `daily`+>+> For detailed comparison and configuration, see [Configuration Guide - Push Mode Details](#3-push-mode-details)-This feature works independently with any push mode:+**Additional Feature - Push Time Window Control** (Optional):-- **Time Window Limit**: Set push time range (e.g., 09:00-18:00 or 20:00-22:00)-- **Push Frequency Control**:- - Multiple pushes within window: Push every execution- - Once per day: Only push once within window (suitable for daily/current modes)-- **Typical Scenarios**:- - Work hours push: Only receive messages during 09:00-18:00 on weekdays- - Evening summary: Receive summary at fixed evening time (e.g., 20:00-22:00)- - Do not disturb: Prevent notifications during non-work hours+- Set push time range (e.g., 09:00-18:00), push only within specified time+- Configure multiple pushes within window or once per day+- Avoid notifications during non-work hours-> Tip: This feature is disabled by default, enable it manually in `config/config.yaml` with `push_window.enabled`+> 💡 This feature is disabled by default, see [Quick Start](#-quick-start) for configuration### **Precise Content Filtering**@@ -175,165 +164,8 @@ Set personal keywords (e.g., AI, BYD, Education Policy) to receive only relevant- Supports normal words, required words (+), and filter words (!)- Group-based management with independent statistics for different topics-> You can also skip filtering and receive all trending news. See v2.0.1 in [Changelog](#-changelog)--<details id="frequencywordstxt-configuration">-<summary><strong>👉 Click to expand: frequency_words.txt Configuration</strong></summary>-<br>--Configure monitoring keywords in `frequency_words.txt` with three syntax types and grouping features.--Keywords at the top have higher priority. Adjust keyword order based on your interests.--| Syntax Type | Symbol | Purpose | Example | Matching Logic |-|------------|--------|---------|---------|----------------|-| **Normal** | None | Basic matching | `Huawei` | Match any one |-| **Required** | `+` | Scope limiting | `+phone` | Must include both |-| **Filter** | `!` | Noise exclusion | `!ad` | Exclude if included |--### 📋 Basic Syntax--#### 1. **Normal Keywords** - Basic Matching-```txt-Huawei-OPPO-Apple-```-**Effect:** News containing **any one** of these words will be captured--#### 2. **Required Words** `+word` - Scope Limiting-```txt-Huawei-OPPO-+phone-```-**Effect:** Must include both normal word **and** required word to be captured--#### 3. **Filter Words** `!word` - Noise Exclusion-```txt-Apple-Huawei-!fruit-!price-```-**Effect:** News containing filter words will be **excluded**, even if it contains keywords--### 🔗 Group Feature - Importance of Empty Lines--**Core Rule:** Use **empty lines** to separate different groups, each group is independently counted--#### Example Configuration:-```txt-iPhone-Huawei-OPPO-+launch--A-shares-Shanghai Index-Shenzhen Index-+fluctuation-!prediction--World Cup-Euro Cup-Asian Cup-+match-```--#### Group Explanation and Matching Effects:--**Group 1 - Phone Launches:**-- Keywords: iPhone, Huawei, OPPO-- Required: launch-- Effect: Must include phone brand name and "launch"--**Matching Examples:**-- ✅ "iPhone 15 officially launched with pricing" ← Has "iPhone" + "launch"-- ✅ "Huawei Mate60 series launch livestream" ← Has "Huawei" + "launch"-- ✅ "OPPO Find X7 launch date confirmed" ← Has "OPPO" + "launch"-- ❌ "iPhone sales hit record high" ← Has "iPhone" but missing "launch"--**Group 2 - Stock Market:**-- Keywords: A-shares, Shanghai Index, Shenzhen Index-- Required: fluctuation-- Filter: prediction-- Effect: Include stock-related words and "fluctuation", but exclude "prediction"--**Matching Examples:**-- ✅ "A-shares major fluctuation analysis today" ← Has "A-shares" + "fluctuation"-- ✅ "Shanghai Index fluctuation reasons explained" ← Has "Shanghai Index" + "fluctuation"-- ❌ "Experts predict A-shares fluctuation trends" ← Has "A-shares" + "fluctuation" but contains "prediction"-- ❌ "A-shares trading volume hits new high" ← Has "A-shares" but missing "fluctuation"--**Group 3 - Football Events:**-- Keywords: World Cup, Euro Cup, Asian Cup-- Required: match-- Effect: Must include cup name and "match"--**Matching Examples:**-- ✅ "World Cup group stage match results" ← Has "World Cup" + "match"-- ✅ "Euro Cup final match time" ← Has "Euro Cup" + "match"-- ❌ "World Cup tickets on sale" ← Has "World Cup" but missing "match"--### 🎯 Configuration Tips--#### 1. **From Broad to Strict Strategy**-```txt-# Step 1: Start with broad keywords for testing-Artificial Intelligence-AI-ChatGPT--# Step 2: After finding mismatches, add required words-Artificial Intelligence-AI-ChatGPT-+technology--# Step 3: After finding noise, add filter words-Artificial Intelligence-AI-ChatGPT-+technology-!advertisement-!training-```--#### 2. **Avoid Over-Complexity**-❌ **Not Recommended:** Too many words in one group-```txt-Huawei-OPPO-Apple-Samsung-vivo-OnePlus-Meizu-+phone-+launch-+sales-!fake-!repair-!second-hand-```--✅ **Recommended:** Split into precise groups-```txt-Huawei-OPPO-+new product--Apple-Samsung-+launch--phone-sales-+market-```--</details>+> 💡 Keyword configuration tutorial: [Configuration Guide - Keyword Configuration](#2-keyword-configuration)+> 💡 You can also skip filtering and receive all trending news (leave frequency_words.txt empty)### **Trending Analysis**@@ -346,64 +178,7 @@ Real-time tracking of news popularity changes helps you understand not just "wha- **Continuity Analysis**: Distinguishes between one-time hot topics and continuously developing news- **Cross-Platform Comparison**: Same news across different platforms, showing media attention differences-> Never miss the complete development of important news, from topic emergence to peak discussion--<details>-<summary><strong>👉 Click to expand: Push Format Explanation</strong></summary>-<br>--📊 Trending Keywords Stats--🔥 [1/3] AI ChatGPT : 2 items-- 1. [Baidu Hot] 🆕 ChatGPT-5 officially launched [**1**] - 09:15 (1 time)-- 2. [Toutiao] AI chip concept stocks surge [**3**] - [08:30 ~ 10:45] (3 times)--━━━━━━━━━━━━━━━━━━━--📈 [2/3] BYD Tesla : 2 items-- 1. [Weibo] 🆕 BYD monthly sales break record [**2**] - 10:20 (1 time)-- 2. [Douyin] Tesla price reduction promotion [**4**] - [07:45 ~ 09:15] (2 times)--━━━━━━━━━━━━━━━━━━━--📌 [3/3] A-shares Stock Market : 1 item-- 1. [Wallstreetcn] A-shares midday review [**5**] - [11:30 ~ 12:00] (2 times)--🆕 New Trending News (Total 2 items)--**Baidu Hot** (1 item):- 1. ChatGPT-5 officially launched [**1**]--**Weibo** (1 item):- 1. BYD monthly sales break record [**2**]--Updated: 2025-01-15 12:30:15---## **Message Format Explanation**--| Format Element | Example | Meaning | Description |-| ------------- | ------- | -------- | ----------- |-| 🔥📈📌 | 🔥 [1/3] AI ChatGPT | Popularity Level | 🔥 High (≥10) 📈 Medium (5-9) 📌 Normal (<5) |-| [Number/Total] | [1/3] | Rank Position | Current group rank among all matches |-| Keyword Group | AI ChatGPT | Keyword Group | Group from config, title must contain words |-| : N items | : 2 items | Match Count | Total news matching this group |-| [Platform] | [Baidu Hot] | Source Platform | Platform name of the news |-| 🆕 | 🆕 ChatGPT-5 officially launched | New Mark | First appearance in this round |-| [**number**] | [**1**] | High Rank | Rank ≤ threshold, bold red display |-| [number] | [7] | Normal Rank | Rank > threshold, normal display |-| - time | - 09:15 | First Time | Time when news was first discovered |-| [time~time] | [08:30 ~ 10:45] | Duration | Time range from first to last appearance |-| (N times) | (3 times) | Frequency | Total appearances during monitoring |-| **New Section** | 🆕 **New Trending News** | New Topic Summary | Separately shows newly appeared topics |--</details>-+> 💡 Push format reference: [Configuration Guide - Push Format Reference](#5-push-format-reference)### **Personalized Trending Algorithm**@@ -413,42 +188,7 @@ No longer controlled by platform algorithms, TrendRadar reorganizes all trending- **Focus on Persistent Topics** (30%): Repeatedly appearing news is more important- **Consider Ranking Quality** (10%): Not just frequent, but consistently top-ranked-> Merge trending searches from各 platforms and re-sort by your interests. These three ratios can be adjusted for your scenarios.--<details>-<summary><strong>👉 Click to expand: Trending Weight Adjustment</strong></summary>-<br>--Current default configuration is balanced.--### Two Core Scenarios--**Real-Time Trending Type**:-```yaml-weight:- rank_weight: 0.8 # Mainly focus on ranking- frequency_weight: 0.1 # Less concern about continuity- hotness_weight: 0.1-```-**Target Users**: Content creators, marketers, users wanting to quickly understand current hot topics--**In-Depth Topic Type**:-```yaml-weight:- rank_weight: 0.4 # Moderate ranking focus- frequency_weight: 0.5 # Emphasize sustained heat within the day- hotness_weight: 0.1-```-**Target Users**: Investors, researchers, journalists, users needing deep trend analysis--### Adjustment Method-1. **Three numbers must sum to 1.0**-2. **Increase what's important**: Increase rank_weight for rankings, frequency_weight for continuity-3. **Suggest adjusting 0.1-0.2 at a time**, observe effects--Core idea: Users pursuing speed and timeliness increase ranking weight, users pursuing depth and stability increase frequency weight.--</details>+> 💡 Weight adjustment guide: [Configuration Guide - Advanced Configuration](#4-advanced-configuration---hotspot-weight-adjustment)### **Multi-Channel Real-Time Push**@@ -476,7 +216,7 @@ AI conversational analysis system based on MCP (Model Context Protocol), enablin> - Project includes **November 1-15** test data for immediate experience> - Recommend deploying the project yourself to get more real-time data>-> See [AI Analysis Deployment](#-ai-analysis-deployment) for details+> See [AI Analysis](#-ai-analysis) for details### **Zero Technical Barrier Deployment**@@ -806,7 +546,7 @@ frequency_words.txt file added **required word** feature, using + sign## 🚀 Quick Start-> After configuration, news data updates after one hour. To accelerate, refer to [Step 4] to manually test configuration+> **📖 Reminder**: Fork users should first **[check the latest official documentation](https://github.com/sansan0/TrendRadar/blob/master/README.md)** to ensure the configuration steps are up to date.1. **Fork this project** to your GitHub account@@ -1210,12 +950,36 @@ frequency_words.txt file added **required word** feature, using + sign> **💡 Beginner Quick Start Tip**:>- > For first deployment, suggest completing **GitHub Secrets** configuration first (choose one push platform), then jump to [Step 4] to test push success.+ > For first deployment, suggest completing **GitHub Secrets** configuration first (choose one push platform), then jump to [Step 3] to test push success.>> **Don't modify** `config/config.yaml` and `frequency_words.txt` temporarily, adjust these configs after push test succeeds as needed.-3. **Configuration Notes:**:+3. **Manual Test News Push**:++ > 💡 **Complete Step 1-2 first, then test immediately!** Test success first, then adjust configuration (Step 4) as needed.+ >+ > ⚠️ **IMPORTANT: Enter your own forked project, not this project!**++ **How to find your Actions page**:++ - **Method 1**: Open your forked project homepage, click the **Actions** tab at the top+ - **Method 2**: Direct access `https://github.com/YourUsername/TrendRadar/actions`++ **Example comparison**:+ - ❌ Author's project: `https://github.com/sansan0/TrendRadar/actions`+ - ✅ Your project: `https://github.com/YourUsername/TrendRadar/actions`++ **Testing steps**:+ 1. Enter your project's Actions page+ 2. Find **"Hot News Crawler"** and click in+ - If you don't see this text, refer to [#109](https://github.com/sansan0/TrendRadar/issues/109) to solve+ 3. Click **"Run workflow"** button on the right to run+ 4. Wait about 1 minute, messages will be pushed to your configured platform++4. **Configuration Notes (Optional)**:++ > 💡 Default configuration works normally, only adjust if you need personalization- **Push Settings**: Configure push mode and notification options in [config/config.yaml](config/config.yaml)- **Keyword Settings**: Add your interested keywords in [config/frequency_words.txt](config/frequency_words.txt)@@ -1223,13 +987,327 @@ frequency_words.txt file added **required word** feature, using + sign**Note**: Suggest only adjusting explicitly documented config items, other options mainly for author's development testing-4. **Manual Test News Push**:- Using my project as example, you should test in **your forked** project+## ⚙️ Configuration Guide++> **📖 Reminder**: This chapter provides detailed configuration explanations. Suggest completing [Quick Start](#-quick-start) basic configuration first, then refer to detailed options here as needed.++### 1. Platform Configuration++<details id="custom-monitoring-platforms">+<summary>👉 Click to expand: <strong>Custom Monitoring Platforms</strong></summary>+<br>++This project's news data comes from [newsnow](https://github.com/ourongxing/newsnow). You can click the [website](https://newsnow.busiyi.world/), click [More], to see if there are platforms you want.++For specific additions, visit [project source code](https://github.com/ourongxing/newsnow/tree/main/server/sources), based on the file names there, modify the `platforms` configuration in `config/config.yaml` file:++```yaml+platforms:+ - id: "toutiao"+ name: "Toutiao"+ - id: "baidu"+ name: "Baidu Hot Search"+ - id: "wallstreetcn-hot"+ name: "Wallstreetcn"+ # Add more platforms...+```+If you don't know how to look, you can directly copy the partially organized [Platform Configuration](https://github.com/sansan0/TrendRadar/issues/95)++</details>++### 2. Keyword Configuration++<details id="frequencywordstxt-configuration-tutorial">+<summary>👉 Click to expand: <strong>frequency_words.txt Configuration Tutorial</strong></summary>+<br>++Configure monitoring keywords in `frequency_words.txt` with three syntax types and grouping features.++Keywords at the top have higher priority. Adjust keyword order based on your interests.++| Syntax Type | Symbol | Purpose | Example | Matching Logic |+|------------|--------|---------|---------|----------------|+| **Normal** | None | Basic matching | `Huawei` | Match any one |+| **Required** | `+` | Scope limiting | `+phone` | Must include both |+| **Filter** | `!` | Noise exclusion | `!ad` | Exclude if included |++#### 📋 Basic Syntax++##### 1. **Normal Keywords** - Basic Matching+```txt+Huawei+OPPO+Apple+```+**Effect:** News containing **any one** of these words will be captured++##### 2. **Required Words** `+word` - Scope Limiting+```txt+Huawei+OPPO++phone+```+**Effect:** Must include both normal word **and** required word to be captured++##### 3. **Filter Words** `!word` - Noise Exclusion+```txt+Apple+Huawei+!fruit+!price+```+**Effect:** News containing filter words will be **excluded**, even if it contains keywords++#### 🔗 Group Feature - Importance of Empty Lines++**Core Rule:** Use **empty lines** to separate different groups, each group is independently counted++##### Example Configuration:+```txt+iPhone+Huawei+OPPO++launch++A-shares+Shanghai Index+Shenzhen Index++fluctuation+!prediction++World Cup+Euro Cup+Asian Cup++match+```++##### Group Explanation and Matching Effects:++**Group 1 - Phone Launches:**+- Keywords: iPhone, Huawei, OPPO+- Required: launch+- Effect: Must include phone brand name and "launch"++**Matching Examples:**+- ✅ "iPhone 15 officially launched with pricing" ← Has "iPhone" + "launch"+- ✅ "Huawei Mate60 series launch livestream" ← Has "Huawei" + "launch"+- ✅ "OPPO Find X7 launch date confirmed" ← Has "OPPO" + "launch"+- ❌ "iPhone sales hit record high" ← Has "iPhone" but missing "launch"++**Group 2 - Stock Market:**+- Keywords: A-shares, Shanghai Index, Shenzhen Index+- Required: fluctuation+- Filter: prediction+- Effect: Include stock-related words and "fluctuation", but exclude "prediction"++**Matching Examples:**+- ✅ "A-shares major fluctuation analysis today" ← Has "A-shares" + "fluctuation"+- ✅ "Shanghai Index fluctuation reasons explained" ← Has "Shanghai Index" + "fluctuation"+- ❌ "Experts predict A-shares fluctuation trends" ← Has "A-shares" + "fluctuation" but contains "prediction"+- ❌ "A-shares trading volume hits new high" ← Has "A-shares" but missing "fluctuation"++**Group 3 - Football Events:**+- Keywords: World Cup, Euro Cup, Asian Cup+- Required: match+- Effect: Must include cup name and "match"++**Matching Examples:**+- ✅ "World Cup group stage match results" ← Has "World Cup" + "match"+- ✅ "Euro Cup final match time" ← Has "Euro Cup" + "match"+- ❌ "World Cup tickets on sale" ← Has "World Cup" but missing "match"++#### 🎯 Configuration Tips++##### 1. **From Broad to Strict Strategy**+```txt+# Step 1: Start with broad keywords for testing+Artificial Intelligence+AI+ChatGPT++# Step 2: After finding mismatches, add required words+Artificial Intelligence+AI+ChatGPT++technology++# Step 3: After finding noise, add filter words+Artificial Intelligence+AI+ChatGPT++technology+!advertisement+!training+```++##### 2. **Avoid Over-Complexity**+❌ **Not Recommended:** Too many words in one group+```txt+Huawei+OPPO+Apple+Samsung+vivo+OnePlus+Meizu++phone++launch++sales+!fake+!repair+!second-hand+```++��� **Recommended:** Split into precise groups+```txt+Huawei+OPPO++new product- 1. **Enter Actions**: https://github.com/sansan0/TrendRadar/actions- 2. Find "Hot News Crawler" and click in. If you don't see this text, refer to [#109](https://github.com/sansan0/TrendRadar/issues/109) to solve- 3. Click "Run workflow" button to run, wait about 1 minute for data to arrive on your phone+Apple+Samsung++launch++phone+sales++market+```++</details>++### 3. Push Mode Details++<details>+<summary>👉 Click to expand: <strong>Three Push Modes Detailed Comparison</strong></summary>+<br>++#### Detailed Comparison Table++| Mode | Target Users | Push Timing | Display Content | Typical Use Case |+|------|----------|----------|----------|--------------|+| **Daily Summary**<br/>`daily` | 📋 Managers/Regular Users | Scheduled push (default hourly) | All matched news of the day<br/>+ New news section | **Example**: Check all important news of the day at 6 PM<br/>**Feature**: See full-day trend, don't miss any hot topic<br/>**Note**: Will include previously pushed news |+| **Current Rankings**<br/>`current` | 📰 Content Creators | Scheduled push (default hourly) | Current ranking matches<br/>+ New news section | **Example**: Track "which topics are hottest now" hourly<br/>**Feature**: Real-time understanding of current popularity ranking changes<br/>**Note**: Continuously ranked news appear each time |+| **Incremental Monitor**<br/>`incremental` | 📈 Traders/Investors | Push only when new | Newly appeared frequency word matches | **Example**: Monitor "Tesla", only notify when new news appears<br/>**Feature**: Zero duplication, only see first-time news<br/>**Suitable for**: High-frequency monitoring, avoid information disturbance |++#### Actual Push Effect Example++Assume you monitor "Apple" keyword, execute once per hour:++| Time | daily Mode Push | current Mode Push | incremental Mode Push |+|-----|--------------|----------------|-------------------|+| 10:00 | News A, News B | News A, News B | News A, News B |+| 11:00 | News A, News B, News C | News B, News C, News D | **Only** News C |+| 12:00 | News A, News B, News C | News C, News D, News E | **Only** News D, News E |++**Explanation**:+- `daily`: Cumulative display of all news of the day (A, B, C all retained)+- `current`: Display current ranking news (ranking changed, News D on list, News A off list)+- `incremental`: **Only push newly appeared news** (avoid duplicate disturbance)++#### Common Questions++> **💡 Encountered this problem?** 👉 "Execute once per hour, news output in first execution still appears in next hour execution"+> - **Reason**: You might have selected `daily` (Daily Summary) or `current` (Current Rankings) mode+> - **Solution**: Change to `incremental` (Incremental Monitor) mode, only push new content++</details>++### 4. Advanced Configuration - Hotspot Weight Adjustment++<details>+<summary>👉 Click to expand: <strong>Hotspot Weight Adjustment</strong></summary>+<br>++Current default configuration is balanced.++#### Two Core Scenarios++**Real-Time Trending Type**:+```yaml+weight:+ rank_weight: 0.8 # Mainly focus on ranking+ frequency_weight: 0.1 # Less concern about continuity+ hotness_weight: 0.1+```+**Target Users**: Content creators, marketers, users wanting to quickly understand current hot topics++**In-Depth Topic Type**:+```yaml+weight:+ rank_weight: 0.4 # Moderate ranking focus+ frequency_weight: 0.5 # Emphasize sustained heat within the day+ hotness_weight: 0.1+```+**Target Users**: Investors, researchers, journalists, users needing deep trend analysis++#### Adjustment Method+1. **Three numbers must sum to 1.0**+2. **Increase what's important**: Increase rank_weight for rankings, frequency_weight for continuity+3. **Suggest adjusting 0.1-0.2 at a time**, observe effects++Core idea: Users pursuing speed and timeliness increase ranking weight, users pursuing depth and stability increase frequency weight.++</details>++### 5. Push Format Reference++<details>+<summary>👉 Click to expand: <strong>Push Format Explanation</strong></summary>+<br>++#### Push Example++📊 Trending Keywords Stats++🔥 [1/3] AI ChatGPT : 2 items++ 1. [Baidu Hot] 🆕 ChatGPT-5 officially launched [**1**] - 09:15 (1 time)++ 2. [Toutiao] AI chip concept stocks surge [**3**] - [08:30 ~ 10:45] (3 times)++━━━━━━━━━━━━━━━━━━━++📈 [2/3] BYD Tesla : 2 items++ 1. [Weibo] 🆕 BYD monthly sales break record [**2**] - 10:20 (1 time)++ 2. [Douyin] Tesla price reduction promotion [**4**] - [07:45 ~ 09:15] (2 times)++━━━━━━━━━━━━━━━━━━━++📌 [3/3] A-shares Stock Market : 1 item++ 1. [Wallstreetcn] A-shares midday review [**5**] - [11:30 ~ 12:00] (2 times)++🆕 New Trending News (Total 2 items)++**Baidu Hot** (1 item):+ 1. ChatGPT-5 officially launched [**1**]++**Weibo** (1 item):+ 1. BYD monthly sales break record [**2**]++Updated: 2025-01-15 12:30:15++#### Message Format Explanation++| Format Element | Example | Meaning | Description |+| ------------- | ------- | -------- | ----------- |+| 🔥📈📌 | 🔥 [1/3] AI ChatGPT | Popularity Level | 🔥 High (≥10) 📈 Medium (5-9) 📌 Normal (<5) |+| [Number/Total] | [1/3] | Rank Position | Current group rank among all matches |+| Keyword Group | AI ChatGPT | Keyword Group | Group from config, title must contain words |+| : N items | : 2 items | Match Count | Total news matching this group |+| [Platform] | [Baidu Hot] | Source Platform | Platform name of the news |+| 🆕 | 🆕 ChatGPT-5 officially launched | New Mark | First appearance in this round |+| [**number**] | [**1**] | High Rank | Rank ≤ threshold, bold red display |+| [number] | [7] | Normal Rank | Rank > threshold, normal display |+| - time | - 09:15 | First Time | Time when news was first discovered |+| [time~time] | [08:30 ~ 10:45] | Duration | Time range from first to last appearance |+| (N times) | (3 times) | Frequency | Total appearances during monitoring |+| **New Section** | 🆕 **New Trending News** | New Topic Summary | Separately shows newly appeared topics |++</details>## 🐳 Docker Deployment@@ -1433,7 +1511,7 @@ docker exec -it trend-radar ls -la /app/config/```-## 🤖 AI Analysis Deployment+## 🤖 AI AnalysisTrendRadar v3.0.0 added **MCP (Model Context Protocol)** based AI analysis feature, allowing natural language conversations with news data for deep analysis.@@ -1795,6 +1873,7 @@ Currently, major AI model prices are relatively affordable. Welcome to register- **GitHub Issues**: Suitable for targeted answers. Please provide complete info when asking (screenshots, error logs, system environment, etc.)- **WeChat Official Account**: Suitable for quick consultation. Suggest priority to communicate in public comment area of related articles. If private message, please use polite language 😉+- 💡 Deployment successful? Welcome to leave comments and likes on our official account to share your experience~<div align="center">@@ -1820,7 +1899,7 @@ Currently, major AI model prices are relatively affordable. Welcome to register### 💰 302.AI New User Benefits-> The $1 credit can be used to call various AI models (such as Claude, GPT, etc.)+> The $1 credit can be used to call various AI models (such as Claude, GPT, etc.)> This project's AI analysis features require AI model integration. See [AI Analysis Deployment](#-ai-analysis-deployment) for configuration tutorial[](https://share.302.ai/mEOUzG)diff --git a/README.md b/README.mdindex 3593a2748b..c43f177ac6 100644--- a/README.md+++ b/README.md@@ -39,27 +39,53 @@> 本项目以轻量,易部署为目标+<details>+<summary>⚠️ 点击展开:<strong>查看最新文档</strong>(Fork 用户必读)</summary>+<br>++最近有很多第一次接触 GitHub 的新用户使用本项目,因此特别补充这个说明。++**问题**:如果你是通过 **Fork** 使用本项目,你看到的可能是旧版文档。++**原因**:Fork 时会复制当时的文档版本,但原项目可能已更新。++**👉 [点击查看最新官方文档](https://github.com/sansan0/TrendRadar/blob/master/README.md)**++**如何判断?** 看页面顶部的仓库地址:+- `github.com/你的用户名/TrendRadar` ← 你 fork 的版本+- `github.com/sansan0/TrendRadar` ← 最新官方版本++</details>+## 📑 快速导航<div align="center">-| [🎯 核心功能](#-核心功能) | [🚀 快速开始](#-快速开始) | [🐳 Docker部署](#-docker-部署) | [🤖 AI分析专区](#-ai-智能分析部署) |+| [🎯 核心功能](#-核心功能) | [🚀 快速开始](#-快速开始) | [⚙️ 配置详解](#-配置详解) | [🐳 Docker部署](#-docker-部署) ||:---:|:---:|:---:|:---:|-| [📝 更新日志](#-更新日志) | [🔌 MCP客户端](#-mcp-客户端) | [❓ 答疑与公益](#问题答疑与公益捐助) | [⭐ 项目相关](#项目相关) |-| [🔧 自定义监控平台](#自定义监控平台) | [📝 推送关键词配置](#frequencywordstxt-配置教程) | [🪄 赞助商](#-赞助商) | |+| [🤖 AI 智能分析](#-ai-智能分析) | [🔌 MCP客户端](#-mcp-客户端) | [📝 更新日志](#-更新日志) | [❓ 答疑与交流](#问题答疑与交流) |+| [⭐ 项目相关](#项目相关) | [🪄 赞助商](#-赞助商) | | |</div>- 感谢**耐心反馈 bug** 的贡献者,你们的每一条反馈让项目更加完善😉;- 感谢**为项目点 star** 的观众们,**fork** 你所欲也,**star** 我所欲也,两者得兼😍是对开源精神最好的支持;-- 感谢**关注[公众号](#问题答疑与公益捐助)** 的读者们,你们的留言、点赞、分享和推荐等积极互动让内容更有温度😎。+- 感谢**关注[公众号](#问题答疑与交流)** 的读者们,你们的留言、点赞、分享和推荐等积极互动让内容更有温度😎。<details>-<summary>👉 点击查看<strong>致谢名单</strong> (当前 <strong>🔥71🔥</strong> 位)</summary>+<summary>👉 点击展开:<strong>致谢名单</strong> (当前 <strong>🔥72🔥</strong> 位)</summary>++### 基础设施支持++感谢 **GitHub** 免费提供的基础设施,这是本项目得以**一键 fork**便捷运行的最大前提。### 数据支持-本项目使用了 [newsnow](https://github.com/ourongxing/newsnow) 项目提供的 API 接口获取多平台数据+本项目使用 [newsnow](https://github.com/ourongxing/newsnow) 项目的 API 获取多平台数据,特别感谢作者提供的服务。++经联系,作者表示无需担心服务器压力,但这是基于他的善意和信任。请大家:+- **前往 [newsnow 项目](https://github.com/ourongxing/newsnow) 点 star 支持**+- Docker 部署时,请合理控制推送频率,勿竭泽而渔### 推广助力@@ -71,7 +97,9 @@### 观众支持-> 感谢**给予资金支持** 的朋友们,你们的慷慨已化身为键盘旁的零食饮料,陪伴着项目的每一次迭代+> 感谢**给予资金支持**的朋友们,你们的慷慨已化身为键盘旁的零食饮料,陪伴着项目的每一次迭代。+>+> **"一元点赞"已暂停**,如仍想支持作者,可前往[公众号](#问题答疑与交流)文章底部点击"喜欢作者"。| 点赞人 | 金额 | 日期 | 备注 || :-------------------------: | :----: | :----: | :-----------------------: |@@ -166,436 +194,167 @@默认监控 11 个主流平台,也可自行增加额外的平台-<details id="自定义监控平台">-<summary><strong>👉 点击展开:自定义监控平台</strong></summary>-<br>--本项目的资讯数据来源于 [newsnow](https://github.com/ourongxing/newsnow) ,你可以点击[网站](https://newsnow.busiyi.world/),点击[更多],查看是否有你想要的平台。--具体添加可访问 [项目源代码](https://github.com/ourongxing/newsnow/tree/main/server/sources),根据里面的文件名,在 `config/config.yaml` 文件中修改 `platforms` 配置:--```yaml-platforms:- - id: "toutiao"- name: "今日头条"- - id: "baidu"- name: "百度热搜"- - id: "wallstreetcn-hot"- name: "华尔街见闻"- # 添加更多平台...-```-如果不会看的话,就直接复制他人整理好的部分[平台配置](https://github.com/sansan0/TrendRadar/issues/95)--</details>+> 💡 详细配置教程见 [配置详解 - 平台配置](#1-平台配置)### **智能推送策略****三种推送模式**:-| 模式 | 适用人群 | 推送时机 | 显示内容 | 适用场景 |-|------|----------|----------|----------|----------|-| **当日汇总**<br/>`daily` | 📋 企业管理者/普通用户 | 按时推送(默认每小时推送一次) | 当日所有匹配新闻<br/>+ 新增新闻区域 | 日报总结<br/>全面了解当日热点趋势 |-| **当前榜单**<br/>`current` | 📰 自媒体人/内容创作者 | 按时推送(默认每小时推送一次) | 当前榜单匹配新闻<br/>+ 新增新闻区域 | 实时热点追踪<br/>了解当前最火的内容 |-| **增量监控**<br/>`incremental` | 📈 投资者/交易员 | 有新增才推送 | 新出现的匹配频率词新闻 | 避免重复信息干扰<br/>高频监控场景 |+| 模式 | 适用场景 | 推送特点 |+|------|---------|---------|+| **当日汇总** (daily) | 企业管理者/普通用户 | 按时推送当日所有匹配新闻(会包含之前推送过的) |+| **当前榜单** (current) | 自媒体人/内容创作者 | 按时推送当前榜单匹配新闻(持续在榜的每次都出现) |+| **增量监控** (incremental) | 投资者/交易员 | 仅推送新增内容,零重复 |-**附加功能 - 推送时间窗口控制**(可选):+> 💡 **快速选择指南:**+> - 🔄 不想看到重复新闻 → 用 `incremental`(增量监控)+> - 📊 想看完整榜单趋势 → 用 `current`(当前榜单)+> - 📝 需要每日汇总报告 → 用 `daily`(当日汇总)+>+> 详细对比和配置教程见 [配置详解 - 推送模式详解](#3-推送模式详解)-此功能独立于上述三种推送模式,可与任意模式搭配使用:+**附加功能 - 推送时间窗口控制**(可选):-- **时间窗口限制**: 设定推送时间范围(如 09:00-18:00 或 20:00-22:00),只在指定时间内推送-- **推送频率控制**:- - 窗口内多次推送: 时间窗口内每次执行都推送- - 每天仅推送一次: 时间窗口内只推送一次(适合当日汇总或当前榜单模式)-- **典型场景**:- - 工作时间推送: 只在工作日 09:00-18:00 接收消息- - 晚间汇总推送: 希望在晚上固定时间(如 20:00-22:00)收到汇总- - 避免打扰: 防止非工作时间收到推送通知+- 设定推送时间范围(如 09:00-18:00),只在指定时间内推送+- 可配置窗口内多次推送或每天仅推送一次+- 避免非工作时间打扰-> 提示: 此功能默认关闭,需在 `config/config.yaml` 中手动启用 `push_window.enabled`+> 💡 此功能默认关闭,配置方法见 [快速开始](#-快速开始)### **精准内容筛选**设置个人关键词(如:AI、比亚迪、教育政策),只推送相关热点,过滤无关信息-- 支持普通词、必须词(+)、过滤词(!)三种语法,见【frequency_words.txt 配置教程】+- 支持普通词、必须词(+)、过滤词(!)三种语法- 词组化管理,独立统计不同主题热点-> 也可以不做筛选,完整的推送所有热点,具体见【历史更新】中的 v2.0.1--<details id="frequencywordstxt-配置教程">-<summary><strong>👉 点击展开:frequency_words.txt 配置教程</strong></summary>-<br>--在 `frequency_words.txt` 文件中配置监控的关键词,支持三种语法和词组功能。+> 💡 关键词配置教程见 [配置详解 - 关键词配置](#2-关键词配置)+> 💡 也可以不做筛选,完整推送所有热点(将 frequency_words.txt 留空)-关键词越靠前,新闻的优先级越高,你可以根据自己的关注度调整关键词顺序+### **热点趋势分析**-| 语法类型 | 符号 | 作用 | 示例 | 匹配逻辑 |-|---------|------|------|------|---------|-| **普通词** | 无 | 基础匹配 | `华为` | 包含任意一个即可 |-| **必须词** | `+` | 限定范围 | `+手机` | 必须同时包含 |-| **过滤词** | `!` | 排除干扰 | `!广告` | 包含则直接排除 |+实时追踪新闻热度变化,让你不仅知道"什么在热搜",更了解"热点如何演变"-### 📋 基础语法说明+- **时间轴追踪**:记录每条新闻从首次出现到最后出现的完整时间跨度+- **热度变化**:统计新闻在不同时间段的排名变化和出现频次+- **新增检测**:实时识别新出现的热点话题,用🆕标记第一时间提醒+- **持续性分析**:区分一次性热点话题和持续发酵的深度新闻+- **跨平台对比**:同一新闻在不同平台的排名表现,看出媒体关注度差异-#### 1. **普通关键词** - 基础匹配-```txt-华为-OPPO-苹果-```-**作用:** 新闻标题包含其中**任意一个词**就会被捕获+> 💡 推送格式说明见 [配置详解 - 推送格式参考](#5-推送格式参考)-#### 2. **必须词** `+词汇` - 限定范围-```txt-华为-OPPO-+手机-```-**作用:** 必须同时包含普通词**和**必须词才会被捕获+### **个性化热点算法**-#### 3. **过滤词** `!词汇` - 排除干扰-```txt-苹果-华为-!水果-!价格-```-**作用:** 包含过滤词的新闻会被**直接排除**,即使包含关键词+不再被各个平台的算法牵着走,TrendRadar 会重新整理全网热搜:-### 🔗 词组功能 - 空行分隔的重要作用+- **看重排名高的新闻**(占60%):各平台前几名的新闻优先显示+- **关注持续出现的话题**(占30%):反复出现的新闻更重要+- **考虑排名质量**(占10%):不仅多次出现,还经常排在前列-**核心规则:** 用**空行**分隔不同的词组,每个词组独立统计+> 💡 这三个比例可以调整,详见 [配置详解 - 热点权重调整](#4-热点权重调整)-#### 示例配置:-```txt-iPhone-华为-OPPO-+发布+### **多渠道实时推送**-A股-上证-深证-+涨跌-!预测+支持**企业微信**(+ 微信推送方案)、**飞书**、**钉钉**、**Telegram**、**邮件**、**ntfy**,消息直达手机和邮箱-世界杯-欧洲杯-亚洲杯-+比赛-```+### **多端适配**+- **GitHub Pages**:自动生成精美网页报告,PC/移动端适配+- **Docker部署**:支持多架构容器化运行+- **数据持久化**:HTML/TXT多格式历史记录保存-#### 词组解释及匹配效果:-**第1组 - 手机新品类:**-- 关键词:iPhone、华为、OPPO-- 必须词:发布-- 效果:必须包含手机品牌名,同时包含"发布"+### **AI 智能分析(v3.0.0 新增)**-**匹配示例:**-- ✅ "iPhone 15正式发布售价公布" ← 有"iPhone"+"发布"-- ✅ "华为Mate60系列发布会直播" ← 有"华为"+"发布"-- ✅ "OPPO Find X7发布时间确定" ← 有"OPPO"+"发布"-- ❌ "iPhone销量创新高" ← 有"iPhone"但缺少"发布"+基于 MCP (Model Context Protocol) 协议的 AI 对话分析系统,让你用自然语言深度挖掘新闻数据-**第2组 - 股市行情类:**-- 关键词:A股、上证、深证-- 必须词:涨跌-- 过滤词:预测-- 效果:包含股市相关词,同时包含"涨跌",但排除包含"预测"的内容+- **对话式查询**:用自然语言提问,如"查询昨天知乎的热点"、"分析比特币最近的热度趋势"+- **13 种分析工具**:涵盖基础查询、智能检索、趋势分析、数据洞察、情感分析等+- **多客户端支持**:Cherry Studio(GUI 配置)、Claude Desktop、Cursor、Cline 等+- **深度分析能力**:+ - 话题趋势追踪(热度变化、生命周期、爆火检测、趋势预测)+ - 跨平台数据对比(活跃度统计、关键词共现)+ - 智能摘要生成、相似新闻查找、历史关联检索-**匹配示例:**-- ✅ "A股今日大幅涨跌分析" ← 有"A股"+"涨跌"-- ✅ "上证指数涨跌原因解读" ← 有"上证"+"涨跌"-- ❌ "专家预测A股涨跌趋势" ← 有"A股"+"涨跌"但包含"预测"-- ❌ "A股成交量创新高" ← 有"A股"但缺少"涨跌"+> **💡 使用提示**:AI 功能需要本地新闻数据支持+> - 项目自带 **11月1-15日** 测试数据,可立即体验+> - 建议自行部署运行项目,获取更实时的数据+>+> 详见 [AI 智能分析](#-ai-智能分析)-**第3组 - 足球赛事类:**-- 关键词:世界杯、欧洲杯、亚洲杯-- 必须词:比赛-- 效果:必须包含杯赛名称,同时包含"比赛"+### **零技术门槛部署**-**匹配示例:**-- ✅ "世界杯小组赛比赛结果" ← 有"世界杯"+"比赛"-- ✅ "欧洲杯决赛比赛时间" ← 有"欧洲杯"+"比赛"-- ❌ "世界杯门票开售" ← 有"世界杯"但缺少"比赛"+GitHub 一键 Fork 即可使用,无需编程基础。-### 🎯 配置技巧+> 30秒部署: GitHub Pages(网页浏览)支持一键保存成图片,随时分享给他人+>+> 1分钟部署: 企业微信(手机通知)-#### 1. **从宽到严的配置策略**-```txt-# 第一步:先用宽泛关键词测试-人工智能-AI-ChatGPT+**💡 提示:** 想要**实时更新**的网页版?fork 后,进入你的仓库 Settings → Pages,启用 GitHub Pages。[效果预览](https://sansan0.github.io/TrendRadar/)。-# 第二步:发现误匹配后,加入必须词限定-人工智能-AI-ChatGPT-+技术+### **减少 APP 依赖**-# 第三步:发现干扰内容后,加入过滤词-人工智能-AI-ChatGPT-+技术-!广告-!培训-```+从"被算法推荐绑架"变成"主动获取自己想要的信息"-#### 2. **避免过度复杂**-❌ **不推荐:** 一个词组包含太多词汇-```txt-华为-OPPO-苹果-三星-vivo-一加-魅族-+手机-+发布-+销量-!假货-!维修-!二手-```+**适合人群:** 投资者、自媒体人、企业公关、关心时事的普通用户-✅ **推荐:** 拆分成多个精确的词组-```txt-华为-OPPO-+新品+**典型场景:** 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取-苹果-三星-+发布-手机-销量-+市场-```+| Github Pages 效果(手机端适配、邮箱推送效果) | 飞书推送效果 |+|:---:|:---:|+|  |  |-</details>+## 📝 更新日志-### **热点趋势分析**+>**升级说明**:+- **📌 查看最新更新**:**[原仓库更新日志](https://github.com/sansan0/TrendRadar/blob/master/README.md#-更新日志)**+- **提示**:不要通过 **Sync fork** 更新本项目,建议查看【历史更新】,明确具体的【升级方式】和【功能内容】+- **小版本更新**:从 v2.x 升级到 v2.y,用本项目的 `main.py` 代码替换你 fork 仓库中的对应文件+- **大版本升级**:从 v1.x 升级到 v2.y,建议删除现有 fork 后重新 fork,这样更省力且避免配置冲突-实时追踪新闻热度变化,让你不仅知道"什么在热搜",更了解"热点如何演变"-- **时间轴追踪**:记录每条新闻从首次出现到最后出现的完整时间跨度-- **热度变化**:统计新闻在不同时间段的排名变化和出现频次-- **新增检测**:实时识别新出现的热点话题,用🆕标记第一时间提醒-- **持续性分析**:区分一次性热点话题和持续发酵的深度新闻-- **跨平台对比**:同一新闻在不同平台的排名表现,看出媒体关注度差异+### 2025/11/12 - v3.0.5-> 不再错过重要新闻的完整发展过程,从话题萌芽到高峰热议,全程掌握+- 修复邮件发送 SSL/TLS 端口配置逻辑错误+- 优化邮箱服务商(QQ/163/126)默认使用 465 端口(SSL)+- **新增 Docker 环境变量支持**:核心配置项(`enable_crawler`、`report_mode`、`push_window` 等)支持通过环境变量覆盖,解决 NAS 用户修改配置文件不生效的问题(详见 [🐳 Docker 部署](#-docker-部署) 章节)-<details>-<summary><strong>👉 点击展开:推送格式说明</strong></summary>-<br>-📊 热点词汇统计-🔥 [1/3] AI ChatGPT : 2 条+### 2025/11/18 - mcp-v1.0.2- 1. [百度热搜] 🆕 ChatGPT-5正式发布 [**1**] - 09时15分 (1次)-- 2. [今日头条] AI芯片概念股暴涨 [**3**] - [08时30分 ~ 10时45分] (3次)--━━━━━━━━━━━━━━━━━━━+ **MCP 模块更新:**+ - 优化查询今日新闻却可能错误返回过去日期的情况-📈 [2/3] 比亚迪 特斯拉 : 2 条- 1. [微博] 🆕 比亚迪月销量破纪录 [**2**] - 10时20分 (1次)-- 2. [抖音] 特斯拉降价促销 [**4**] - [07时45分 ~ 09时15分] (2次)+<details>+<summary>👉 点击展开:<strong>历史更新</strong></summary>-━━━━━━━━━━━━━━━━━━━+### 2025/10/26 - mcp-v1.0.1-📌 [3/3] A股 股市 : 1 条+ **MCP 模块更新:**+ - 修复日期查询参数传递错误+ - 统一所有工具的时间参数格式- 1. [华尔街见闻] A股午盘点评分析 [**5**] - [11时30分 ~ 12时00分] (2次)-🆕 本次新增热点新闻 (共 2 条)+### 2025/10/31 - v3.0.4-**百度热搜** (1 条):- 1. ChatGPT-5正式发布 [**1**]+- 解决飞书因推送内容过长而产生的错误,实现了分批推送-**微博** (1 条):- 1. 比亚迪月销量破纪录 [**2**]-更新时间:2025-01-15 12:30:15+### 2025/10/23 - v3.0.3+- 扩大 ntfy 错误信息显示范围-## **消息格式说明**-| 格式元素 | 示例 | 含义 | 说明 |-| ------------- | --------------------------- | ------------ | --------------------------------------- |-| 🔥📈📌 | 🔥 [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次) | 出现频率 | 在监控期间出现的总次数 |-| **新增区域** | 🆕 **本次新增热点新闻** | 新话题汇总 | 单独展示本轮新出现的热点话题 |+### 2025/10/21 - v3.0.2-</details>+- 修复 ntfy 推送编码问题+### 2025/10/20 - v3.0.0-### **个性化热点算法**--不再被各个平台的算法牵着走,TrendRadar 会重新整理全网热搜:--- **看重排名高的新闻**(占60%):各平台前几名的新闻优先显示-- **关注持续出现的话题**(占30%):反复出现的新闻更重要-- **考虑排名质量**(占10%):不仅多次出现,还经常排在前列--> 把分散在各个平台的热搜合并起来,按照你关心的热度重新排序,这三个比例可以选择适合自己的场景进行调整--<details>-<summary><strong>👉 点击展开:热点权重调整</strong></summary>-<br>--当前默认的配置是平衡性配置--### 两个核心场景--**追实时热点型**:-```yaml-weight:- rank_weight: 0.8 # 主要看排名- frequency_weight: 0.1 # 不太在乎持续性- hotness_weight: 0.1-```-**适用人群**:自媒体博主、营销人员、想快速了解当下最火话题的用户--**追深度话题型**:-```yaml-weight:- rank_weight: 0.4 # 适度看排名- frequency_weight: 0.5 # 重视当天内的持续热度- hotness_weight: 0.1-```-**适用人群**:投资者、研究人员、新闻工作者、需要深度分析趋势的用户--### 调整的方法-1. **三个数字加起来必须等于 1.0**-2. **哪个重要就调大哪个**:在乎排名就调大 rank_weight,在乎持续性就调大 frequency_weight-3. **建议每次只调 0.1-0.2**,观察效果--核心思路:追求速度和时效性的用户提高排名权重,追求深度和稳定性的用户提高频次权重。--</details>--### **多渠道实时推送**--支持**企业微信**(+ 微信推送方案)、**飞书**、**钉钉**、**Telegram**、**邮件**、**ntfy**,消息直达手机和邮箱--### **多端适配**-- **GitHub Pages**:自动生成精美网页报告,PC/移动端适配-- **Docker部署**:支持多架构容器化运行-- **数据持久化**:HTML/TXT多格式历史记录保存---### **AI 智能分析(v3.0.0 新增)**--基于 MCP (Model Context Protocol) 协议的 AI 对话分析系统,让你用自然语言深度挖掘新闻数据--- **对话式查询**:用自然语言提问,如"查询昨天知乎的热点"、"分析比特币最近的热度趋势"-- **13 种分析工具**:涵盖基础查询、智能检索、趋势分析、数据洞察、情感分析等-- **多客户端支持**:Cherry Studio(GUI 配置)、Claude Desktop、Cursor、Cline 等-- **深度分析能力**:- - 话题趋势追踪(热度变化、生命周期、爆火检测、趋势预测)- - 跨平台数据对比(活跃度统计、关键词共现)- - 智能摘要生成、相似新闻查找、历史关联检索--> **💡 使用提示**:AI 功能需要本地新闻数据支持-> - 项目自带 **11月1-15日** 测试数据,可立即体验-> - 建议自行部署运行项目,获取更实时的数据->-> 详见 [AI 智能分析部署](#-ai-智能分析部署)--### **零技术门槛部署**--GitHub 一键 Fork 即可使用,无需编程基础。--> 30秒部署: GitHub Pages(网页浏览)支持一键保存成图片,随时分享给他人->-> 1分钟部署: 企业微信(手机通知)--**💡 提示:** 想要**实时更新**的网页版?fork 后,进入你的仓库 Settings → Pages,启用 GitHub Pages。[效果预览](https://sansan0.github.io/TrendRadar/)。--### **减少 APP 依赖**--从"被算法推荐绑架"变成"主动获取自己想要的信息"--**适合人群:** 投资者、自媒体人、企业公关、关心时事的普通用户--**典型场景:** 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取---| Github Pages 效果(手机端适配、邮箱推送效果) | 飞书推送效果 |-|:---:|:---:|-|  |  |---## 📝 更新日志-->**升级说明**:-- **提示**:不要通过 **Sync fork** 更新本项目, 建议查看【历史更新】,明确具体的【升级方式】和【功能内容】-- **小版本更新**:从 v2.x 升级到 v2.y, 用本项目的 `main.py` 代码替换你 fork 仓库中的对应文件-- **大版本升级**:从 v1.x 升级到 v2.y, 建议删除现有 fork 后重新 fork,这样更省力且避免配置冲突---### 2025/11/12 - v3.0.5--- 修复邮件发送 SSL/TLS 端口配置逻辑错误-- 优化邮箱服务商(QQ/163/126)默认使用 465 端口(SSL)-- **新增 Docker 环境变量支持**:核心配置项(`enable_crawler`、`report_mode`、`push_window` 等)支持通过环境变量覆盖,解决 NAS 用户修改配置文件不生效的问题(详见 [🐳 Docker 部署](#-docker-部署) 章节)----### 2025/11/18 - mcp-v1.0.2-- **MCP 模块更新:**- - 优化查询今日新闻却可能错误返回过去日期的情况---<details>-<summary><strong>👉 点击展开:历史更新</strong></summary>--### 2025/10/26 - mcp-v1.0.1-- **MCP 模块更新:**- - 修复日期查询参数传递错误- - 统一所有工具的时间参数格式---### 2025/10/31 - v3.0.4--- 解决飞书因推送内容过长而产生的错误,实现了分批推送---### 2025/10/23 - v3.0.3--- 扩大 ntfy 错误信息显示范围---### 2025/10/21 - v3.0.2--- 修复 ntfy 推送编码问题--### 2025/10/20 - v3.0.0--**重大更新 - AI 分析功能上线** 🤖+**重大更新 - AI 分析功能上线** 🤖- **核心功能**:- 新增基于 MCP (Model Context Protocol) 的 AI 分析服务器@@ -843,7 +602,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号## 🚀 快速开始-> 配置完成后,新闻数据一小时后才会更新,如想加快,可参照【第4步】手动测试配置效果+> **📖 提醒**:Fork 用户建议先 **[查看最新官方文档](https://github.com/sansan0/TrendRadar/blob/master/README.md)**,确保配置步骤是最新的。1. **Fork 本项目**到你的 GitHub 账户@@ -872,7 +631,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号<details>- <summary> <strong>👉 点击展开:企业微信机器人</strong>(配置最简单最迅速)</summary>+ <summary>👉 点击展开:<strong>企业微信机器人</strong>(配置最简单最迅速)</summary><br>**GitHub Secret 配置(⚠️ Name 名称必须严格一致):**@@ -893,7 +652,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号</details><details>- <summary> <strong>👉 点击展开:飞书机器人</strong>(消息显示最友好)</summary>+ <summary>👉 点击展开:<strong>飞书机器人</strong>(消息显示最友好)</summary><br>**GitHub Secret 配置(⚠️ Name 名称必须严格一致):**@@ -982,7 +741,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号</details><details>- <summary> <strong>👉 点击展开:钉钉机器人</strong></summary>+ <summary>👉 点击展开:<strong>钉钉机器人</strong></summary><br>**GitHub Secret 配置(⚠️ Name 名称必须严格一致):**@@ -1012,7 +771,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号</details><details>- <summary> <strong>👉 点击展开:Telegram Bot</strong></summary>+ <summary>👉 点击展开:<strong>Telegram Bot</strong></summary><br>**GitHub Secret 配置(⚠️ Name 名称必须严格一致):**@@ -1051,7 +810,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号</details><details>- <summary> <strong>👉 点击展开:邮件推送</strong>(支持所有主流邮箱)</summary>+ <summary>👉 点击展开:<strong>邮件推送</strong>(支持所有主流邮箱)</summary><br>- 注意事项:为防止邮件群发功能被**滥用**,当前的群发是所有收件人都能看到彼此的邮箱地址。@@ -1069,208 +828,539 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号- **Name(名称)**:`EMAIL_TO`(请复制粘贴此名称,不要手打)- **Secret(值)**:收件人邮箱地址(多个收件人用英文逗号分隔,也可以和 EMAIL_FROM 一样,自己发送给自己)- - **Name(名称)**:`EMAIL_SMTP_SERVER`(可选配置,请复制粘贴此名称)- - **Secret(值)**:SMTP服务器地址(可留空,系统会自动识别)+ - **Name(名称)**:`EMAIL_SMTP_SERVER`(可选配置,请复制粘贴此名称)+ - **Secret(值)**:SMTP服务器地址(可留空,系统会自动识别)++ - **Name(名称)**:`EMAIL_SMTP_PORT`(可选配置,请复制粘贴此名称)+ - **Secret(值)**:SMTP端口(可留空,系统会自动识别)++ **说明**:邮件推送需要配置至少**3个必需** Secret(EMAIL_FROM、EMAIL_PASSWORD、EMAIL_TO),后两个为可选配置++ <br>++ **支持的邮箱服务商**(自动识别 SMTP 配置):++ | 邮箱服务商 | 域名 | 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 |++ > **自动识别**:使用以上邮箱时,无需手动配置 `EMAIL_SMTP_SERVER` 和 `EMAIL_SMTP_PORT`,系统会自动识别。+ >+ > **反馈说明**:+ > - 如果你使用**其他邮箱**测试成功,欢迎开 [Issues](https://github.com/sansan0/TrendRadar/issues) 告知,我会添加到支持列表+ > - 如果上述邮箱配置有误或无法使用,也请开 [Issues](https://github.com/sansan0/TrendRadar/issues) 反馈,帮助改进项目++ **常见邮箱设置:**++ #### 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` 填写授权码+ <br>++ **高级配置**:+ 如果自动识别失败,可手动配置 SMTP:+ - `EMAIL_SMTP_SERVER`:如 smtp.gmail.com+ - `EMAIL_SMTP_PORT`:如 587(TLS)或 465(SSL)+ <br>++ **如果有多个收件人(注意是英文逗号分隔)**:++ </details>++ <details>+ <summary>👉 点击展开:<strong>ntfy 推送</strong>(开源免费,支持自托管)</summary>+ <br>++ **两种使用方式:**++ ### 方式一:免费使用(推荐新手) 🆓++ **特点**:+ - ✅ 无需注册账号,立即使用+ - ✅ 每天 250 条消息(足够 90% 用户)+ - ✅ Topic 名称即"密码"(需选择不易猜测的名称)+ - ⚠️ 消息未加密,不适合敏感信息, 但适合我们这个项目的不敏感信息++ **快速开始:**++ 1. **下载 ntfy 应用**:+ - Android:[Google Play](https://play.google.com/store/apps/details?id=io.heckel.ntfy) / [F-Droid](https://f-droid.org/en/packages/io.heckel.ntfy/)+ - iOS:[App Store](https://apps.apple.com/us/app/ntfy/id1625396347)+ - 桌面:访问 [ntfy.sh](https://ntfy.sh)++ 2. **订阅主题**(选择一个难猜的名称):+ ```+ 建议格式:trendradar-{你的名字缩写}-{随机数字}++ 不能使用中文++ ✅ 好例子:trendradar-zs-8492+ ❌ 坏例子:news、alerts(太容易被猜到)+ ```++ 3. **配置 GitHub Secret(⚠️ Name 名称必须严格一致)**:+ - **Name(名称)**:`NTFY_TOPIC`(请复制粘贴此名称,不要手打)+ - **Secret(值)**:填写你刚才订阅的主题名称++ - **Name(名称)**:`NTFY_SERVER_URL`(可选配置,请复制粘贴此名称)+ - **Secret(值)**:留空(默认使用 ntfy.sh)++ - **Name(名称)**:`NTFY_TOKEN`(可选配置,请复制粘贴此名称)+ - **Secret(值)**:留空++ **说明**:ntfy 至少需要配置 1 个必需 Secret (NTFY_TOPIC),后两个为可选配置++ 4. **测试**:+ ```bash+ curl -d "测试消息" ntfy.sh/你的主题名称+ ```++ ---++ ### 方式二:自托管(完全隐私控制) 🔒++ **适合人群**:有服务器、追求完全隐私、技术能力强++ **优势**:+ - ✅ 完全开源(Apache 2.0 + GPLv2)+ - ✅ 数据完全自主控制+ - ✅ 无任何限制+ - ✅ 零费用++ **Docker 一键部署**:+ ```bash+ 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**:+ ```yaml+ NTFY_SERVER_URL: https://ntfy.yourdomain.com+ NTFY_TOPIC: trendradar-alerts # 自托管可用简单名称+ NTFY_TOKEN: tk_your_token # 可选:启用访问控制+ ```++ **在应用中订阅**:+ - 点击"Use another server"+ - 输入你的服务器地址+ - 输入主题名称+ - (可选)输入登录凭据++ ---++ **常见问题:**++ <details>+ <summary><strong>Q1: 免费版够用吗?</strong></summary>++ 每天 250 条消息对大多数用户足够。按 30 分钟抓取一次计算,每天约 48 次推送,完全够用。+ </details>++ <details>+ <summary><strong>Q2: Topic 名称真的安全吗?</strong></summary>++ 如果你选择随机的、足够长的名称(如 `trendradar-zs-8492-news`),暴力破解几乎不可能:+ - ntfy 有严格的速率限制(1 秒 1 次请求)+ - 64 个字符选择(A-Z, a-z, 0-9, _, -)+ - 10 位随机字符串有 64^10 种可能性(需要数年才能破解)+ </details>++ ---++ **推荐选择:**++ | 用户类型 | 推荐方案 | 理由 |+ |---------|---------|------|+ | 普通用户 | 方式一(免费) | 简单快速,够用 |+ | 技术用户 | 方式二(自托管) | 完全控制,无限制 |+ | 高频用户 | 方式三(付费) | 这个自己去官网看吧 |++ **相关链接:**+ - [ntfy 官方文档](https://docs.ntfy.sh/)+ - [自托管教程](https://docs.ntfy.sh/install/)+ - [GitHub 仓库](https://github.com/binwiederhier/ntfy)++ </details>++3. **手动测试新闻推送**:++ > 💡 **完成第1-2步后,请立即测试!** 测试成功后再根据需要调整配置(第4步)。+ >+ > ⚠️ **重要提醒:请进入你自己 fork 的项目,不是本项目!**++ **如何找到你的 Actions 页面**:++ - **方法一**:打开你 fork 的项目主页,点击顶部的 **Actions** 标签+ - **方法二**:直接访问 `https://github.com/你的用户名/TrendRadar/actions`++ **示例对比**:+ - ❌ 作者的项目:`https://github.com/sansan0/TrendRadar/actions`+ - ✅ 你的项目:`https://github.com/你的用户名/TrendRadar/actions`++ **测试步骤**:+ 1. 进入你项目的 Actions 页面+ 2. 找到 **"Hot News Crawler"** 点进去+ - 如果看不到该字样,参照 [#109](https://github.com/sansan0/TrendRadar/issues/109) 解决+ 3. 点击右侧的 **"Run workflow"** 按钮运行+ 4. 等待 1 分钟左右,消息会推送到你配置的平台++4. **配置说明(可选)**:++ > 💡 默认配置已可正常使用,如需个性化调整,可参考以下选项++ - **推送设置**:在 [config/config.yaml](config/config.yaml) 中配置推送模式和通知选项+ - **关键词设置**:在 [config/frequency_words.txt](config/frequency_words.txt) 中添加你关心的关键词+ - **推送频率调整**:在 [.github/workflows/crawler.yml](.github/workflows/crawler.yml) 请谨慎调整,别贪心++ **注意**:建议只调整文档中明确说明的配置项,其他选项主要供作者开发时测试使用+++## ⚙️ 配置详解++> **📖 提醒**:本章节提供详细的配置说明,建议先完成 [快速开始](#-快速开始) 的基础配置,再根据需要回来查看详细选项。++### 1. 平台配置++<details id="自定义监控平台">+<summary>👉 点击展开:<strong>自定义监控平台</strong></summary>+<br>++本项目的资讯数据来源于 [newsnow](https://github.com/ourongxing/newsnow) ,你可以点击[网站](https://newsnow.busiyi.world/),点击[更多],查看是否有你想要的平台。++具体添加可访问 [项目源代码](https://github.com/ourongxing/newsnow/tree/main/server/sources),根据里面的文件名,在 `config/config.yaml` 文件中修改 `platforms` 配置:++```yaml+platforms:+ - id: "toutiao"+ name: "今日头条"+ - id: "baidu"+ name: "百度热搜"+ - id: "wallstreetcn-hot"+ name: "华尔街见闻"+ # 添加更多平台...+```+如果不会看的话,就直接复制他人整理好的部分[平台配置](https://github.com/sansan0/TrendRadar/issues/95)++</details>++### 2. 关键词配置++<details id="frequencywordstxt-配置教程">+<summary>👉 点击展开:<strong>frequency_words.txt 配置教程</strong></summary>+<br>++在 `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组 - 足球赛事类:**+- 关键词:世界杯、欧洲杯、亚洲杯+- 必须词:比赛+- 效果:必须包含杯赛名称,同时包含"比赛"++**匹配示例:**+- ✅ "世界杯小组赛比赛结果" ← 有"世界杯"+"比赛"+- ✅ "欧洲杯决赛比赛时间" ← 有"欧洲杯"+"比赛"+- ❌ "世界杯门票开售" ← 有"世界杯"但缺少"比赛"- - **Name(名称)**:`EMAIL_SMTP_PORT`(可选配置,请复制粘贴此名称)- - **Secret(值)**:SMTP端口(可留空,系统会自动识别)+#### 🎯 配置技巧- **说明**:邮件推送需要配置至少**3个必需** Secret(EMAIL_FROM、EMAIL_PASSWORD、EMAIL_TO),后两个为可选配置+##### 1. **从宽到严的配置策略**+```txt+# 第一步:先用宽泛关键词测试+人工智能+AI+ChatGPT- <br>+# 第二步:发现误匹配后,加入必须词限定+人工智能+AI+ChatGPT++技术- **支持的邮箱服务商**(自动识别 SMTP 配置):+# 第三步:发现干扰内容后,加入过滤词+人工智能+AI+ChatGPT++技术+!广告+!培训+```- | 邮箱服务商 | 域名 | 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 |+##### 2. **避免过度复杂**+❌ **不推荐:** 一个词组包含太多词汇+```txt+华为+OPPO+苹果+三星+vivo+一加+魅族++手机++发布++销量+!假货+!维修+!二手+```- > **自动识别**:使用以上邮箱时,无需手动配置 `EMAIL_SMTP_SERVER` 和 `EMAIL_SMTP_PORT`,系统会自动识别。- >- > **反馈说明**:- > - 如果你使用**其他邮箱**测试成功,欢迎开 [Issues](https://github.com/sansan0/TrendRadar/issues) 告知,我会添加到支持列表- > - 如果上述邮箱配置有误或无法使用,也请开 [Issues](https://github.com/sansan0/TrendRadar/issues) 反馈,帮助改进项目+✅ **推荐:** 拆分成多个精确的词组+```txt+华为+OPPO++新品- **常见邮箱设置:**+苹果+三星++发布- #### QQ邮箱:- 1. 登录 QQ邮箱网页版 → 设置 → 账户- 2. 开启 POP3/SMTP 服务- 3. 生成授权码(16位字母)- 4. `EMAIL_PASSWORD` 填写授权码,而非 QQ 密码+手机+销量++市场+```- #### Gmail:- 1. 开启两步验证- 2. 生成应用专用密码- 3. `EMAIL_PASSWORD` 填写应用专用密码+</details>- #### 163/126邮箱:- 1. 登录网页版 → 设置 → POP3/SMTP/IMAP- 2. 开启 SMTP 服务- 3. 设置客户端授权码- 4. `EMAIL_PASSWORD` 填写授权码- <br>+### 3. 推送模式详解- **高级配置**:- 如果自动识别失败,可手动配置 SMTP:- - `EMAIL_SMTP_SERVER`:如 smtp.gmail.com- - `EMAIL_SMTP_PORT`:如 587(TLS)或 465(SSL)- <br>+<details>+<summary>👉 点击展开:<strong>三种推送模式详细对比</strong></summary>+<br>- **如果有多个收件人(注意是英文逗号分隔)**:+#### 详细对比表格- </details>+| 模式 | 适用人群 | 推送时机 | 显示内容 | 典型使用场景 |+|------|----------|----------|----------|------------|+| **当日汇总**<br/>`daily` | 📋 企业管理者/普通用户 | 按时推送(默认每小时推送一次) | 当日所有匹配新闻<br/>+ 新增新闻区域 | **案例**:每天下午6点查看今天所有重要新闻<br/>**特点**:看全天完整趋势,不漏掉任何热点<br/>**提醒**:会包含之前推送过的新闻 |+| **当前榜单**<br/>`current` | 📰 自媒体人/内容创作者 | 按时推送(默认每小时推送一次) | 当前榜单匹配新闻<br/>+ 新增新闻区域 | **案例**:每小时追踪"哪些话题现在最火"<br/>**特点**:实时了解当前热度排名变化<br/>**提醒**:持续在榜的新闻每次都会出现 |+| **增量监控**<br/>`incremental` | 📈 投资者/交易员 | 有新增才推送 | 新出现的匹配频率词新闻 | **案例**:监控"特斯拉",只在有新消息时通知<br/>**特点**:零重复,只看首次出现的新闻<br/>**适合**:高频监控、避免信息打扰 |- <details>- <summary> <strong>👉 点击展开:ntfy 推送</strong>(开源免费,支持自托管)</summary>- <br>+#### 实际推送效果举例- **两种使用方式:**+假设你监控"苹果"关键词,每小时执行一次:- ### 方式一:免费使用(推荐新手) 🆓+| 时间 | 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 |- **特点**:- - ✅ 无需注册账号,立即使用- - ✅ 每天 250 条消息(足够 90% 用户)- - ✅ Topic 名称即"密码"(需选择不易猜测的名称)- - ⚠️ 消息未加密,不适合敏感信息, 但适合我们这个项目的不敏感信息+**说明**:+- `daily`:累积展示当天所有新闻(A、B、C 都保留)+- `current`:展示当前榜单的新闻(排名变化,新闻D上榜,新闻A掉榜)+- `incremental`:**只推送新出现的新闻**(避免重复干扰)- **快速开始:**+#### 常见问题- 1. **下载 ntfy 应用**:- - Android:[Google Play](https://play.google.com/store/apps/details?id=io.heckel.ntfy) / [F-Droid](https://f-droid.org/en/packages/io.heckel.ntfy/)- - iOS:[App Store](https://apps.apple.com/us/app/ntfy/id1625396347)- - 桌面:访问 [ntfy.sh](https://ntfy.sh)+> **💡 遇到这个问题?** 👉 "每个小时执行一次,第一次执行完输出的新闻,在下一个小时执行时还会出现"+> - **原因**:你可能选择了 `daily`(当日汇总)或 `current`(当前榜单)模式+> - **解决**:改用 `incremental`(增量监控)模式,只推送新增内容- 2. **订阅主题**(选择一个难猜的名称):- ```- 建议格式:trendradar-{你的名字缩写}-{随机数字}-- 不能使用中文-- ✅ 好例子:trendradar-zs-8492- ❌ 坏例子:news、alerts(太容易被猜到)- ```+</details>- 3. **配置 GitHub Secret(⚠️ Name 名称必须严格一致)**:- - **Name(名称)**:`NTFY_TOPIC`(请复制粘贴此名称,不要手打)- - **Secret(值)**:填写你刚才订阅的主题名称+### 4. 热点权重调整- - **Name(名称)**:`NTFY_SERVER_URL`(可选配置,请复制粘贴此名称)- - **Secret(值)**:留空(默认使用 ntfy.sh)+<details>+<summary>👉 点击展开:<strong>热点权重调整</strong></summary>+<br>- - **Name(名称)**:`NTFY_TOKEN`(可选配置,请复制粘贴此名称)- - **Secret(值)**:留空+当前默认的配置是平衡性配置- **说明**:ntfy 至少需要配置 1 个必需 Secret (NTFY_TOPIC),后两个为可选配置+#### 两个核心场景- 4. **测试**:- ```bash- curl -d "测试消息" ntfy.sh/你的主题名称- ```+**追实时热点型**:+```yaml+weight:+ rank_weight: 0.8 # 主要看排名+ frequency_weight: 0.1 # 不太在乎持续性+ hotness_weight: 0.1+```+**适用人群**:自媒体博主、营销人员、想快速了解当下最火话题的用户- ---+**追深度话题型**:+```yaml+weight:+ rank_weight: 0.4 # 适度看排名+ frequency_weight: 0.5 # 重视当天内的持续热度+ hotness_weight: 0.1+```+**适用人群**:投资者、研究人员、新闻工作者、需要深度分析趋势的用户- ### 方式二:自托管(完全隐私控制) 🔒+#### 调整的方法+1. **三个数字加起来必须等于 1.0**+2. **哪个重要就调大哪个**:在乎排名就调大 rank_weight,在乎持续性就调大 frequency_weight+3. **建议每次只调 0.1-0.2**,观察效果- **适合人群**:有服务器、追求完全隐私、技术能力强+核心思路:追求速度和时效性的用户提高排名权重,追求深度和稳定性的用户提高频次权重。- **优势**:- - ✅ 完全开源(Apache 2.0 + GPLv2)- - ✅ 数据完全自主控制- - ✅ 无任何限制- - ✅ 零费用+</details>- **Docker 一键部署**:- ```bash- 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- ```+### 5. 推送格式参考- **配置 TrendRadar**:- ```yaml- NTFY_SERVER_URL: https://ntfy.yourdomain.com- NTFY_TOPIC: trendradar-alerts # 自托管可用简单名称- NTFY_TOKEN: tk_your_token # 可选:启用访问控制- ```+<details>+<summary>👉 点击展开:<strong>推送格式说明</strong></summary>+<br>- **在应用中订阅**:- - 点击"Use another server"- - 输入你的服务器地址- - 输入主题名称- - (可选)输入登录凭据+#### 推送示例- ---+📊 热点词汇统计- **常见问题:**+🔥 [1/3] AI ChatGPT : 2 条- <details>- <summary><strong>Q1: 免费版够用吗?</strong></summary>+ 1. [百度热搜] 🆕 ChatGPT-5正式发布 [**1**] - 09时15分 (1次)- 每天 250 条消息对大多数用户足够。按 30 分钟抓取一次计算,每天约 48 次推送,完全够用。- </details>+ 2. [今日头条] AI芯片概念股暴涨 [**3**] - [08时30分 ~ 10时45分] (3次)- <details>- <summary><strong>Q2: Topic 名称真的安全吗?</strong></summary>+━━━━━━━━━━━━━━━━━━━- 如果你选择随机的、足够长的名称(如 `trendradar-zs-8492-news`),暴力破解几乎不可能:- - ntfy 有严格的速率限制(1 秒 1 次请求)- - 64 个字符选择(A-Z, a-z, 0-9, _, -)- - 10 位随机字符串有 64^10 种可能性(需要数年才能破解)- </details>+📈 [2/3] 比亚迪 特斯拉 : 2 条- ---+ 1. [微博] 🆕 比亚迪月销量破纪录 [**2**] - 10时20分 (1次)- **推荐选择:**+ 2. [抖音] 特斯拉降价促销 [**4**] - [07时45分 ~ 09时15分] (2次)- | 用户类型 | 推荐方案 | 理由 |- |---------|---------|------|- | 普通用户 | 方式一(免费) | 简单快速,够用 |- | 技术用户 | 方式二(自托管) | 完全控制,无限制 |- | 高频用户 | 方式三(付费) | 这个自己去官网看吧 |+━━━━━━━━━━━━━━━━━━━- **相关链接:**- - [ntfy 官方文档](https://docs.ntfy.sh/)- - [自托管教程](https://docs.ntfy.sh/install/)- - [GitHub 仓库](https://github.com/binwiederhier/ntfy)+📌 [3/3] A股 股市 : 1 条- </details>+ 1. [华尔街见闻] A股午盘点评分析 [**5**] - [11时30分 ~ 12时00分] (2次)- > **💡 新手快速上手建议**:- >- > 第一次部署时,建议先完成 **GitHub Secrets** 配置(选择一个推送平台即可),然后直接跳到【第4步】测试推送是否成功。- >- > **暂时不要修改** `config/config.yaml` 和 `frequency_words.txt`,等推送测试成功后再根据需要调整这些配置。+🆕 本次新增热点新闻 (共 2 条)+**百度热搜** (1 条):+ 1. ChatGPT-5正式发布 [**1**]-3. **配置说明:**:+**微博** (1 条):+ 1. 比亚迪月销量破纪录 [**2**]- - **推送设置**:在 [config/config.yaml](config/config.yaml) 中配置推送模式和通知选项- - **关键词设置**:在 [config/frequency_words.txt](config/frequency_words.txt) 中添加你关心的关键词- - **推送频率调整**:在 [.github/workflows/crawler.yml](.github/workflows/crawler.yml) 请谨慎调整,别贪心+更新时间:2025-01-15 12:30:15- **注意**:建议只调整文档中明确说明的配置项,其他选项主要供作者开发时测试使用--4. **手动测试新闻推送**:+#### 消息格式说明- 我这里是拿我的项目举例,你要去你**fork**的项目做测试+| 格式元素 | 示例 | 含义 | 说明 |+| ------------- | --------------------------- | ------------ | --------------------------------------- |+| 🔥📈📌 | 🔥 [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次) | 出现频率 | 在监控期间出现的总次数 |+| **新增区域** | 🆕 **本次新增热点新闻** | 新话题汇总 | 单独展示本轮新出现的热点话题 |- 1. **进入 Actions**:https://github.com/sansan0/TrendRadar/actions- 2. 找到 "Hot News Crawler" 的点进去,如果看不到该字样,那么参照[#109](https://github.com/sansan0/TrendRadar/issues/109)解决- 3. 点击 "Run workflow" 按钮运行,等待 1 分钟左右数据到你手机上+</details>## 🐳 Docker 部署@@ -1474,7 +1564,7 @@ docker exec -it trend-radar ls -la /app/config/```-## 🤖 AI 智能分析部署+## 🤖 AI 智能分析TrendRadar v3.0.0 新增了基于 **MCP (Model Context Protocol)** 的 AI 分析功能,让你可以通过自然语言与新闻数据对话,进行深度分析。@@ -1506,7 +1596,7 @@ AI 分析功能**不是**直接查询网络实时数据,而是分析你**本Cherry Studio 提供 GUI 配置界面, 5 分钟快速部署, 复杂的部分是一键安装的。-**图文部署教程**:现已更新到我的[公众号](#问题答疑与公益捐助),回复 "mcp" 即可+**图文部署教程**:现已更新到我的[公众号](#问题答疑与交流),回复 "mcp" 即可**详细部署教程**:[README-Cherry-Studio.md](README-Cherry-Studio.md)@@ -1533,7 +1623,7 @@ TrendRadar MCP 服务支持标准的 Model Context Protocol (MCP) 协议,可- 保存后记得重启<details>-<summary><b>👉 点击展开:Claude Desktop</b></summary>+<summary>👉 点击展开:<b>Claude Desktop</b></summary>#### 配置文件方式@@ -1570,7 +1660,7 @@ TrendRadar MCP 服务支持标准的 Model Context Protocol (MCP) 协议,可</details><details>-<summary><b>👉 点击展开:Cursor</b></summary>+<summary>👉 点击展开:<b>Cursor</b></summary>#### 方式一:HTTP 模式@@ -1630,7 +1720,7 @@ TrendRadar MCP 服务支持标准的 Model Context Protocol (MCP) 协议,可</details><details>-<summary><b>👉 点击展开:VSCode (Cline/Continue)</b></summary>+<summary>👉 点击展开:<b>VSCode (Cline/Continue)</b></summary>#### Cline 配置@@ -1703,7 +1793,7 @@ TrendRadar MCP 服务支持标准的 Model Context Protocol (MCP) 协议,可</details><details>-<summary><b>👉 点击展开:Claude Code CLI</b></summary>+<summary>👉 点击展开:<b>Claude Code CLI</b></summary>#### HTTP 模式配置@@ -1735,7 +1825,7 @@ claude "对比知乎和微博平台对'比特币'的关注度"</details><details>-<summary><b>👉 点击展开:MCP Inspector</b>(调试工具)</summary>+<summary>👉 点击展开:<b>MCP Inspector</b>(调试工具)</summary><br>MCP Inspector 是官方调试工具,用于测试 MCP 连接:@@ -1768,7 +1858,7 @@ MCP Inspector 是官方调试工具,用于测试 MCP 连接:</details><details>-<summary><b>👉 点击展开:其他支持 MCP 的客户端</b></summary>+<summary>👉 点击展开:<b>其他支持 MCP 的客户端</b></summary><br>任何支持 Model Context Protocol 的客户端都可以连接 TrendRadar:@@ -1814,17 +1904,17 @@ MCP Inspector 是官方调试工具,用于测试 MCP 连接:</details>-## ☕问题答疑与公益捐助+## ☕问题答疑与交流> 如果你想支持本项目,可通过微信搜索**腾讯公益**,对里面的**助学计划**随心捐助~->+>> 我还在为信息过载而焦虑,而他们却在信息荒漠中挣扎,他们比我更需要支持。<details>-<summary><b>👉 点击展开:作者有话说</b></summary>+<summary>👉 点击展开:<b>作者有话说</b></summary><br>-感谢各位支持!因获得赞助商的赞助,现已移除我个人的**一元点赞**打赏码。+感谢各位支持!因获得[赞助商](#-赞助商)的赞助,现已移除我个人的**一元点赞**打赏码。之前参与**一元点赞**的朋友已收录至顶部**致谢名单**。@@ -1833,6 +1923,7 @@ MCP Inspector 是官方调试工具,用于测试 MCP 连接:- **GitHub Issues**:适合针对性强的解答。提问时请提供完整信息(截图、错误日志、系统环境等)。- **公众号交流**:适合快速咨询。建议优先在相关文章下的公共留言区交流,如私信,请文明礼貌用语😉+- 💡 部署成功了?欢迎来公众号留言点赞,分享你的使用体验~<div align="center">@@ -1857,13 +1948,13 @@ MCP Inspector 是官方调试工具,用于测试 MCP 连接:### 💰 302.AI 新用户福利-> 领取的 1 美元可用于调用各种 AI 大模型(如 Claude、GPT 等)-> 本项目 AI 分析功能需配置大模型使用,配置教程详见 [AI智能分析部署](#-ai-智能分析部署)+> 领取的 1 美元可用于调用各种 AI 大模型(如 Claude、GPT 等)+> 本项目 AI 分析功能需配置大模型使用,配置教程详见 [AI 智能分析](#-ai-智能分析)[](https://share.302.ai/mEOUzG)<details id="sponsor-tutorial">-<summary><b>👉 点击展开: 302.AI 使用教程</b></summary>+<summary>👉 点击展开:<b>302.AI 使用教程</b></summary>### 第 1 步:获取 API Key@@ -1900,7 +1991,7 @@ A: 可以按需充值,按量付费。目前大厂模型价格已相对亲民### 常见问题<details>-<summary><b>👉 点击展开:Q1: HTTP 服务无法启动?</b></summary>+<summary>👉 点击展开:<b>Q1: HTTP 服务无法启动?</b></summary><br>**检查步骤**:@@ -1932,7 +2023,7 @@ A: 可以按需充值,按量付费。目前大厂模型价格已相对亲民</details><details>-<summary><b>👉 点击展开:Q2: 客户端无法连接到 MCP 服务?</b></summary>+<summary>👉 点击展开:<b>Q2: 客户端无法连接到 MCP 服务?</b></summary><br>**解决方案**:@@ -1955,7 +2046,7 @@ A: 可以按需充值,按量付费。目前大厂模型价格已相对亲民</details><details>-<summary><b>👉 点击展开:Q3: 工具调用失败或返回错误?</b></summary>+<summary>👉 点击展开:<b>Q3: 工具调用失败或返回错误?</b></summary><br>**可能原因**:@@ -2004,7 +2095,7 @@ A: 可以按需充值,按量付费。目前大厂模型价格已相对亲民<details>-<summary><strong>👉 点击展开:微信推送通知方案</strong></summary>+<summary>👉 点击展开:<strong>微信推送通知方案</strong></summary><br>> 由于该方案是基于企业微信的插件机制,推送样式也十分不同,所以相关实现我暂时不准备纳入当前项目