Westock Tool

WeStock Tool

作用：提供三种选股方式——条件选股（自定义表达式筛选）、策略选股（40+预置策略一键获取信号股票）和标签选股（70+预定义分类标签快速获取股票列表）。

工具分工说明：

• westock-tool（本工具）：筛选/选股 — "找出满足条件的股票列表"、"用MACD金叉策略选股"、"央企有哪些"、"破净股有哪些"、"新股有哪些"、"次新股有哪些"
• westock-data：查询个股详情 — "查某只股票的行情/K线/财务/资金等数据"、"查新股日历（ipo）"、"查板块/概念成份股"（如"华为概念股"、"AI概念股"→ 用 westock-data sector --search 查询，不属于选股）
• westock-portfolio：用户自选股查询 — "查看我的自选股列表"（当用户说"我的自选股"、"自选股有哪些"时使用）

⚠️ 命令路由原则：

• strategy 命令：当用户提到策略名称（如"MACD金叉策略"、"早晨之星"）时使用，返回该策略信号股票列表
• filter --preset 命令：当用户需要预设条件快速筛选（如"低PE股"、"高股息股"、"MACD金叉信号"）时使用，属于 filter 的快捷方式
• label 命令：当用户提到分类标签（如"央企"、"国企"、"ST股"、"新股"、"次新股"）时使用
• filter 表达式：当用户描述自定义条件（如"PE<20且ROE>15"）时使用
• ❌ 概念股查询不属于本工具：当用户问"XX概念有哪些股票"（如"华为概念股"、"AI概念股"），请用 westock-data sector --search <关键词> 查询

数据源：腾讯自选股选股数据接口 | 条件选股：A股、港股、美股 | 策略选股：仅A股 | 标签选股：仅A股

已知限制速查

⚠️ 常见错误

条件选股（filter）

# 基本用法
westock-tool filter "ClosePrice >= 100"
westock-tool filter "ClosePrice >= 100" --date 2026-03-12
westock-tool filter "ClosePrice >= 100" --date 2026-03-12 --limit 20

# AND 组合条件
westock-tool filter "intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])"

# OR 组合条件
westock-tool filter "union([ChangePCT > 5, Chg5D > 10])"

# 指定排序（按 ROE 降序）
westock-tool filter "intersect([PE_TTM > 0, PE_TTM < 15, ROETTM > 15])" --date 2026-03-12 --limit 20 --orderby ROETTM:desc

# 港股选股（--market hk）
westock-tool filter "intersect([PeTTM > 0, PeTTM < 10, DivTTM > 5])" --market hk

# 美股选股（--market us）
westock-tool filter "intersect([PeTTM > 0, PeTTM < 30, TotalMV > 1000])" --market us

# 按板块筛选（--universe，板块代码通过 westock-data search <关键词> --sector 获取）
westock-tool filter "intersect([PE_TTM > 0, PE_TTM < 20])" --date 2026-03-12 --limit 20 --universe 11010001

# 输出原始 JSON
westock-tool filter "ClosePrice >= 100" --raw

参数说明：

返回格式：

输出 Markdown 表格，每行一只股票，列含股票代码、名称、收盘价、涨跌幅及表达式涉及的指标字段：

共 156 只符合条件，当前显示 20 只

| code | name | ClosePrice | ChangePCT | PE_TTM | ROETTM |
|------|------|------------|-----------|--------|--------|
| sh600519 | 贵州茅台 | 1690.00 | 1.25 | 28.50 | 32.15 |
| sz000001 | 平安银行 | 12.50 | -0.32 | 5.80 | 16.20 |

预设选股函数

⚠️ filter --preset 与 strategy 的区别：

• filter --preset 是 filter 命令的快捷方式，用预设条件表达式筛选，输出含指标列的 Markdown 表格
• strategy 是独立的策略选股命令，从预置策略列表中获取信号股票，输出仅含 code/name 的表格
• 两者语义等价但命令路径不同：如 MACD 金叉，用 filter --preset MACDGoldenCross 或 strategy macd_golden 均可，但不可混用参数格式

# 使用预设函数（--preset）
westock-tool filter --preset MACDGoldenCross --date 2026-03-24 --limit 30
westock-tool filter --preset LowPE --date 2026-03-12 --limit 20
westock-tool filter --preset HighDividend --date 2026-03-12 --limit 20 --market hk

# 查看所有可用预设函数名称列表
westock-tool filter --list-presets

参数说明：同 filter 命令，额外增加 --preset <函数名> 指定预设函数。

⚠️ 预设函数的参数均为内置默认值，不支持通过 CLI 传入自定义参数。如需自定义条件，请使用 filter 表达式语法。

完整预设函数列表（含默认参数）参见 references/ai_usage_guide.md

表达式语法

⚠️ 重要：多条件 AND 组合必须使用 intersect([...])，不支持 &、&&、AND 等符号或关键字。

策略选股（strategy）

# 查看所有可用策略
westock-tool strategy --list

# 单个策略查询（默认今天）
westock-tool strategy macd_golden
westock-tool strategy macd_golden --date 2026-04-10

