WeStock Data
数据源:腾讯自选股行情数据接口 | 支持市场:A股(沪深/科创/北交所)、港股、美股
安全说明(重要)
⚠️ 在使用前请知悉以下事项:
- 包来源:
westock-data-clawhub@1.0.4发布于npm官方镜像(registry.npmjs.org),maintainer 为腾讯自选股团队成员。- 完整性校验:包的 sha512 integrity 为
sha512-Cr4IS69wJ6aFdaDv7Sh/Zwf1FEj+8BHxegIltjWg4bswjV2SfbG9VmM0YN4SwfaLJlP1INzM0Ed3LXP+3WpjSA==,shasum 为b434e6ca4b434455201f1d8af56da435f518b678。- 执行方式:
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
重要声明
⚠️ 重要声明:
- 本技能仅提供客观市场数据的查询与展示服务,所有返回数据均来源于公开市场信息,不含任何主观分析、投资评级或交易建议。
- 本技能不构成证券投资咨询服务,使用本技能获取的数据不应作为投资决策的唯一依据。
- 数据可能存在延迟,请以交易所官方数据为准。
- 投资有风险,决策需谨慎。如需专业投资建议,请咨询持牌证券投资顾问机构。
数据来源:腾讯自选股数据接口
适用对象:金融数据研究人员、量化开发者、投资者教育平台等
附录:环境安装
环境要求:Node.js >= v18