stock-ai-agent/scripts/README.md
2026-02-19 21:20:20 +08:00

135 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 美股手动分析脚本使用说明
## 📜 脚本列表
| 脚本 | 说明 | 推荐度 |
|------|------|--------|
| `scripts/stock.sh` | 快捷分析脚本(推荐) | ⭐⭐⭐ |
| `scripts/analyze_stock_simple.py` | Python 简化版 | ⭐⭐ |
| `scripts/analyze_stock.py` | Python 完整版 | ⭐ |
## 🚀 快速开始
### 方式 1: 使用快捷脚本(推荐)
```bash
# 分析单只股票
./scripts/stock.sh AAPL
# 分析多只股票
./scripts/stock.sh AAPL TSLA NVDA
# 分析配置的所有股票
./scripts/stock.sh
```
### 方式 2: 使用 Python 脚本
```bash
# 简化版
cd backend
python3 ../scripts/analyze_stock_simple.py AAPL
python3 ../scripts/analyze_stock_simple.py AAPL TSLA NVDA
# 完整版
python3 ../scripts/analyze_stock.py AAPL
python3 ../scripts/analyze_stock.py AAPL TSLA NVDA
```
## 📋 输出示例
```
============================================================
📊 分析 AAPL
============================================================
价格: $178.50 (+1.25%)
K线: ['1d', '1h']
🤖 LLM分析中...
状态: 震荡上涨MACD 金叉形成
🎯 发现 1 个信号:
🟢 做多 [A⭐⭐⭐] 85%
入场: $178.50
止损: $172.80
止盈: $205.28
理由: 突破 MA20 阻力RSI=58 进入强势区...
✅ 完成
```
## ⚙️ 配置说明
`.env` 文件中配置默认股票列表:
```bash
# 美股智能体配置
STOCK_SYMBOLS=AAPL,TSLA,NVDA,MSFT,GOOGL
```
## 📝 完整版功能
完整版脚本 (`analyze_stock.py`) 提供更多详细信息:
- ✅ 当前行情详情
- ✅ K 线数据统计
- ✅ 新闻情绪分析
- ✅ 关键支撑/阻力位
- ✅ 详细信号列表
- ✅ 风险提示
- ✅ 通知预览
## 🔧 依赖要求
确保已安装 yfinance
```bash
cd backend
pip install yfinance
```
## 💡 提示
1. **首次使用**:建议先运行一次 `./scripts/stock.sh` 测试
2. **分析频率**:不要频繁分析,避免 API 限流
3. **最佳时间**:在美股交易时间内分析效果最佳
4. **股票代码**:使用美股代码,如 AAPL, TSLA, NVDA 等
## 📊 支持的股票
任何美股代码都可以分析,常见示例:
- 科技股: AAPL, MSFT, GOOGL, META, AMZN, NVDA, TSLA
- 金融股: JPM, BAC, GS, MS
- 医疗股: JNJ, PFE, UNH, ABT
- 消费股: NKE, KO, MCD, SBUX
## ⚠️ 注意事项
1. 数据来源YFinanceYahoo Finance
2. 数据延迟:约 15 分钟
3. API 限制:过于频繁的请求可能被限流
4. 市场时间:美股交易时间分析效果最佳
## 🆘 故障排除
### 错误ModuleNotFoundError: No module named 'yfinance'
```bash
cd backend
pip install yfinance
```
### 错误:无法获取行情
- 检查股票代码是否正确
- 检查网络连接
- 稍后重试
### 错误LLM 分析失败
- 检查 API 密钥配置
- 检查 DeepSeek/Zhipu API 是否可用