investment-data

# A 股投资数据获取 Skill

基于 [investment_data](https://github.com/chenditc/investment_data) 项目，提供高质量 A 股投资数据。

## 🎯 核心功能

1. **数据下载** - 自动下载最新数据集
2. **数据查询** - 查询股票历史数据
3. **数据更新** - 每日自动更新
4. **多格式支持** - Qlib、CSV、JSON

## 📊 数据类型

- **日终价格** - 开高低收、成交量、成交额
- **涨跌停数据** - 涨跌停价格、涨跌停状态
- **指数数据** - 主要指数价格和权重
- **复权数据** - 前复权、后复权价格

## 🚀 快速开始

### 1. 下载最新数据

```bash
python scripts/download_data.py --latest
```

### 2. 查询股票数据

```python
from scripts.data_client import InvestmentData

# 初始化客户端
client = InvestmentData()

# 查询单只股票
df = client.get_stock_data("000001.SZ", start_date="2024-01-01", end_date="2024-12-31")

# 查询指数成分
weights = client.get_index_weights("000300.SH")

# 查询涨跌停
limits = client.get_limit_data("000001.SZ", date="2024-12-01")
```

### 3. 批量查询

```bash
python scripts/query_batch.py --stocks "000001.SZ,000002.SZ" --start 2024-01-01 --end 2024-12-31 --output csv
```

## 📖 详细文档

- [数据字段说明](references/fields.md)
- [API 参考](references/api.md)
- [使用示例](examples/)
- [常见问题](docs/faq.md)

## 🔧 配置

### 环境变量

```bash
# 数据存储路径（可选）
export INVESTMENT_DATA_DIR=~/.qlib/qlib_data/cn_data

# Tushare Token（可选，用于实时更新）
export TUSHARE_TOKEN=your_token_here
```

### 配置文件

编辑 `config/config.yaml`：

```yaml
data:
  # 数据存储路径
  data_dir: ~/.qlib/qlib_data/cn_data
  
  # 自动更新
  auto_update: true
  update_time: "09:00"
  
  # 数据源优先级
  sources:
    - final
    - ts
    - ak
    - yahoo

query:
  # 默认输出格式
  output_format: csv
  
  # 日期格式
  date_format: "%Y-%m-%d"
```

## 📝 使用示例

### Python API

```python
from scripts.data_client import InvestmentData

client = InvestmentData()

# 查询股票日 K 线
df = client.get_stock_daily("000001.SZ", "2024-01-01", "2024-12-31")
print(df.head())

# 查询指数数据
index_df = client.get_index_daily("00030...

# Investment Data Skill

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://clawhub.com)
[![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)

高质量 A 股投资数据获取工具，基于 [investment_data](https://github.com/chenditc/investment_data) 项目。

## ✨ 特性

- 🚀 **开箱即用** - 一键下载最新数据
- 📊 **高质量数据** - 多数据源交叉验证
- 🔄 **每日更新** - 自动化 CI/CD 流程
- 📈 **完整性好** - 包含退市公司数据
- 🛠️ **多格式支持** - Qlib、CSV、JSON、Excel
- 🔌 **OpenClaw 集成** - 支持自动化工作流

## 📥 安装

### 方法 1：通过 ClawHub（推荐）

```bash
clawhub install investment-data
```

### 方法 2：手动安装

```bash
git clone https://github.com/StanleyChanH/investment-data-skill.git
cd investment-data-skill
pip install -r requirements.txt
```

## 🚀 快速开始

### 1. 下载最新数据

```bash
python scripts/download_data.py --latest
```

### 2. 查询股票数据

#### Python API

```python
from scripts.data_client import InvestmentData

client = InvestmentData()

# 查询股票日 K 线
df = client.get_stock_daily("000001.SZ", "2024-01-01", "2024-12-31")
print(df.head())

# 查询指数
index_df = client.get_index_daily("000300.SH", "2024-01-01", "2024-12-31")

# 查询涨跌停
limits = client.get_limit_data("000001.SZ", date="2024-12-01")
```

#### 命令行

```bash
# 查询单只股票
python scripts/query.py --stock 000001.SZ --start 2024-01-01 --end 2024-12-31

# 批量查询
python scripts/query_batch.py --file stocks.txt --start 2024-01-01 --output json

# 导出 Excel
python scripts/export.py --stock 000001.SZ --format excel
```

## 📊 数据类型

### 1. 日终价格（final_a_stock_eod_price）

| 字段 | 说明 | 类型 |
|------|------|------|
| ts_code | 股票代码 | str |
| trade_date | 交易日期 | date |
| open | 开盘价 | float |
| high | 最高价 | float |
| low | 最低价 | float |
| close | 收盘价 | float |
| vol | 成交量（万手） | float |
| amount | 成交额（千元） | float |
| adj_factor | 复权因子 | float |

### 2. 涨跌停数据（final_a_stock_limit）

| 字段 |...