tushare-pro

# SKILL.md - tushare-pro

## 技能信息

| 属性 | 内容 |
|:---|:---|
| **名称** | tushare-pro |
| **版本** | 1.1.0 |
| **分类** | 专业财务数据 |
| **状态** | ✅ 已上线（需Token） |
| **维护者** | FinClaw Core Team |
| **最后更新** | 2026-03-19 |

## 功能描述

专业财务数据Skill，基于Tushare Pro提供高质量的A股基本面数据、三大财务报表（资产负债表、利润表、现金流量表）、股东数据、日线行情等。适合深度财务分析和量化研究。

## 触发意图

### 主要触发词
- "财务数据"、"财务报表"、"三大表"
- "资产负债表"、"利润表"、"现金流量表"
- "ROE"、"净利润"、"营收"、"毛利率"
- "股东"、"前十大流通股东"
- "基本面"、"财务分析"

### Few-shot 示例

| 用户输入 | 识别意图 | 调用函数 |
|:---|:---|:---|
| 贵州茅台的ROE是多少？ | financial_analysis | ts_stock_basic.py 600519.SH |
| 查询宁德时代资产负债表 | balance_sheet | ts_balance_sheet.py 300750.SZ |
| 看一下平安银行的利润表 | income_statement | ts_income.py 000001.SZ |
| 查询股东数据 | shareholder_data | ts_holders.py 600519.SH |
| 获取历史日线数据 | daily_price | ts_daily.py 600519.SH 20260101 20260319 |

## 数据源配置

| 数据类型 | 主要来源 | 认证要求 |
|:---|:---|:---:|
| 股票基础信息 | Tushare Pro | 需Token |
| 资产负债表 | Tushare Pro | 需Token |
| 利润表 | Tushare Pro | 需Token |
| 现金流量表 | Tushare Pro | 需Token |
| 日线行情 | Tushare Pro | 需Token |
| 股东数据 | Tushare Pro | 需Token |

## 环境变量配置

```bash
export TUSHARE_TOKEN="your-token-here"
```

获取Token: https://tushare.pro/register

## 功能列表

### 1. 股票基础信息
- **功能描述**: 获取股票基本信息、IPO日期、行业分类、财务指标等
- **输入参数**: 股票代码（Tushare格式：600519.SH）
- **输出格式**: Markdown表格
- **数据源**: Tushare Pro
- **数据时效**: 日频
- **使用示例**:
  ```bash
  python scripts/ts_stock_basic.py 600519.SH
  ```

### 2. 资产负债表
- **功能描述**: 获取公司资产负债表数据
- **输入参数**: 股票代码、年份（可选）
- **输出格式**: Markdown表格
- **数据源**: Tushare Pro
- **数据时效**: 季度更新
- **使用示例**:
  ```bash
  python scripts/ts_balance_sheet.py 600519.SH 2024
  ```

### 3. 利润表
- **功能描述**: 获取公司利润表数据
- **输入参数**: 股票代码、年份（可选）
- **输出格式**: Markdown表格
- **数据源**: Tushare Pro
- **数据时效**: 季度更新
- **使用示例**:
  ```bash
  python scripts/ts_income.py 600519.SH 2024
  ```

### 4. 现金流量表
- **功能描述**: 获取公司现金流量表数据
- **输入参数**: 股票代码、年份（可选）
- **输出格式**: Markdown表格
- **数据源**: Tushare Pro
- **数据时效**: 季度更新
- **使用示例**:
  ```bash
  python scripts/ts_cashflow.py 600519.SH 2024
  ```

### 5. 日线行情
- **功能描述**: 获取个股日线价格数据
- **输入参数**: 股票代码、开始日期、结束日期
- **输出格式**: CSV/Markdown表格
- **数据源**: Tushare Pro
- **数据时效**: 日频
- **使用示例**:
  ```bash
  python scripts/ts_daily.py 600519.SH 20260101 20260319
  ```

