westockdata

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

WeStock Data

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

---

安全说明（重要）

⚠️ 在使用前请知悉以下事项：

1. 包来源：westock-data-clawhub@1.0.4 发布于npm官方镜像（registry.npmjs.org），maintainer 为 腾讯自选股团队成员。
2. 完整性校验：包的 sha512 integrity 为 sha512-Cr4IS69wJ6aFdaDv7Sh/Zwf1FEj+8BHxegIltjWg4bswjV2SfbG9VmM0YN4SwfaLJlP1INzM0Ed3LXP+3WpjSA==，shasum 为 b434e6ca4b434455201f1d8af56da435f518b678。
3. 执行方式：npx -y 会自动下载并执行该包，属于中等供应链风险。在敏感/生产环境使用前，建议向 IT 安全团队确认。

快速开始

# 搜索股票
npx -y westock-data-clawhub@1.0.4 search 腾讯控股

# 查询K线
npx -y westock-data-clawhub@1.0.4 kline sh600000 --period day --limit 20

---

已知限制速查

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

---

批量查询

所有查询类命令均支持逗号分隔多股代码。

npx -y westock-data-clawhub@1.0.4 kline sh600000 --period day --limit 20          # 单股
npx -y westock-data-clawhub@1.0.4 kline sh600000,sh600519 --period day --limit 20 # 批量

search 和 minute 不支持批量查询。详细返回格式见 references/ai_usage_guide.md

---

核心命令

1. 股票搜索

npx -y westock-data-clawhub@1.0.4 search 腾讯控股          # 搜索股票（默认）
npx -y westock-data-clawhub@1.0.4 search 银行 --sector    # 搜索板块

2. K线

支持个股、指数、板块、ETF

npx -y westock-data-clawhub@1.0.4 kline sh600000 --period day --limit 20
npx -y westock-data-clawhub@1.0.4 kline hk00700 --period week --limit 10
npx -y westock-data-clawhub@1.0.4 kline sz000001 --period day --limit 60 --fq qfq          # 前复权
npx -y westock-data-clawhub@1.0.4 kline sh600000,sh600519 --period day --limit 20     # 批量
npx -y westock-data-clawhub@1.0.4 kline sh000001 --period day --limit 20               # 指数K线
npx -y westock-data-clawhub@1.0.4 kline pt01801081 --period day --limit 20             # 板块K线

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

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

3. 分时

支持个股、指数、板块

npx -y westock-data-clawhub@1.0.4 minute sh600000        # 1日分时
npx -y westock-data-clawhub@1.0.4 minute sh600000 --days 5      # 5日分时
npx -y westock-data-clawhub@1.0.4 minute sh000001        # 指数分时
npx -y westock-data-clawhub@1.0.4 minute pt01801081      # 板块分时

4. 财务报表

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

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

# 港股：zhsy(综合损益表) / zcfz / xjll
npx -y westock-data-clawhub@1.0.4 finance hk00700 --num 4

# 美股：income / balance / cashflow
npx -y westock-data-clawhub@1.0.4 finance usBABA --type income --num 4

⚠️ 货币单位：港股返回港元/美元，美股返回美元，展示时必须标注正确货币单位

5. 公司简况

npx -y westock-data-clawhub@1.0.4 profile sh600000
npx -y westock-data-clawhub@1.0.4 profile sh600000,hk00700,usAAPL

6. 资金与交易分析

# 港股资金
npx -y westock-data-clawhub@1.0.4 hkfund hk00700
npx -y westock-data-clawhub@1.0.4 hkfund hk00700,hk01810 --date 2026-03-10

# A股资金
npx -y westock-data-clawhub@1.0.4 asfund sh600000
npx -y westock-data-clawhub@1.0.4 asfund sh600000,sz000001 --date 2026-03-10

# 美股卖空
npx -y westock-data-clawhub@1.0.4 usfund usAAPL
npx -y westock-data-clawhub@1.0.4 usfund usAAPL,usTSLA --date 2026-03-10

# 龙虎榜（仅沪深）
npx -y westock-data-clawhub@1.0.4 lhb sz000001
npx -y westock-data-clawhub@1.0.4 lhb sz000001 --date 2026-03-20

# 大宗交易（仅沪深）
npx -y westock-data-clawhub@1.0.4 blocktrade sz000001

# 融资融券（仅沪深）
npx -y westock-data-clawhub@1.0.4 margintrade sz000001

7. 技术指标

npx -y westock-data-clawhub@1.0.4 technical sh600000                              # 全部指标（最新）
npx -y westock-data-clawhub@1.0.4 technical sh600000 --group macd                         # 特定分组
npx -y westock-data-clawhub@1.0.4 technical sh600000 --group ma,rsi                       # 多分组
npx -y westock-data-clawhub@1.0.4 technical sh600000,hk00700 --group all                  # 批量
npx -y westock-data-clawhub@1.0.4 technical sh600000 --group macd --start 2026-02-01 --end 2026-03-01   # 历史区间

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

8. 筹码成本

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

