Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TrendRadar 美股热点新闻聚合分析工具

Version Python License MCP

一站式美股热点新闻聚合、AI分析、自动推送解决方案

功能特点快速开始配置指南Web界面MCP集成


📖 目录


项目简介

TrendRadar 是一款专为美股投资者设计的热点新闻聚合分析工具。它能自动从多个财经数据源抓取新闻,利用 AI 进行智能分析和筛选,生成专业的市场分析报告,并支持自动推送到 Telegram、企业微信等平台。

🎯 适用人群

  • 美股投资者:快速获取市场热点和投资机会
  • 财经自媒体:自动生成专业分析文章
  • 金融从业者:高效跟踪市场动态
  • 研究人员:收集和分析财经新闻数据

🚀 部署方式

方式 难度 适用场景
本地运行 ⭐ 简单 个人使用,数据本地存储
Docker ⭐⭐ 中等 服务器部署,稳定运行
GitHub Actions ⭐⭐⭐ 进阶 自动定时抓取,无需服务器

功能特点

🔥 核心功能

功能 说明
多源聚合 支持 20+ 财经数据源,包括华尔街见闻、Bloomberg、Reuters 等
AI 智能分析 支持多种 AI 模型(DeepSeek、GPT、Claude 等)进行新闻分析
自动推送 支持 Telegram、企业微信、飞书、钉钉等多种推送渠道
定时任务 支持多种预设模式,自动定时抓取和推送
Web 界面 现代化 Web 界面,操作简单直观
MCP 集成 支持 Cherry Studio 等 MCP 客户端,通过对话使用工具
美股筛选 自动识别美股相关新闻,智能分类

📊 数据源支持

国内中文友好(无需海外网络)

  • 华尔街见闻、财联社、新浪财经、雪球、英为财情、金十数据

国际权威平台

  • Bloomberg、Reuters、WSJ、CNBC、Financial Times

海外特色平台

  • Seeking Alpha、Yahoo Finance、SEC、Finviz

📬 推送渠道

渠道 消息格式 配置项
Telegram HTML Bot Token + Chat ID
企业微信 Markdown Webhook URL
飞书 纯文本 Webhook URL
钉钉 Markdown Webhook URL + Secret
Slack mrkdwn Webhook URL
Email HTML SMTP 配置
ntfy Markdown Server URL + Topic
Bark Markdown URL

系统要求

必需环境

软件 版本要求 下载地址 说明
Python 3.10 或更高 python.org 必须勾选 "Add Python to PATH"
Node.js 18 或更高 nodejs.org 建议下载 LTS 版本(可选,用于 Web 前端)

操作系统

  • Windows 10/11(推荐)
  • 也可在 macOS 和 Linux 上运行

快速开始

方式一:一键安装(推荐小白)

第一步:安装 Python

  1. 访问 Python 官网
  2. 下载 Python 3.10 或更高版本
  3. 重要:安装时务必勾选 "Add Python to PATH" 选项
  4. 安装完成后,打开命令提示符验证:
    python --version
    

第二步:安装 Node.js(可选)

  1. 访问 Node.js 官网
  2. 下载 LTS 版本
  3. 验证安装:node --version

第三步:运行安装脚本

  1. 解压项目文件到任意目录
  2. 双击运行 setup.bat
  3. 等待安装完成(约 5-10 分钟)

