stock_screener
Read-onlyIdempotent
MCP 主条件选股工具:支持概念/题材、行业、地区、股票名称包含、价格、市值、收盘涨跌幅、盘中最高/最低涨幅、开盘涨幅、换手、成交额、PE/PB、均线位置、放量倍数、市场板块和 ST/上市状态过滤。用户用问财式自然语言提条件时,agent 应直接映射为本工具结构化参数再调用。 何时使用: MCP 主条件选股工具。conceptKeywords/conceptCodes 默认开盘啦题材库(conceptSource=kpl);未命中可设 conceptSource=auto 回退东财/CLS。用户用问财式自然语言提条件时,agent 应先把语义直接映射到本工具 schema 参数再调用,例如"半导体板块、五日线之上、放量三倍、上海、名字带龙"→conceptKeywords/aboveMa/volumeRatioMin/areaKeywords/nameIncludes;"收盘涨幅超过7"→closePctChgMin:7;"盘中最高涨幅超过7/最高到过7以上"→highPctChgMin:7。不要在 agent 侧分批拼 concept_stocks+kline+valuation_snapshot。 【链接】rows/items/嵌套股票对象含 code/name;列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | 筛选交易日,支持 YYYY-MM-DD 或 YYYYMMDD。不传默认取最新已落库交易日;非交易日会使用此前最近有数据的交易日并返回时效提示。 | |
| codes | No | 股票代码票池,数组或逗号分隔字符串。传入后只在该票池内做条件筛选。常见用法:先用 limit_up_ladder/broken_limit_up 拿到事件池,再传给本工具做二次筛选。支持6位代码或带后缀格式。 | |
| limit | No | 返回数量,默认 50,最大 300。 | |
| pbMax | No | PB 上限。 | |
| pbMin | No | PB 下限。 | |
| format | No | content[0].text:默认1行 headline;markdown=完整 markdown 表格;json=完整 JSON。 | |
| maMode | No | 多条均线匹配方式:all=全部满足(默认);any=任一满足。 | all |
| market | No | 市场范围,默认 all。支持 all/main/sh/sz/gem/cyb/star/kcb/bse/bj。 | all |
| sortBy | No | 排序字段,默认 volumeRatio。常用:volumeRatio、closePctChg、highPctChg、lowPctChg、openPctChg、close、amountYi、turnoverRate、totalMarketCapYi、circMarketCapYi、marketCapYi、peTtm、pb。 | volumeRatio |
| aboveMa | No | 要求收盘价站上指定均线,支持 5/10/20/30/60/90/250。用户说"五日线之上/站上5日线/突破20日均线"时填 [5] 或 [20];"5日和10日线之上"填 [5,10]。 | |
| belowMa | No | 要求收盘价低于指定均线,支持 5/10/20/30/60/90/250。 | |
| peTtmMax | No | PE(TTM) 上限。 | |
| peTtmMin | No | PE(TTM) 下限。 | |
| priceMax | No | 收盘价上限(元)。用户说"价格10到20/股价低于20元"时填 20。 | |
| priceMin | No | 收盘价下限(元)。用户说"价格10到20/股价10元以上"时填 10。 | |
| excludeST | No | 是否剔除 ST/退市风险名称,默认 true。 | |
| sortOrder | No | 排序方向,默认 desc。 | desc |
| listStatus | No | 上市状态,默认 L=上市;传 all 不限制。 | L |
| amountMaxYi | No | 成交额上限(亿元)。 | |
| amountMinYi | No | 成交额下限(亿元)。 | |
| conceptMode | No | 多概念匹配模式:any=命中任一概念(默认);all=同时属于所有概念。 | any |
| detailLevel | No | 档位:默认 standard(Agent 可计算标准字段);summary=压缩摘要;raw=全字段+原始数据。 | |
| areaKeywords | No | 公司地区关键词,来自 StockBasic.area。用户说"上海地区/上海公司/注册地上海/位于上海"时填 ["上海"]。 | |
| conceptCodes | No | 题材/概念代码;默认按开盘啦 kplId 或题材名匹配。 | |
| lowPctChgMax | No | 盘中最低涨幅上限(%)。用户说"盘中最低涨幅低于-3/最低跌到-3以下"时填这里。 | |
| lowPctChgMin | No | 盘中最低涨幅下限(%),口径为 (当日最低价 / 昨收价 - 1) * 100。 | |
| nameIncludes | No | 股票名称包含关键词。用户说"名字带龙/名称包含科技/简称含光"时填 ["龙"]、["科技"]、["光"]。 | |
| auctionChgMax | No | 竞价涨幅上限(%)。 | |
| auctionChgMin | No | 竞价涨幅下限(%)。用户说"竞价高开3个点以上"时填 3。 | |
| conceptSource | No | 概念成分口径,默认 kpl=开盘啦题材库;auto=开盘啦优先、未命中回退东财∪CLS;dongfang/cls/legacy 为兼容。 | kpl |
| highPctChgMax | No | 盘中最高涨幅上限(%)。 | |
| highPctChgMin | No | 盘中最高涨幅下限(%),口径为 (当日最高价 / 昨收价 - 1) * 100。用户说"盘中最高涨幅超过7/最高到过7以上/冲高超过7"时填这里。 | |
| marketCapType | No | 市值口径:total=总市值(默认);circ=流通市值。用户说"流通市值"时填 circ,否则"市值/总市值"填 total。 | total |
| openPctChgMax | No | 开盘涨幅上限(%)。用户说"低开2个点以上"时应换算为负数,例如 -2。 | |
| openPctChgMin | No | 开盘涨幅下限(%),口径为 (开盘价 / 昨收价 - 1) * 100。用户说"高开3个点以上/开盘涨幅超过5"时填这里。正数为高开,负数为低开。 | |
| textMatchMode | No | 名称/地区/行业多关键词匹配方式:any=任一命中(默认);all=全部命中。 | any |
| volumeAvgDays | No | 成交量均值基准天数,默认 5,最大 60。 | |
| closePctChgMax | No | 收盘涨跌幅上限(%)。用户说"收盘涨幅低于3/跌幅超过5"时应换算为负数,例如 -5。 | |
| closePctChgMin | No | 收盘涨跌幅下限(%),口径为当日收盘价相对昨收/前收的涨跌幅。用户说"收盘涨幅超过7/当日涨跌幅大于3"时填这里。 | |
| marketCapMaxYi | No | 市值上限(亿元)。用户说"市值200到300亿/市值不超过300亿"时填 300。 | |
| marketCapMinYi | No | 市值下限(亿元)。用户说"市值200到300亿/市值200亿以上"时填 200。 | |
| recentNdChgMax | No | 近N日累计涨幅上限(%)。用户说"近20日涨幅不超过15%"时填 15。 | |
| recentNdChgMin | No | 近N日累计涨幅下限(%)。用户说"近5日涨幅超过20%"时填 20。 | |
| volumeRatioMax | No | 放量倍数上限。 | |
| volumeRatioMin | No | 放量倍数下限。口径:最新交易日 vol / 前 volumeAvgDays 个交易日平均 vol,前 N 日不含当日。用户说"放量三倍/量比大于3/成交量是前五日均量3倍以上"时填 3。 | |
| conceptFallback | No | conceptSource=kpl 时若未命中是否回退东财∪CLS,默认 false。也可用 conceptSource=auto。 | |
| conceptKeywords | No | 开盘啦题材/板块关键词(默认 conceptSource=kpl),数组或逗号分隔字符串。用户说"半导体板块/机器人概念/低空经济题材"时直接填 ["半导体"]、["机器人"]、["低空经济"]。按开盘啦题材库名称模糊匹配。 | |
| recentNdChgDays | No | 近N日涨幅的天数窗口。用户说"近5日涨幅超过20%"时填 5。 | |
| turnoverRateMax | No | 换手率上限(%)。 | |
| turnoverRateMin | No | 换手率下限(%)。 | |
| auctionAmountMin | No | 竞价额下限(元)。用户说"竞价额大于5000万"时填 50000000。 | |
| industryKeywords | No | StockBasic.industry 行业关键词,数组或逗号分隔字符串。用户明确说"电子行业/软件行业"时填这里;说"半导体板块/机器人概念"优先填 conceptKeywords。 | |
| turnoverRateFMax | No | 实际换手率上限(%)。 | |
| turnoverRateFMin | No | 实际换手率下限(%),基于自由流通股本。短线里比普通换手率更贴近盘口。 | |
| limitUpCountNdMax | No | 近N日涨停次数上限。用户说"很少涨停/基本不涨停"时填 0 或 1。 | |
| limitUpCountNdMin | No | 近N日涨停次数下限。 | |
| freeMarketCapMaxYi | No | 自由流通市值上限(亿元)。 | |
| freeMarketCapMinYi | No | 自由流通市值下限(亿元)。短线实战中比流通市值更准确。 | |
| limitUpCountNdDays | No | 统计涨停次数的天数窗口。用户说"近10日涨停次数不超过1次"时填 10。 | |
| auctionVolumeRatioMin | No | 竞价量比下限。 | |
| auctionTurnoverRateMax | No | 竞价换手率上限。 | |
| auctionTurnoverRateMin | No | 竞价换手率下限(基于流通股本)。 | |
| auctionTurnoverRateFMax | No | 竞价实际换手率上限。 | |
| auctionTurnoverRateFMin | No | 竞价实际换手率下限(基于自由流通股本),单位%。用户说"竞价实际换手大于1%"时填 1。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| meta | No | ||
| success | No |