fund-screener

# 基金筛选器 (Fund Screener)

智能基金筛选与评级工具，帮助用户从海量基金中快速找到优质标的。

## 功能概述

- **多维度筛选**: 收益、风险、规模、费率、成立年限等
- **智能评级**: 五星评级体系（收益、风险、规模、经理、费用）
- **同类排名**: 在相同类型基金中排名对比
- **经理评估**: 基金经理历史业绩与能力评估
- **智能推荐**: 基于用户偏好推荐基金

## 使用方法

### 命令行调用

```bash
# 基础筛选
fund-screen --type 股票型 --min-return 15 --max-risk 20

# 高级筛选
fund-screen --type 混合型 --scale-min 10 --manager-experience 3 --fee-max 1.5

# 查看详情
fund-screen --code 000001 --detail

# 同类对比
fund-screen --compare 000001,000002,000003
```

### Python API

```python
from fund_screener import FundScreener

screener = FundScreener()

# 筛选基金
results = screener.screen(
    fund_type='股票型',
    min_return_1y=15,
    max_volatility=20,
    min_scale=10
)

# 获取评级
rating = screener.get_rating('000001')
```

## 筛选参数

| 参数 | 类型 | 说明 | 示例 |
|:---|:---:|:---|:---|
| fund_type | str | 基金类型 | '股票型', '混合型', '债券型' |
| min_return_1y | float | 近1年最小收益(%) | 15 |
| max_volatility | float | 最大波动率(%) | 20 |
| min_scale | float | 最小规模(亿) | 10 |
| max_fee | float | 最大管理费率(%) | 1.5 |
| manager_exp | int | 基金经理从业年限 | 3 |
| rating_min | int | 最低星级(1-5) | 4 |

## 输出格式

### 筛选结果

```json
{
  "total_found": 150,
  "filters_applied": {...},
  "funds": [
    {
      "rank": 1,
      "fund_code": "000001",
      "fund_name": "华夏成长混合",
      "fund_type": "混合型",
      "nav": 1.5234,
      "return_1y": 25.3,
      "return_3y": 45.2,
      "volatility": 18.5,
      "sharpe": 1.45,
      "max_drawdown": -15.2,
      "scale": 156.8,
      "manager": "张三",
      "manager_exp": 8,
      "expense_ratio": 1.2,
      "rating": {
        "overall": 5,
        "return": 5,
        "risk": 4,
        "scale": 5,
        "manager": 5,
        "fee": 4
      },
      "peer_rank": 15
    }
  ]
}
```

## 评级体系

### 五星评级标准

| 维度 | 5星 | 4星 | 3星 | 2星 | 1星 |
|:---|:---:|:---:|:---:|:---:|:---:|
| 收益 | 前10% | 10-30% | 30-50% | 50-70% | 后30% |
| 风险 | 波动<15% | 15-20% | 20-25% | 25-30% | >30% |
| 规模 | >100亿 | 50-100亿 | 20-50亿 | 5-20亿 | <5亿 |
| 经理 | >10年 | 7-10年 | 5-7年 | 3-5年 | <3年 |
| 费用 | <1% | 1-1.2% | 1.2-1.5% | 1.5-2% | >2% |

### 综合评级算法

```
综合评分 = 收益*0.3 + 风险*0.25 + 规模*0.15 + 经理*0.2 + 费用*0.1
星级 = round(综合评分)
```

## 数据源

- **同花顺iFinD API**: 净值、规模、持仓
- **AkShare**: 基金基本信息
- **天天基金网**: 费率数据
- **本地缓存**: 30分钟

## 示例

### 示例1: 筛选高收益股票型基金

**输入**:
```
筛选股票型基金，近1年收益大于20%，规模大于50亿
```

**输出**:
```
筛选条件: 股票型 | 近1年收益>20% | 规模>50亿
共找到 12 只基金:

排名 代码     名称              近1年收益  规模(亿)  评级
1    000001   华夏成长混合      25.3%     156.8    ⭐⭐⭐⭐⭐
2    000002   易方达蓝筹精选    22.1%     234.5    ⭐⭐⭐⭐⭐
3    000003   中欧时代先锋      21.7%      89.3    ⭐⭐⭐⭐
```

### 示例2: 对比多只基金

**输入**:
```
对比基金 000001, 000002, 000003
```

**输出**:
```
基金对比分析:

指标          华夏成长    易方达蓝筹   中欧时代
─────────────────────────────────────────────
近1年收益      25.3%       22.1%       21.7%
近3年收益      68.5%       55.2%       48.9%
波动率         18.5%       16.2%       20.1%
夏普比率       1.45        1.42        1.15
最大回撤       -15.2%      -12.8%      -18.5%
基金规模       156.8亿     234.5亿      89.3亿
管理费率       1.20%       1.50%       1.20%
基金经理       张三        李四         王五
经理年限       8年         12年         6年
─────────────────────────────────────────────
综合评级       ⭐⭐⭐⭐⭐     ⭐⭐⭐⭐⭐      ⭐⭐⭐⭐
同类排名       15/523      23/523       45/523
```

## 注意事项

1. 数据更新频率：净值每日更新，规模每季度更新
2. 评级基于历史数据，不代表未来表现
3. 基金投资有风险，筛选结果仅供参考
4. 建议结合自身风险承受能力选择

## 依赖

```
pandas>=1.3.0
numpy>=1.20.0
requests>=2.25.0
akshare>=1.10.0
```

## 作者

FinClaw - 上海财经大学金融研究工具