Hs300 Research V5

SKILL.md

---
name: hs300-research-v5
version: 5.2.0
description: "Research HS300 index constituents for stock analysis and portfolio construction. Use when analyzing CSI 300 stocks, conducting fundamental research on large-cap Chinese equities, or building index-tracking strategies."
---

# 沪深300多因子投研系�?v5.2

AI Agent 个人投研技�?�?自动采集多源数据，计�?8 大类因子，生成结构化投研日报�?
## v5.2 新增
- �?**pywencai(同花顺问�?** 集成 �?自然语言查询补充数据
- �?投研日报新增「问财补充数据」板块（双金�?资金�?北向/高股息）
- ⚠️ **JQData 已禁�?* �?免费版数据截�?026-02-10，已从数据源剔除

## 什么时候使�?
- 用户要求分析 A �?/ 沪深300
- 用户要求多因子选股 / 股票评分
- 用户要求生成投研日报
- 用户要求分析个股基本面或技术面
- 用户要求集合竞价量比分析
- 用户要求查看分红送配 / 资金流向 / 龙虎�?
## 核心工作�?
### 1. 环境检�?```bash
cd hs300_research_system
python -c "import akshare; print('AKShare:', akshare.__version__)"
python data_fetcher.py  # 检查所有数据源状�?```

### 2. 运行完整分析
```bash
python full_analysis_v5.py
# 或新版：
python run_analysis_v3.py
```

运行结果包含�?- 沪深300成分股获取（AKShare�?- 日K线数据（东方财富 �?Tushare Pro �?AKShare�?- 基本面数据（Tushare Pro �?东方财富 �?AKShare�?- 技术面分析（MACD/KDJ/均线�?- 多因子评分（8大类因子�?- **pywencai问财补充**（双金叉/资金�?北向资金/高股息）
- AKShare附加数据（分红送配/资金�?龙虎榜）

⚠️ JQData(聚宽) 已禁用：免费版数据仅�?026-02-10，不再使用�?
### 3. 输出投研日报

报告结构�?```
📊 沪深300多因子投研日�?├── 🌍 市场环境（牛�?熊市/震荡�?+ 建议仓位�?├── 📈 技术信号（MACD金叉/KDJ金叉/均线排列统计�?├── 💰 基本面概况（PE/PB/ROE均值）
├── �?潜力个股 TOP 10（代�?名称/价格/PE/ROE/得分/风险/涨幅�?├── ⚠️ 高风险个�?└── 💡 核心结论
```

### 4. 可选：集合竞价分析
```bash
python call_auction_analysis.py
```

## 数据源架�?
| 数据�?| 覆盖内容 | 降级优先�?|
|--------|---------|-----------|
| pywencai(问财) | 自然语言查询/信号/资金�?北向/高股�?| 补充查询 |
| 东方财富HTTP | 日K�?实时行情/估�?| 1（主力） |
| AKShare | 成分�?分红/资金�?龙虎�?| 2（补充） |
| Tushare Pro | 日线/财务/估�?| 3（需2000+积分�?|
| SZSE/SSE | 交易所官方数据（辅助） | 4 |

### 自动降级�?```
获取日线: 东方财富HTTP �?Tushare Pro �?AKShare
获取估�? 东方财富 �?Tushare Pro �?AKShare
获取财务: Tushare Pro �?AKShare
问财补充: pywencai（自然语言查询�?```

## pywencai(同花顺问�? 查询能力

集成 pywencai 后，支持以下自然语言查询�?
| 查询类型 | 问财语句示例 |
|---------|------------|
| 信号检�?| `MACD金叉` / `KDJ金叉` / `MACD金叉并且KDJ金叉` |
| 资金流向 | `今日主力资金净流入排行` |
| 行业资金�?| `今日行业板块资金流向` |
| 北向资金 | `北向资金增持` |
| 涨停/跌停 | `今日涨停` |
| 高股�?| `股息率大�?%` |
| 高ROE | `ROE大于20%` |
| 自定�?| 任意自然语言问句 |

## 8 大类因子体系

| 因子类别 | 权重 | 指标 |
|---------|------|------|
| 估�?| 25% | PE/PB/PS |
| 质量 | 20% | ROE/ROA/毛利�?净利率 |
| 成长 | 15% | 营收增长/利润增长 |
| 动量 | 15% | 1月涨�?3月涨�?|
| 趋势 | 15% | MACD金叉/KDJ金叉/均线排列 |
| 波动�?| 5% | 年化波动�?ATR |
| 技�?| 5% | 突破信号 |
| 量能 | 5% | 量比/换手�?|

## 配置说明

### JQData（已禁用�?编辑 `jq_config.py`�?```python
JQ_USER = '手机�?
JQ_PASSWORD = '密码'
JQ_AUTH = False  # 免费版数据截�?026-02-10，已禁用
```

### Tushare Pro（可选）
编辑 `tushare_config.py`�?```python
TUSHARE_TOKEN = 'your_token'
TUSHARE_AUTH = True
```

### 依赖安装
```bash
pip install akshare tushare pywencai pandas numpy scipy
```

## pywencai 使用示例
```python
import pywencai
# 双金叉共�?res = pywencai.get(query='MACD金叉并且KDJ金叉')
# 今日资金�?res = pywencai.get(query='今日主力资金净流入排行', sort_key='主力资金净流入(�?')
```

## 注意事项

- JQData 免费版数据有日期范围限制（通常到最近几个月�?- 获取最新实时数据需要升�?JQData 会员（约298�?年）
- 公司网络可能拦截东方财富 push2 API
- 建议配置 OpenClaw Heartbeat 每日 08:30 自动运行

## 文件结构

```
hs300_research_system/
├── full_analysis_v5.py      # 主分析程�?v5.1
├── run_analysis_v3.py       # 主分析程�?v5.2（含pywencai补充数据�?├── data_fetcher.py          # 多数据源采集模块 v5.2
├── factor_calculator_v3.py  # 8大类因子计算�?├── pywencai_fetcher.py      # 同花顺问财数据获取器 ⭐新�?├── market_regime.py         # 市场环境判断
├── risk_management.py       # 风险管理和仓位建�?├── data_quality.py          # 数据质量检�?├── jq_config.py             # JQData 配置（已禁用�?├── tushare_config.py        # Tushare 配置
├── config.py                # 全局配置
├── call_auction_analysis.py # 集合竞价分析
├── requirements.txt         # 依赖清单
└── DATA_SOURCES.md          # 数据源详细说�?v5.2
```

## 输出格式

```
===================================================================
  沪深300多因子投研日�?v5.1
  生成时间: 2026-05-14 14:34:00
===================================================================

技术信�? MACD金叉:1 | KDJ金叉:3 | 均线多头:6 | 均线空头:6
基本�? PE均�?21.9 | ROE均�?2.9%

潜力个股 TOP 10:
  1. 000157 中联重科   �?9.68  PE:19.5  ROE:2.0%  营收:+24.9%  利润:+26.8%  得分:67.0  风险:�? 1�?+9.9%
  2. 000338 潍柴动力   �?25.89 PE:19.0  ROE:3.5%  营收:+16.1%  利润:+44.5%  得分:62.0  风险:�? 1�?+36.3%
  ...

高风�?
  �?601318 中国平安  得分:-0.18  PE:8.5  均线:空头
```