第四步:配置 API Key

  1. 双击运行 start.bat
  2. 首次运行会自动创建配置文件并打开记事本
  3. 填写 API Key(详见配置指南
  4. 保存并关闭记事本
  5. 再次运行 start.bat 启动程序

第五步:开始使用

  • 浏览器访问:http://localhost:3000
  • 后端 API:http://localhost:8080

方式二:手动安装

# 1. 进入项目目录
cd TrendRadar-6.5.2

# 2. 创建虚拟环境
python -m venv .venv

# 3. 激活虚拟环境
.venv\Scripts\activate

# 4. 安装 Python 依赖
pip install -r requirements.txt

# 5. 安装前端依赖
cd web/frontend && npm install && cd ../..

# 6. 复制配置文件
copy config\config.example.yaml config\config.yaml

# 7. 编辑配置文件
notepad config\config.yaml

# 8. 启动服务
start.bat

配置指南

AI 模型配置

支持的 AI 模型

提供商 模型示例 特点 价格
DeepSeek deepseek-chat 推理强,价格低 💰 最便宜
OpenAI gpt-4o, gpt-4-turbo 效果最好 💰💰 较贵
Claude claude-3-5-sonnet 编程能力强 💰💰 较贵
通义千问 qwen-max 国产模型 💰 便宜
Kimi kimi-latest 长文本处理 💰 便宜

获取 API Key

DeepSeek(推荐新手):

  1. 访问 DeepSeek 官网
  2. 注册账号并登录
  3. 进入「API Keys」页面
  4. 点击「创建 API Key」
  5. 复制生成的 Key(格式:sk-xxxxxxxx

配置方法

方法一:Web 界面配置(推荐)

  1. 进入「设置」页面
  2. 选择 AI 提供商
  3. 输入 API Key
  4. 选择模型
  5. 点击「测试连接」验证
  6. 点击「保存配置」

方法二:编辑配置文件

ai:
  model: "deepseek/deepseek-chat"
  api_key: "sk-你的API密钥"
  api_base: "https://api.deepseek.com/v1"
  timeout: 120
  temperature: 1.0
  max_tokens: 5000

推送通知配置

Telegram 配置(推荐)

第一步:创建 Bot

  1. 在 Telegram 搜索 @BotFather
  2. 发送 /newbot 命令
  3. 按提示设置 Bot 名称
  4. 复制返回的 Token

第二步:获取 Chat ID

  1. 搜索 @userinfobot
  2. 发送任意消息
  3. 获取返回的 Chat ID

第三步:配置

notification:
  enabled: true
  channels:
    telegram:
      bot_token: "123456789:ABCdef..."
      chat_id: "123456789"

数据源配置

platforms:
  enabled: true
  sources:
    - id: "wallstreetcn-hot"
      name: "华尔街见闻"
      enabled: true

rss:
  enabled: true
  feeds:
    - id: "yahoo-finance"
      name: "雅虎财经"
      url: "https://finance.yahoo.com/news/rssindex"
      enabled: true

Web界面使用

界面功能

1. 数据概览(Dashboard)

  • 今日新闻统计
  • 近 7 天趋势图表
  • 快速启动爬虫
  • 一键工作流

2. 新闻列表(News)

  • 查看抓取的新闻
  • 美股筛选功能
  • 关键词搜索
  • 批量删除

3. 数据源(Sources)

  • 管理热榜平台
  • 管理 RSS 订阅
  • 启用/禁用数据源

4. 文案生成(Article)

  • 选择新闻生成分析文章
  • 多种写作风格
  • 主题指定
  • 润色优化
  • 发送到 Telegram

5. 定时任务(Schedule)

  • 查看任务配置
  • 手动执行任务
  • 查看执行日志

6. 系统设置(Settings)

  • 配置 AI 模型
  • 配置推送渠道
  • 测试连接

一键工作流

自动执行:爬取数据生成文案发送推送

定时任务预设

模式 说明 推送时间
us_stock_morning 美股早报 07:00-08:00
morning_evening 早晚汇总 09:00, 18:00
always_on 全天监控 有新新闻立即推送
office_hours 工作时间 09:00-18:00
night_owl 夜猫子 22:00-02:00

MCP集成

TrendRadar 支持 MCP (Model Context Protocol) 协议,可以通过 Cherry Studio 等 AI 客户端以对话方式使用工具。

Cherry Studio 配置

第一步:下载 Cherry Studio

第二步:获取项目代码

方式一:Git Clone(推荐)

git clone https://github.com/sansan0/TrendRadar.git
cd TrendRadar

方式二:下载 ZIP

  • 点击项目页面 "Code" → "Download ZIP"

第三步:安装 MCP 服务器

Windows: 双击运行 setup.bat

Mac:

chmod +x setup-mac.sh
./setup-mac.sh

第四步:配置 Cherry Studio

  1. 打开 Cherry Studio
  2. 点击右上角 ⚙️ 设置
  3. 找到 MCP → 点击 添加
  4. 填写配置信息
  5. 保存并启用

第五步:验证

在对话框输入:

帮我爬取最新的新闻

如果配置成功,AI 会调用 TrendRadar 工具并返回真实数据。


MCP工具问答

工具一览

分类 工具名称 功能简介
日期 resolve_date_range 解析"本周"、"最近7天"等自然语言
查询 get_latest_news 获取最新热榜新闻
get_news_by_date 按日期范围查询历史新闻
get_trending_topics 获取热点话题统计
RSS get_latest_rss 获取最新 RSS 订阅内容
search_rss 在 RSS 中搜索关键词
搜索 search_news 统一搜索新闻
find_related_news 查找相似新闻
分析 analyze_topic_trend 话题趋势分析
analyze_sentiment 新闻情感分析
aggregate_news 跨平台新闻聚合去重
compare_periods 时期对比分析
generate_summary_report 生成摘要报告
系统 get_current_config 获取系统配置
get_system_status 获取系统状态
trigger_crawl 手动触发爬取
存储 sync_from_remote 从远程同步数据
list_available_dates 列出可用日期
文章 read_article 读取文章内容
read_articles_batch 批量读取文章
通知 send_notification 发送通知消息

常用问答示例

Q1: 如何查看最新新闻?

给我看看最新的新闻
查询今天的热点新闻
获取知乎和微博的最新10条新闻

Q2: 如何搜索特定关键词?

搜索包含"人工智能"的新闻
查找关于"特斯拉降价"的报道
搜索最近7天关于"iPhone"的新闻

Q3: 如何分析话题趋势?

分析"人工智能"最近一周的热度趋势
看看"特斯拉"话题是昙花一现还是持续热点
今天有哪些突然爆火的话题

Q4: 如何手动触发爬取?

帮我爬取最新的新闻
抓取知乎和微博的新闻并保存

Q5: 如何发送通知?

查看当前配置了哪些通知渠道
发送今天的新闻摘要到钉钉
把这段内容推送到飞书

默认设置说明

默认设置 说明 如何调整
限制条数 默认返回 50 条 说"返回前 10 条"
时间范围 默认查询今天 说"查询昨天"、"最近一周"
URL 链接 默认不返回 说"需要链接"

常见问题

Q1: 启动失败,提示找不到 Python?

  1. 确认已安装 Python 3.10+
  2. 安装时务必勾选 "Add Python to PATH"
  3. 重新打开命令提示符验证:python --version

Q2: 浏览器显示"无法访问此网站"?

  1. 等待服务完全启动(约 10-15 秒)
  2. 手动刷新页面
  3. 检查命令行窗口是否有错误
  4. 尝试访问 http://localhost:8080

Q3: AI 连接失败?

  1. 检查 API Key 是否正确
  2. 检查网络是否能访问 API 服务
  3. 点击「测试连接」查看具体错误
  4. 尝试切换其他 AI 提供商

Q4: Telegram 发送失败?

  1. 确认 Bot Token 正确
  2. 确认 Chat ID 正确
  3. 重要:必须先向 Bot 发送一条消息
  4. 点击「测试发送」查看具体错误

Q5: 端口被占用怎么办?

  1. 运行 stop.bat 停止服务
  2. 或手动关闭占用 8080/3000 端口的程序
  3. 重新运行 start.bat

Q6: 如何更新到最新版本?

  1. 下载最新版本
  2. 复制 config/config.yaml 到新版本
  3. 运行 setup.bat 重新安装依赖
  4. 运行 start.bat 启动

文件结构

TrendRadar-6.5.2/
├── 📄 setup.bat              # 一键安装脚本
├── 📄 start.bat              # 启动脚本
├── 📄 stop.bat               # 停止脚本
├── 📄 requirements.txt       # Python 依赖
├── 📄 README.md              # 本文档
│
├── 📁 config/                # 配置文件
│   ├── config.yaml           # 主配置
│   ├── config.example.yaml   # 配置模板
│   └── timeline.yaml         # 定时任务
│
├── 📁 trendradar/            # 核心代码
│   ├── ai/                   # AI 分析
│   ├── crawler/              # 爬虫模块
│   ├── notification/         # 推送模块
│   └── storage/              # 存储模块
│
├── 📁 web/                   # Web 界面
│   ├── api/                  # 后端 API
│   └── frontend/             # 前端界面
│
├── 📁 mcp_server/            # MCP 服务器
│
└── 📁 output/                # 输出数据

技术支持


开源协议

本项目采用 MIT 协议开源,欢迎 Star ⭐ 和 Fork 🍴


如果这个项目对你有帮助,请给一个 ⭐ Star 支持一下!

Made with ❤️ by TrendRadar Team

About

一站式美股热点新闻聚合、AI分析、自动推送解决方案

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages