# 📈 指数估值查询服务

基于雪球 API 的指数估值查询 MCP Server，提供指数估值数据。

## ✨ 功能特性

- 🔄 **权威数据**：调用雪球基金[指数估值](https://danjuanfunds.com/rn/value-center)数据 API，获取估值
- 🎯 **63个指数**：覆盖 行业、宽基、策略等类型指数
- 📊 **最新查询**：支持模糊匹配、批量查询、估值筛选
- 📈 **历史估值**：查询历史数据，分析估值趋势
- ⚡ **MCP 协议**：可集成到 Claude Code、Cursor 等 AI 工具
- 💾 **自动缓存**：1小时自动刷新，减少 API 调用

## 📦 快速开始

### 1. 安装依赖
```bash
cd /YOUR-PATH-TO/index_valuation
uv venv
source .venv/bin/activate
uv pip install mcp requests
```

### 2. 测试服务状态
```bash
source .venv/bin/activate
python3 tests/test_mcp_server.py
```

### 3. 配置 MCP

编辑 Claude Code 配置文件 `~/.claude/settings.json`：

```json
{
  "mcpServers": {
    "index-valuation": {
      "command": "/YOUR-PATH-TO/index_valuation/.venv/bin/python",
      "args": ["/YOUR-PATH-TO/index_valuation/mcp_server.py"],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "PYTHONPATH": "/YOUR-PATH-TO/index_valuation"
      },
      "description": "指数估值查询服务（支持最新+历史查询）"
    }
  }
}
```

### 4. 重启 Claude Code

配置完成后，重启 Claude Code。

## 开始享用

### 🛠️ 可用工具

| 工具 | 描述 | 使用场景 |
|------|------|----------|
| `get_index_valuation` | 查询单个指数估值（最新） | "沪深300估值如何" |
| `get_batch_indices` | 批量查询多个指数估值 | "查询沪深300、中证红利" |
| `search_indices` | 搜索指数（支持名称/代码） | "搜索中证银行" |
| `filter_by_valuation` | 按估值状态筛选指数 | "找出低估指数" |
| `fetch_latest_data` | 刷新最新估值数据 | "刷新最新估值" |
| `get_index_history` | 查询单个指数的历史估值数据 | "沪深300最近7天的历史数据" |
| `get_trend_analysis` | 分析指数估值趋势 | "分析沪深300的估值趋势" |
| `get_history_summary` | 获取历史数据概况 | "查看历史数据总量" |

###  示例

在 Claude Code 中直接对话：

#### 示例对话 1: 查询单个指数
```
帮我查询沪深300的估值
```

#### 示例对话 2: 找出低估指数
```
列出所有估值偏低的指数
```

#### 示例对话 3: 批量查询
```
查询沪深300、中证红利、中证白酒的估值情况
```

#### 示例对话 4: 搜索指数
```
帮我找一下中证银行的估值
```

#### 示例对话 5: 查询历史数据
```
帮我查询沪深300最近7天的历史估值数据
```

#### 示例对话 6: 分析估值趋势
```
分析一下沪深300的估值趋势
```

## 🚀 历史估值查询功能

MCP Server 支持查询历史估值数据和分析趋势：

### 收集历史数据

### 收集历史数据

```bash
# 1. 抓取今日数据（创建 data/history_data.csv）
source .venv/bin/activate
python3 archive/history_data_manager.py

# 2. 查看数据概况
python3 archive/history_data_manager.py --list

# 3. 配置定时任务（每天自动抓取）
# 参考 HISTORY_README.md
```

> 💡 **提示**：历史数据需要每日手动抓取，建议配置定时任务自动收集。

更多详情：[HISTORY_README.md](HISTORY_README.md)

## 📈 数据来源

- **数据源**: [雪球基金](https://danjuanfunds.com/rn/value-center?channel=1300100141)
- **更新频率**: 1小时缓存 + 手动刷新。数据源实际一天更新一次
- **数据量**: 目前包含 63 个指数
- **包含字段**:
  - 指数名称、代码、类型
  - PE、PE百分位、PB、PB百分位
  - 股息率、ROE、预测PEG
  - 估值状态（偏低/适中/偏高）

  [指数估值使用说明书](https://danjuanfunds.com/activity/warband-team/zsgzsms)