---
name: westock-data
description: 查询A股、港股、美股个股/指数/ETF的详细数据，包括：K线/分时、财务报表（三大报表多期查询，支持跨市场批量对比）、资金流向、技术指标、筹码分析、股东结构、分红除权、业绩预告、公司简况、ETF基金数据（详情/持仓/净值）；以及大盘指数、行业/板块、热搜、新股日历、投资日历等市场数据。
---

# WeStock Data

**数据源**：腾讯自选股行情数据接口 | **支持市场**：A股（沪深/科创/北交所）、港股、美股

---

## 已知限制速查

| 限制项 | 说明 |
|--------|------|
| 龙虎榜/大宗交易/融资融券 | 仅支持沪深市场（sh/sz） |
| 筹码成本 | 仅支持沪深京A股（sh/sz/bj） |
| 股东结构 | 仅支持A股和港股 |
| 货币单位 | 港股返回港元/美元，美股返回美元，展示时必须标注正确货币单位，禁止使用人民币符号 |
| `search`/`minute` | 不支持批量查询 |
| 分时数据 | `minute` 仅支持单股查询 |

---

## 批量查询

**所有查询类命令均支持逗号分隔多股代码**，返回 `BatchResult` 结构（`status` + `data[]` + `errors[]` + `metadata`）。

```bash
westock-data kline sh600000 day 20          # 单股
westock-data kline sh600000,sh600519 day 20  # 批量（返回 BatchResult）
```

> `search` 和 `minute` 不支持批量查询。详细 BatchResult 结构见 [references/ai_usage_guide.md](./references/ai_usage_guide.md)

---

## 核心命令

### 1. 股票搜索

```bash
westock-data search 腾讯控股 # 搜索股票、ETF、指数
westock-data search 科技 sector     # 搜索板块
```

### 2. K线

```bash
westock-data kline sh600000 day 20
westock-data kline hk00700 week 10
westock-data kline usAAPL m30 50
westock-data kline sz000001 day 60 qfq    # 前复权
westock-data kline sh600000,sh600519 day 20
```

**周期**：`day`/`week`/`month`/`season`/`year`（⚠️ 分钟K线不支持，请用 `minute`）

**复权**：默认前复权、`qfq`(前复权)、`hfq`(后复权)、`bfq`(不复权)，最大2000条

**返回**：Markdown 表格，列含 `date`/`open`/`last`(收盘)/`high`/`low`/`volume`/`amount`/`exchange`(换手率%)

### 3. 分时

```bash
westock-data minute sh600000        # 1日分时
westock-data minute sh600000 5      # 5日分时
```

**返回**：Markdown 表格，列含 `code`/`date`(多日时)/`time`/`price`/`volume`/`amount`

### 4. 财务报表

> 默认返回最新1期，数字参数指定多期

```bash
# A股：lrb(利润表) / zcfz(资产负债表) / xjll(现金流量表)
westock-data finance sh600000           # 完整财报，最新1期
westock-data finance sh600000 4         # 完整财报，最近4期
westock-data finance sh600000 lrb 8     # 最近8期利润表

# 港股：zhsy(综合损益表) / zcfz / xjll
westock-data finance hk00700 4
westock-data finance hk00700 zhsy 4

# 美股：income / balance / cashflow
westock-data finance usBABA 4
westock-data finance usBABA income 4    # 仅利润表
```

> ⚠️ **货币单位**：港股返回港元/美元，美股返回美元，展示时必须标注正确货币单位，禁止使用人民币符号

### 5. 公司简况

```bash
westock-data profile sh600000
westock-data profile sh600000,hk00700,usAAPL
```

### 6. 资金与交易分析

```bash
# 港股（TotalNetFlow/MainNetFlow/ShortRatio/LgtHoldInfo）
westock-data hkfund hk00700
westock-data hkfund hk00700 2026-03-10
westock-data hkfund hk00700,hk01810 2026-03-10

# A股（MainNetFlow/JumboNetFlow/BlockNetFlow/MainInflowRank）
westock-data asfund sh600000
westock-data asfund sh600000,sz000001 2026-03-10

# 美股卖空（ShortRatio/ShortShares/ShortRecoverDays）
westock-data usfund usAAPL
westock-data usfund usAAPL,usTSLA 2026-03-10

# 龙虎榜（仅沪深市场）
# 龙虎榜（仅沪深市场，查询单只股票）
westock-data lhb sz000001             # 查询股票龙虎榜
westock-data lhb sz000001 2026-03-20  # 指定日期

# 大宗交易（仅沪深市场，查询单只股票）
westock-data blocktrade sz000001             # 查询股票大宗交易
westock-data blocktrade sz000001 2026-03-20  # 指定日期

# 融资融券（仅沪深市场，查询单只股票）
westock-data margintrade sz000001             # 查询股票融资融券
westock-data margintrade sz000001 2026-03-20  # 指定日期
```

> ⚠️ **龙虎榜/大宗交易/融资融券** 仅支持沪深市场（sh/sz）

### 7. 技术指标

```bash
westock-data technical sh600000             # 全部指标（最新）
westock-data technical sh600000 macd        # 特定分组
westock-data technical sh600000 ma,rsi      # 多分组
westock-data technical sh600000,hk00700 all # 批量
westock-data technical sh600000 all 2026-03-01              # 指定日期
westock-data technical sh600000 macd 2026-02-01 2026-03-01  # 历史区间
```

**指标分组**：`ma`(均线)、`macd`、`kdj`、`rsi`、`boll`(布林带)、`bias`(乖离率)、`wr`(威廉)、`dmi`(SAR/DMI)、`all`(全部)

### 8. 筹码成本

> ⚠️ 仅支持沪深A股（sh/sz/bj）

```bash
westock-data chip sh600519
westock-data chip sh600519,sz000001
westock-data chip sh600519 2026-03-01
westock-data chip sh600519 2026-02-01 2026-03-01
```

**关键字段**：`chipProfitRate`(盈利率%)、`chipAvgCost`(平均成本)、`chipConcentration90/70`(集中度%)

### 9. 股东结构

> ⚠️ 仅支持A股和港股

```bash
westock-data shareholder sh600519     # A股：十大股东、十大流通股东、股东户数变动
westock-data shareholder hk00700      # 港股：持股股东+股东分布+机构持仓
westock-data shareholder sh600519,hk00700
```

**A股关键字段**：`top10Shareholders`(十大股东)、`top10FloatShareholders`(十大流通股东)、`shareholderNum`(股东户数：总户数/A股户数/户均持股，多期历史对比)

### 10. 分红数据

```bash
# 分红指标（A股/港股/美股）
westock-data dividend sh600519
westock-data dividend sh600519,hk00700,usAAPL

# 分红历史（A股/港股/美股）
westock-data dividend history sh600519
westock-data dividend history hk00700,usAAPL
westock-data dividend history sh600519,hk00700,usAAPL --years 10
```

**关键字段**：`dividendRatioTTM`(股息率TTM%)、`dividendTTM`(股息TTM)、`dividendPS`(每股股利,A股)

### 11. ETF 基金数据

```bash
# ETF 详情（基本信息+行情+申赎状态+持有人+财务指标）
westock-data etf sh510300
westock-data etf sh510300,sz159915
westock-data etf sh510300 2026-03-20

# ETF 持仓明细
westock-data etf-holdings sh510300
westock-data etf-holdings sh510300,sz159915

# ETF 净值历史
westock-data etf-nav sh510300 2026-01-01 2026-03-31

# ETF 公司信息（管理人、托管人、基金经理等）
westock-data etf-company sh510300
westock-data etf-company sh510300,sz159915

# ETF 持有人结构
westock-data etf-holders sh510300
westock-data etf-holders sh510300,sz159915

# ETF 财务指标
westock-data etf-financial sh510300
westock-data etf-financial sh510300,sz159915
```

**关键字段**：
- `etfType`：ETF类别
- `manageInstitution`：管理人
- `trusteeInstitution`：托管人
- `trackIndexCode`/`trackIndexName`：跟踪指数
- `purchaseStatus`/`redemptionStatus`：申购/赎回状态
- `holdings`：持仓明细列表
- `managers`：基金经理信息
- `holderAccount`：持有人户数
- `individualHolderRatio`/`institutionHolderRatio`：个人/机构持有比例
- `totalAssets`：总资产
- `stockRatio`/`bondRatio`/`fundRatio`：资产配置占比

---

## 平台特色数据

### 热搜

```bash
westock-data hot stock      # 热搜股票
westock-data hot board 10   # 热门板块
westock-data hot etf        # 热搜ETF
```

### 行业概念

```bash
westock-data board    # 热门板块首页（行业资金流向、涨幅排名、北向资金等）
```

### 投资日历

```bash
westock-data calendar                           # 有重要事件的日期列表
westock-data calendar 2026-03-10                # 某日事件详情
westock-data calendar 2026-03-10 30 1           # 按地区筛选
westock-data calendar 2026-03-10 30 1 1         # 按地区+指标筛选
```

**参数说明**：

| 参数位置 | 说明 | 可选值 |
|---------|------|--------|
| 日期 | 查询日期，不传则返回有事件的日期列表 | `YYYY-MM-DD` |
| 天数 | 向后查询天数，默认30 | 数字 |
| 地区 | 筛选地区 | `1`=中国，`2`=美国，`3`=港股，不传=全部 |
| 指标类型 | 筛选指标类型 | `1`=经济，`2`=央行，`3`=事件，`4`=休市，不传=全部 |

### 新股日历

```bash
westock-data ipo hs         # 沪深新股（默认90天）
westock-data ipo hk         # 港股新股
westock-data ipo us         # 美股新股
westock-data ipo hs 60      # 指定天数
```