### 6. 股东数据
- **功能描述**: 获取前十大股东/流通股东数据
- **输入参数**: 股票代码
- **输出格式**: Markdown表格
- **数据源**: Tushare Pro
- **数据时效**: 季度更新
- **使用示例**:
  ```bash
  python scripts/ts_holders.py 600519.SH
  ```

## 脚本清单

| 脚本名 | 功能 | 入口点 |
|:---|:---|:---:|
| ts_stock_basic.py | 股票基础信息 | ✅ |
| ts_balance_sheet.py | 资产负债表 | ✅ |
| ts_income.py | 利润表 | ✅ |
| ts_cashflow.py | 现金流量表 | ✅ |
| ts_daily.py | 日线行情 | ✅ |
| ts_holders.py | 股东数据 | ✅ |

## 股票代码格式

Tushare使用 `XXXXXX.XX` 格式：

| 类型 | 格式 | 示例 |
|:---|:---|:---|
| 上海A股 | XXXXXX.SH | 600519.SH (贵州茅台) |
| 深圳A股 | XXXXXX.SZ | 000001.SZ (平安银行) |
| 创业板 | XXXXXX.SZ | 300750.SZ (宁德时代) |
| 科创板 | XXXXXX.SH | 688981.SH (中芯国际) |
| 上证指数 | 000001.SH | 000001.SH |
| 深证成指 | 399001.SZ | 399001.SZ |
| ETF | XXXXXX.SH/SZ | 510300.SH (沪深300ETF) |

## 使用示例

### 命令行调用
```bash
# 设置Token
export TUSHARE_TOKEN="your-token"

# 股票基础信息
python scripts/ts_stock_basic.py 600519.SH

# 三大财务报表
python scripts/ts_balance_sheet.py 600519.SH 2024
python scripts/ts_income.py 600519.SH 2024
python scripts/ts_cashflow.py 600519.SH 2024

# 日线行情
python scripts/ts_daily.py 600519.SH 20240101 20240319

# 股东数据
python scripts/ts_holders.py 600519.SH
```

### Python API调用
```python
import tushare as ts
from finclaw.core.data_annotator import annotate_data

# 设置Token
ts.set_token("your-token")
pro = ts.pro_api()

# 获取财务数据
df = pro.balance_sheet(ts_code='600519.SH', period='20241231')

# 标注数据来源
output = annotate_data(df.to_dict(), source="tushare_pro")
print(output)
```

## 数据来源标注规范

本Skill所有输出数据将按以下格式标注来源：

```markdown
---
📊 **数据来源**: Tushare Pro
⏱️ **数据时间**: 2026-03-19 10:30:15
📌 **报告期**: 2024年年报
🔗 **数据接口**: tushare.pro/document/2
🔧 **分析工具**: FinClaw v1.0
⚠️ **使用限制**: 免费版每日200次调用
```

## 依赖要求

```
tushare>=1.2.0
pandas>=1.3.0
pyyaml>=5.4.0
```

## 使用限制

| 版本 | 每日调用次数 | 数据范围 |
|:---|:---:|:---|
| 免费版 | 200次 | 基础数据，有限历史 |
| 积分版 | 5000+次 | 完整数据，更长历史 |

> 获取更多积分：注册Tushare并完成网站任务

## 性能指标

| 指标 | 目标值 | 当前值 |
|:---|:---:|:---:|
| 数据质量 | > 95% | 98% |
| API响应时间 | < 2s | ~1s |
| 数据准确率 | > 98% | 99% |

## 更新日志

| 版本 | 日期 | 变更内容 |
|:---|:---:|:---|
| 1.1.0 | 2026-03-19 | 符合FinClaw数据规范v1.0，新增数据来源强制标注 |
| 1.0.0 | 2026-03-12 | 初始版本 |

## 相关链接

- Tushare Pro: https://tushare.pro
- Tushare文档: https://tushare.pro/document/2
- FinClaw数据规范: `finclaw/config/data_source_config.yaml`

---

*本Skill遵循 FinClaw 数据规范 v1.0 | 数据来源强制标注 | 禁止训练数据编造*