StockRadar

AI 驱动的股票分析与新闻雷达系统，面向 A 股 / 港股 / 美股。每天自动分析自选股与大盘， 生成决策仪表板并推送到多个通知渠道。支持 CLI、FastAPI、WebUI、Docker 与 GitHub Actions。

主要特性

• 多市场支持：A 股、港股、美股与美股指数
• 多模型接入：Gemini / OpenAI 兼容 / DeepSeek / Qwen / Claude（通过 LiteLLM 统一调用）
• 多数据源：AkShare / Tushare / Pytdx / Baostock / YFinance
• 智能分析：趋势判断、关键位、风险提示、新闻情绪
• 多渠道通知：Telegram / Discord / 邮件 / 企业微信 / 飞书 / 自定义 Webhook
• 运行方式灵活：本地定时、GitHub Actions、Docker 部署
• 可选增强：Agent 策略问股、回测验证、图片识股

快速开始（本地运行）

1. 安装依赖

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

2. 配置环境变量

copy .env.example .env

最小必填配置（至少三项）：

• STOCK_LIST=600519,AAPL,hk00700
• GEMINI_API_KEY=... 或 OPENAI_API_KEY=...
• 至少一个通知渠道（例如 TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID）

可选但推荐：TAVILY_API_KEYS（新闻搜索）。

3. 运行

python main.py

常用命令：

python main.py --market-review
python main.py --stocks 600519,000001
python main.py --no-notify
python main.py --schedule

GitHub Actions（零服务器）

1. Fork 本仓库
2. 配置仓库 Secrets（至少：AI Key、STOCK_LIST、通知渠道）
3. 启用 Actions 并手动运行一次确认成功

默认在工作日定时执行，具体时间以 workflow 配置为准。

Docker 部署

copy .env.example .env
notepad .env

docker-compose -f docker/docker-compose.yml up -d server

服务启动后访问：http://127.0.0.1:8000

WebUI 与 API

• WebUI：python main.py --webui
• FastAPI：python main.py --serve-only --host 0.0.0.0 --port 8000

常用接口：

• POST /api/v1/analysis/analyze
• GET /api/v1/analysis/tasks
• GET /api/v1/analysis/status/{task_id}
• GET /api/v1/history
• POST /api/v1/backtest/run

项目结构

.
├─ main.py                 # 主入口
├─ server.py               # FastAPI 服务入口
├─ src/                    # 核心业务逻辑
├─ api/                    # API 路由
├─ bot/                    # 机器人与通知适配
├─ data_provider/          # 数据源适配
├─ apps/                   # Web 前端
├─ docker/                 # Docker 配置
├─ docs/                   # 详细文档
└─ strategies/             # 策略模板

免责声明

本项目仅供学习与研究使用，不构成投资建议。股市有风险，投资需谨慎。

License

MIT License