### 分红除权日历

```bash
westock-data exdiv sh600519
westock-data exdiv hk00700
westock-data exdiv usAAPL
westock-data exdiv sh600519,hk00700,usAAPL
```

### 业绩预告

```bash
westock-data reserve sh600519           # A股业绩预告
westock-data reserve hk00700            # 港股业绩预披露
westock-data reserve usAAPL             # 美股业绩预约披露
westock-data reserve sh600519,hk00700,usAAPL  # 批量查询
```

### 停复牌信息

```bash
westock-data suspension hs              # 沪深A股停复牌列表
westock-data suspension hk              # 港股停复牌列表
westock-data suspension us              # 美股停复牌列表
westock-data suspension                 # 默认查询沪深A股
```

**返回字段**：
- `market`: 市场类型（hs=沪深A股, hk=港股, us=美股）
- `stocks[]`: 停复牌股票列表
  - `code`: 股票代码
  - `name`: 股票名称
  - `status`: 状态（suspended=停牌中, resumed=已复牌, normal=正常）
  - `statusDesc`: 状态描述
  - `suspendDate`: 停牌日期（仅沪深A股）
  - `resumeDate`: 复牌日期（仅沪深A股）
  - `reason`: 停牌原因（仅沪深A股）

**使用场景**：
- 查看当前停牌中的股票
- 了解停牌原因和复牌日期
- 跟踪已复牌股票

---

## 股票代码格式

| 市场 | 格式 | 示例 |
|------|------|------|
| 沪市/科创板 | sh + 6位数字 | `sh600000`、`sh688981` |
| 深市 | sz + 6位数字 | `sz000001` |
| 北交所 | bj + 6位数字 | `bj430047` |
| 港股 | hk + 5位数字 | `hk00700` |
| 美股 | us + 代码 | `usAAPL` |

---

## 使用规范

- ✅ 使用 CLI 命令查询数据，命令输出 Markdown 表格，AI 直接从表格中读取数据进行分析
- ✅ 查询结果应转为表格或可读格式展示，禁止直接输出原始 JSON
- ✅ 批量查询返回 `BatchResult` 结构，需遍历 `data[]` 并检查 `errors[]`
- ❌ 不创建临时脚本文件，不将数据分析逻辑写成独立脚本
- ⚠️ **货币单位**：港股返回港元/美元，美股返回美元，展示时必须标注正确货币单位，禁止使用人民币符号

---

## 常见分析场景

```
查询最新价：search 牧原股份 → kline sz002714 day 1 → 取最新一条的 last（收盘价）
K线分析：search 牧原股份 → kline sz002714 day 20 → 提取 volume 计算统计
资金流向：asfund sh688981 → 解析 MainNetFlow/JumboNetFlow
技术指标：technical sh600000 macd,rsi → 判断金叉/死叉、超买/超卖
ETF分析：search 沪深300 → etf sh510300 → etf-holdings sh510300 → 查持仓明细
```

**完整分析场景参见 [references/scenarios-guide.md](./references/scenarios-guide.md)**

**数据格式、分析模板、示例对话参见 [references/ai_usage_guide.md](./references/ai_usage_guide.md)**

---

## 重要声明

> ⚠️ **重要声明**：
>
> 1. 本技能仅提供客观市场数据的查询与展示服务，所有返回数据均来源于公开市场信息，不含任何主观分析、投资评级或交易建议。
> 2. 本技能不构成证券投资咨询服务，使用本技能获取的数据不应作为投资决策的唯一依据。
> 3. 数据可能存在延迟，具体延迟时间因数据类型和市场而异，请以交易所官方数据为准。
> 4. 投资有风险，决策需谨慎。如需专业投资建议，请咨询持牌证券投资顾问机构。

**数据来源**：腾讯自选股数据接口

**数据更新频率**：

| 数据类型 | 更新频率 |
|----------|----------|
| K线数据 | 每日收盘后更新 |
| 财务数据 | 跟随财报季度发布更新 |
| 资金流向 | 每日收盘后更新 |

**适用对象**：金融数据研究人员、量化开发者、投资者教育平台等

---

## 附录：环境安装

**环境要求**：Node.js >= v18（脚本为单文件打包，无需 npm install）

> 本文件（SKILL.md）所在目录即为技能根目录，脚本路径为 `scripts/index.js`。

**运行方式**：
```bash
node <SKILL.md所在目录>/scripts/index.js search 茅台
```

如未安装 Node.js，根据系统自动安装：

```bash
# 检测
node --version 2>/dev/null || echo "未安装"

# macOS / Linux：通过 nvm 安装（无需 sudo）
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash \
  && export NVM_DIR="$HOME/.nvm" && \. "$NVM_DIR/nvm.sh" \
  && nvm install --lts && nvm use --lts
```

```powershell
# Windows PowerShell
if (-not (Get-Command node -EA SilentlyContinue)) { winget install OpenJS.NodeJS.LTS }
```