# 多个策略同时查询（按 code 分别返回结果）
westock-tool strategy high_dividend,pb_roe --date 2026-04-10

# 限制返回数量
westock-tool strategy high_dividend --date 2026-04-10 --limit 10

# 分页查询（从第 20 条开始取 10 条）
westock-tool strategy morning_star --limit 10 --offset 20

# 日期区间查询（仅支持单个策略，⚠️ 查多天趋势时必须用 --start/--end，不要用 --date 多次调用）
westock-tool strategy macd_golden --start 2026-04-01 --end 2026-04-10

参数说明：

自定义 code：除了内置短名，也支持直接传入任意 listcode 字符串。新增的策略 code 即使不在内置列表中也可直接使用，无需更新工具代码。可通过 --list 获取最新可用策略列表。

返回格式：

策略: MACD金叉 (macd_golden) | 日期: 2026-04-10 | 共 35 只，显示 20 只

| code | name |
|------|------|
| sh600519 | 贵州茅台 |
| sz000001 | 平安银行 |

通过 westock-tool strategy --list 获取完整策略列表。

完整策略列表参见 references/ai_usage_guide.md

标签选股（label）

⚠️ 何时使用 label：当用户问"央企有哪些"、"ST股有哪些"、"新股有哪些"、"次新股"等分类标签问题时，使用 label 命令

通过预定义标签分类快速获取符合条件的股票列表，无需手写表达式。

# 查看所有可用标签
westock-tool label --list

# 按分组查看标签
westock-tool label --list 股东属性
westock-tool label --list 风险标签

# 单个标签查询（默认今天）
westock-tool label shareholder_central_state
westock-tool label shareholder_central_state --date 2026-04-10

# 多个标签同时查询（按 code 分别返回结果，非取交集）
westock-tool label shareholder_central_state,shareholder_local_state --date 2026-04-10

# 限制返回数量
westock-tool label risk_st --date 2026-04-10 --limit 50

# 分页查询（从第 20 条开始取 10 条）
westock-tool label marketcap_up10000 --limit 10 --offset 20

# 日期区间查询（仅支持单个标签，⚠️ 查多天趋势时必须用 --start/--end，不要用 --date 多次调用）
westock-tool label shareholder_central_state --start 2026-04-01 --end 2026-04-10

参数说明：

多标签查询：传入多个标签时，每个标签分别返回各自的股票列表，不做交集。如需交集，可在获取结果后自行比对。

自定义 code：除了内置短名，也支持直接传入任意 listcode 字符串。新增的标签 code 即使不在内置列表中也可直接使用，无需更新工具代码。可通过 --list 获取最新可用标签列表。

返回格式：

标签: 央企公司 (shareholder_central_state) | 日期: 2026-04-10 | 共 128 只，显示 20 只

| code | name |
|------|------|
| sh601398 | 工商银行 |
| sh601857 | 中国石油 |

通过 westock-tool label --list 获取完整标签列表，--list <分组名> 可按分组筛选。

完整标签列表参见 references/ai_usage_guide.md

使用规范

• ✅ 使用 westock-tool CLI 命令执行选股查询，命令输出 Markdown 表格，AI 直接从表格读取数据
• ✅ 查询结果应转为表格或可读格式展示，禁止直接输出原始 JSON
• ❌ 不创建临时脚本文件，不将数据分析逻辑写成独立脚本
• ⚠️ 港股必须指定 --market hk，美股必须指定 --market us
• ⚠️ 筛选 PE/PB 时排除负值（亏损股），如 intersect([PE_TTM > 0, PE_TTM < 20])
• ⚠️ 沪深和港股/美股的估值字段名不同，切勿混用
• ⚠️ 市值单位：沪深 TotalMV 单位为"元"，港股/美股为"亿元"，构建条件时注意换算

股票代码格式

常用字段速查

⚠️ 沪深 TotalMV 单位为"元"，港股/美股为"亿元"

⚠️ 港股 PsTTM/PcfTTM 仅选股查询支持，快照查询返回 0

完整字段速查表（含行情、财务、技术指标等全部字段）参见 references/fields-guide.md

详细返回格式、分析模板参见 references/ai_usage_guide_pounding.md

常见场景速查

【命令选择】
- 策略名称（MACD金叉、早晨之星等）→ strategy
- 分类标签（央企、ST股、新股等）→ label
- 自定义条件（PE<20且ROE>15）→ filter 表达式
- 预设函数（低估值、高股息等）→ filter --preset

【典型示例】
strategy macd_golden                         # MACD金叉策略
strategy morning_star                        # 早晨之星形态
label shareholder_central_state              # 央企股票
label risk_st                                # ST股
label listeddate_5days                       # 新股（5日内）
filter "intersect([PE_TTM > 0, PE_TTM < 15, ROETTM > 15])" --orderby ROETTM:desc  # 低估值蓝筹
filter "intersect([PB > 0, PB < 1])"         # 破净股
filter --preset HighDividend --market hk     # 港股高股息

更多场景示例参见 references/scenarios-guide.md

重要声明

⚠️ 重要声明：

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

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

数据更新频率：

附录：环境安装

环境要求：Node.js >= v18