Cn Fundamental

---
name: cn-fundamental
description: >
  A股基础数据查询。股票列表、公司信息、每日指标(PE/PB/换手率)、更名历史。
  当用户询问"茅台公司信息""PE是多少""股票列表""万科更名"时触发。
user-invocable: true
metadata:
  openclaw: 1.0.0
  emoji: 🏢
  install: |
    # OpenClaw

    cp -r skills/cn-fundamental ~/.openclaw/skills/
---

# CN Fundamental — A股基础数据

> 所有接口均为 V2 版本（`/api/v2/...`）。

## Curl Setup

```bash
BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")
```

---

## 代码格式规则

| 规则 | 值 |
|------|-----|
| 参数名 | `tsCode` |
| 代码格式 | **带交易所后缀** |
| 日期格式 | `YYYYMMDD` |

---

## 端点详情

### GET /api/v2/cnstock/symbols — 股票列表

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `listStatus` | string | No | `L`(上市), `D`(退市), `P`(暂停上市) |

### GET /api/v2/cnstock/company — 公司信息

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tsCode` | string | **Yes** | 股票代码（如 `000001.SZ`） |
| `exchange` | string | No | `SSE`(上交所), `SZSE`(深交所) |

### GET /api/v2/cnstock/daily-basic — 每日指标

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tsCode` | string | **Yes** | 股票代码（如 `000001.SZ`） |
| `tradeDate` | string | No | 交易日期 YYYYMMDD |

### GET /api/v2/cnstock/name-change — 更名历史

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tsCode` | string | **Yes** | 股票代码（如 `000001.SZ`） |

---

## 调用示例

```bash
# 股票列表
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/symbols?listStatus=L"

# 公司信息
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/company?tsCode=000001.SZ"

# 每日指标（PE/PB/换手率）
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/daily-basic?tsCode=600519.SH&tradeDate=20240115"

# 更名历史
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/name-change?tsCode=000001.SZ"

# 公司信息 + 每日指标并行
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/company?tsCode=600519.SH" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/cnstock/daily-basic?tsCode=600519.SH" &
wait
```

---

## 错误排查

| 错误 | 原因 | 修复 |
|------|------|------|
| 空数据 | `tsCode` 格式错误 | 用 `600519.SH`，不要 `600519` |
| 404 | 端点路径错误 | 不要用 `/profile` 或 `/info`，用 `/company` |
| 400 | 日期格式错误 | 用 `YYYYMMDD`，如 `20240115` |