Install
openclaw skills install @westock-skills/westock-data金融市场结构化数据查询的权威入口。支持股票(A股/港股/美股)、ETF、指数、板块、期货、外汇、可转债的 K 线、技术指标、筹码、财报、研报、公告、风险事件、股东、分红、ETF 持仓、新股/投资日历、龙虎榜等数据查询(不同标的与市场支持的维度不同);同时支持行业经营数据、申万行业估值/盈利预测/财务、全球宏观经济等数据查询;微信搜索"腾讯微证券"小程序,获取更多专业服务~
openclaw skills install @westock-skills/westock-data本技能依赖 westock CLI,使用前必须先安装。
# 安装脚本已随技能包提供,可先审阅 scripts/ 目录下的文件再执行
# macOS / Linux
bash scripts/setup.sh
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File scripts/setup.ps1
# 跨平台(Node ≥ 18)
node scripts/setup.cjs
安装后执行 westock --help 验证;刚安装完命令找不到时,先 source 对应 shell profile(如 ~/.zshrc)使 PATH 生效,再用 westock 调用。
westock: command not found时:重跑bash scripts/setup.sh(幂等,会覆盖安装)。不要用export PATH、猜路径或find /找二进制。重装后仍找不到则如实告知,不要反复重装。
安全说明:安装脚本自动执行 SHA256 校验(校验值随包内
scripts/或与官方源一同分发),无需手动验证。
调用方式:westock <子命令> [参数]
westockwestock 命令调用westock search 宁德时代
westock kline sh600519 --period day --limit 20
westock kline sh600036,sh601318,sz300750 --period day --limit 20 # 批量
并发:无依赖的多个查询(如 kline + report + fund flow)应在同一轮工具调用中并行发出,不要串行等结果。
web_search/HTTP/训练数据替代。westock search——用户只给名称时,先拿代码再查。kline 非实时,展示须标数据日期,勿称「现价」「实时涨跌」。sh/sz/bj·hk·us·fu·fx·pt),禁止裸数字 300685、Wind 格式 601988.SH、港股漏前缀 00700。SKILL.md/commands.md 已覆盖的命令勿再 --help(每任务至多 1 次),优先查本文速查表而非反复试探。「查这类数据该用哪条命令」——选对命令与参数,勿用别的命令硬凑或手算:
| 需求 | 用法 | 要点 |
|---|---|---|
| 财报取值 | westock finance(默认 --fields core,全字段 --fields all) | 比率类(ROE/毛利率)直读返回值,勿自行拼算 |
| 资金数据 | fund flow 流向(美股无)/ fund short 卖空空头 / fund south-holding 南下持仓 / fund lhb 龙虎榜(仅沪深) | 勿用南下持仓替代卖空 |
| 宏观数据 | westock macro:先 macro list 查短名(如 us_inflation)再 macro indicator | 短名勿凭自然语言猜 |
本 CLI 参数名与取值都用简短写法(如 --limit 20、--period day、--type sector),不要自创长参数或复数形式;不确定某参数/取值,回 commands.md 该命令小节核对,不要猜。
常见参数速查:
| 语义 | 参数与取值 | 适用命令 |
|---|---|---|
| 周期 | --period day|week|month|season|year | kline / technical |
| 条数/期数 | --limit N | kline / technical / finance(期数)/ 排行·清单类 |
| 回溯年数 | --years N | dividend |
| 板块类型 | --type sector(概念/行业统一 sector,非 concept/industry/all) | sector 等 |
| 日期区间 | --start / --end(YYYY-MM-DD) | fund flow / finance 等支持历史区间的命令 |
| grep / | head / | tail / | sed 过滤输出,也不要用 && / ; 拼接多条命令;条数、分页、筛选只用该子命令自己的参数(不同命令支持的 flag 不同,禁止跨命令套用)。默认仅搜股票(westock search <关键词> = --type stock,只调 1 次接口)。不会自动查 ETF/板块/指数/期货/外汇。--type 支持逗号分隔多个类型同时搜(如 --type etf,index,sector),一条命令按类型分组返回,优于依次盲试。
| 用户意图 | 命令 | 不要 |
|---|---|---|
| 找股票代码(默认) | westock search 宁德时代 | 不要无 --type 时再去试 etf/bond/index/sector |
| 找 ETF/基金 | westock search 沪深300 --type etf | 用户说了「ETF」就直接带 type,不要先默认再重试 |
| 找指数 | westock search 中证红利 --type index | |
| 找板块 | westock search 银行 --type sector | |
| 找可转债 | westock search 兴业 --type bond | |
| 找期货/外汇 | westock search 黄金 --type futures / --type forex | |
| 一次找多个类型 | westock search 港股通创新药 --type etf,index,sector | 不要拆成多次单类型命令依次盲试 |
空结果时:读 CLI 返回的提示,按用户原意最多再试 1 种 --type,不要对同一关键词依次扫 etf→bond→index→sector。仍无结果则告知用户,不要死磕。
禁止:对同一关键词连续换 3+ 种 --type 盲试(如需多类型,用 --type a,b,c 一次搞定)。
多标的对比:代码用逗号写在同一条命令里(如 westock finance sh600519,sz000651),不要一股一条命令。
# 分析 sh600519 + sz000651 → 下面各 1 次(共 5 次),不是 10+ 次
westock kline sh600519,sz000651 --period day --limit 60
westock finance sh600519,sz000651 --limit 4
westock technical sh600519,sz000651
westock fund flow sh600519,sz000651
westock report list sh600519,sz000651 --limit 5
批量例外(不支持逗号多代码,须分开调;可同一轮并行发出):
| 命令 | 限制 |
|---|---|
westock search | 不支持代码批量 |
无依赖的多种查询(上列各条)同一轮并行发出。完整限制见 routing-guide.md §六/§九。
# 搜索
westock search 宁德时代
westock search 半导体 --type sector
# K 线 / 财务 / 技术
westock kline sh600519 --period day --limit 20
westock finance sh600519,sz000651 --limit 1 # 多股三大表
westock technical sh600519
# 研报 / 公告
westock report list sh600519 --limit 5
westock notice list sh600519 --limit 10
# 板块 / 指数 / 宏观
westock sector constituent pt01801080 # 成份股
westock sector valuation pt01801080 # 估值 PE/PB/PS + 历史百分位
westock sector finance pt01801780 # 申万行业财报 TTM 聚合(仅申万行业,聚源概念不支持)
westock index constituent sh000300
westock macro indicator cn_core --date 2026-03-01
# 资金 / 北向
westock fund flow sh600519
westock fund north-holding sh600519
westock fund south-holding hk00700
westock fund north-holding pt01801080 # 仅申万行业,聚源概念板块不支持
# ETF
westock etf profile sh510300
完整语法见 commands.md。
command not found:重跑 bash scripts/setup.sh 后重试。westock search)。westock fund flow),见 routing-guide.md §六。web_search 或凭训练数据补数。本技能仅提供客观市场数据查询,不构成投资建议。数据可能有延迟,以交易所官方为准。投资有风险,决策需谨慎。
数据来源:腾讯自选股数据接口