westockdata

# 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 安全团队确认。 ## 快速开始 ```bash # 搜索股票 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` | 不支持批量查询 | --- ## 批量查询 **所有查询类命令均支持逗号分隔多股代码**。 ```bash 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](./references/ai_usage_guide.md) --- ## 核心命令 ### 1. 股票搜索 ```bash npx -y westock-data-clawhub@1.0.4 search 腾讯控股 # 搜索股票（默认） npx -y westock-data-clawhub@1.0.4 search 银行 --sector # 搜索板块 ``` ### 2. K线 > 支持个股、指数、板块、ETF ```bash 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. 分时 > 支持个股、指数、板块 ```bash 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期，数字参数指定多期 ```bash # 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. 公司简况 ```bash npx -y westock-data-clawhub@1.0.4 profile sh600000 npx -y westock-data-clawhub@1.0.4 profile sh600000,hk00700,usAAPL ``` ### 6. 资金与交易分析 ```bash # 港股资金 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. 技术指标 ```bash 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） ```bash 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股和港股 ```bash npx -y westock-data-clawhub@1.0.4 shareholder sh600519 # A股：十大股东、十大流通股东、股东户数 npx -y westock-data-clawhub@1.0.4 shareholder hk00700 # 港股：持股股东+机构持仓 ``` ### 10. 分红数据 ```bash 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 基金数据 ```bash 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 财务指标 ``` --- ## 平台特色数据 ```bash 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 - ❌ 不创建临时脚本文件，不将数据分析逻辑写成独立脚本 - ⚠️ **货币单位**：港股返回港元/美元，美股返回美元，禁止使用人民币符号 --- ## 常见分析场景 ```bash # 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/scenarios-guide.md)** **详细返回格式、字段说明、分析模板参见 [references/ai_usage_guide.md](./references/ai_usage_guide.md)** --- ## 重要声明 > ⚠️ **重要声明**： > > 1. 本技能仅提供客观市场数据的查询与展示服务，所有返回数据均来源于公开市场信息，不含任何主观分析、投资评级或交易建议。 > 2. 本技能不构成证券投资咨询服务，使用本技能获取的数据不应作为投资决策的唯一依据。 > 3. 数据可能存在延迟，请以交易所官方数据为准。 > 4. 投资有风险，决策需谨慎。如需专业投资建议，请咨询持牌证券投资顾问机构。 **数据来源**：腾讯自选股数据接口 **适用对象**：金融数据研究人员、量化开发者、投资者教育平台等 --- ## 附录：环境安装 **环境要求**：Node.js >= v18