npx -y westock-data-clawhub@1.0.4 chip sh600519
npx -y westock-data-clawhub@1.0.4 chip sh600519 --start 2026-02-01 --end 2026-03-01   # 历史区间

9. 股东结构

⚠️ 仅支持A股和港股

npx -y westock-data-clawhub@1.0.4 shareholder sh600519     # A股：十大股东、十大流通股东、股东户数
npx -y westock-data-clawhub@1.0.4 shareholder hk00700      # 港股：持股股东+机构持仓

10. 分红数据

npx -y westock-data-clawhub@1.0.4 dividend sh600519                              # 最近分红
npx -y westock-data-clawhub@1.0.4 dividend sh600519 --years 5                    # 近5年分红
npx -y westock-data-clawhub@1.0.4 dividend sh600519 --all                        # 含未实施分红方案
npx -y westock-data-clawhub@1.0.4 dividend sh600519,hk00700,usAAPL               # 批量
npx -y westock-data-clawhub@1.0.4 dividend hk00700 --years 10                    # 近10年分红

11. ETF 基金数据

npx -y westock-data-clawhub@1.0.4 etf sh510300                  # ETF 详情
npx -y westock-data-clawhub@1.0.4 etf-holdings sh510300         # ETF 持仓明细
npx -y westock-data-clawhub@1.0.4 etf-nav sh510300 --start 2026-01-01 --end 2026-03-31   # ETF 净值历史
npx -y westock-data-clawhub@1.0.4 etf-company sh510300          # ETF 公司信息
npx -y westock-data-clawhub@1.0.4 etf-holders sh510300          # ETF 持有人结构
npx -y westock-data-clawhub@1.0.4 etf-financial sh510300        # ETF 财务指标

---

平台特色数据

npx -y westock-data-clawhub@1.0.4 hot stock                  # 热搜股票
npx -y westock-data-clawhub@1.0.4 hot board --limit 10              # 热门板块
npx -y westock-data-clawhub@1.0.4 hot etf                    # 热搜ETF

npx -y westock-data-clawhub@1.0.4 board                      # 热门板块首页

# 投资日历（--limit/--country:1中国2美国3港股/--indicator:1经济2央行3事件4休市）
npx -y westock-data-clawhub@1.0.4 calendar
npx -y westock-data-clawhub@1.0.4 calendar 2026-03-10 --limit 30 --country 1 --indicator 1

npx -y westock-data-clawhub@1.0.4 ipo hs                     # 沪深新股
npx -y westock-data-clawhub@1.0.4 ipo hk                     # 港股新股

npx -y westock-data-clawhub@1.0.4 exdiv sh600519             # 分红除权日历
npx -y westock-data-clawhub@1.0.4 reserve sh600519           # 业绩预告
npx -y westock-data-clawhub@1.0.4 suspension hs              # 停复牌信息

---

命令速查表

命令	用途	批量
search	搜索股票/基金/板块	❌
quote	实时行情	✅
kline	K线数据	✅
minute	分时数据	❌
finance	财务报表	✅
profile	公司简况	✅
asfund	A股资金流向	✅
hkfund	港股资金流向	✅
usfund	美股卖空数据	✅
lhb	龙虎榜	✅
blocktrade	大宗交易	✅
margintrade	融资融券	✅
technical	技术指标	✅
chip	筹码成本	✅
shareholder	股东结构	✅
dividend	分红数据	✅
etf	ETF详情	✅
etf-holdings	ETF持仓明细	✅
etf-nav	ETF净值历史	✅
hot	热搜/热门板块	❌
board	板块行情	❌
calendar	投资日历	❌
ipo	新股日历	❌
exdiv	分红除权日历	✅
reserve	业绩预告	✅
suspension	停复牌信息	❌

---

股票代码格式

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

---

使用规范

• ✅ 使用 CLI 命令查询数据，命令输出 Markdown 表格，AI 直接从表格中读取数据
• ✅ 查询结果应转为表格或可读格式展示，禁止直接输出原始 JSON
• ❌ 不创建临时脚本文件，不将数据分析逻辑写成独立脚本
• ⚠️ 货币单位：港股返回港元/美元，美股返回美元，禁止使用人民币符号

---

常见分析场景

# K线分析：提取 volume 计算统计
npx -y westock-data-clawhub@1.0.4 kline sz002714 --period day --limit 20

# 资金流向：解析 MainNetFlow/JumboNetFlow
npx -y westock-data-clawhub@1.0.4 asfund sh688981

# 技术指标：判断金叉/死叉、超买/超卖
npx -y westock-data-clawhub@1.0.4 technical sh600000 --group macd,rsi

# ETF分析：查持仓明细
npx -y westock-data-clawhub@1.0.4 etf sh510300
npx -y westock-data-clawhub@1.0.4 etf-holdings sh510300

完整分析场景参见 references/scenarios-guide.md

详细返回格式、字段说明、分析模板参见 references/ai_usage_guide.md

---

重要声明

⚠️ 重要声明：

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

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

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

---

附录：环境安装

环境要求：Node.js >= v18