stock-select

name	stock-select
description	智能选股技能，类似同花顺问财。使用自然语言查询符合条件的股票，如"涨停的股票"、"市盈率小于20"、"连续3天上涨"等。触发词：选股、问财、股票查询、动态选股、筛选股票、符合条件的股票。
author	[e-mail]
license	MIT
version	1.5.0

智能选股技能

基于自然语言的智能选股工具，类似同花顺问财。

外部依赖声明

本技能依赖以下外部 API 服务：

服务	地址	用途	认证
Stockboot API	https://stockboot.jiuma.cn/api	股票行情查询、动态选股	无需认证（公开接口）

隐私与数据安全

• 数据流向：仅向 Stockboot API 发送股票查询请求
• 数据类型：仅发送股票代码、选股条件等公开市场数据
• 无用户数据：不收集、不存储、不外发任何用户个人信息
• 传输安全：所有请求使用 HTTPS 加密传输

自托管选项

本技能的 API 服务可自行部署。如需自托管，请参考：

• 后端源码：私有仓库
• 部署后修改环境变量 STOCKBOOT_API_URL 指向您的服务地址

---

环境配置

默认 API 地址：https://stockboot.jiuma.cn/api

可通过环境变量自定义：

export STOCKBOOT_API_URL="https://your-server/api"

---

一、行情接口 (/quote)

1.1 获取单只股票行情

• 接口: GET ${STOCKBOOT_API_URL}/quote/{stockCode}
• 说明: 获取股票实时行情，包括五档买卖
• 示例:

  curl "${STOCKBOOT_API_URL}/quote/600519"
  

• 返回字段: code, stockName, currentPrice, changeRate, volume, amount, 五档买卖等

1.2 批量获取股票行情

• 接口: POST ${STOCKBOOT_API_URL}/quote/batch
• 说明: 批量获取多只股票实时行情（优化传输格式，字段分离）
• Body: ["600519", "000001", "300750"]
• 示例:

  curl -X POST "${STOCKBOOT_API_URL}/quote/batch" \
    -H "Content-Type: application/json" \
    -d '["600519", "000001", "300750"]'
  

• 返回字段: fields（字段名数组）, items（数据二维数组）

1.3 搜索股票

• 接口: POST ${STOCKBOOT_API_URL}/quote/search
• 说明: 根据股票代码、简称或名称搜索股票
• Body: {"keyword": "xxx"}
• 示例:

  curl -X POST "${STOCKBOOT_API_URL}/quote/search" \
    -H "Content-Type: application/json" \
    -d '{"keyword": "茅台"}'
  

1.4 获取分时数据

• 接口: GET ${STOCKBOOT_API_URL}/quote/minute/{stockCode}?tradeDate=xxx
• 说明: 获取股票分时行情数据，不指定日期则获取当天
• 示例:

  curl "${STOCKBOOT_API_URL}/quote/minute/600519"
  

1.5 获取分时数据（优化传输）

• 接口: GET ${STOCKBOOT_API_URL}/quote/minute/{stockCode}/optimized?tradeDate=xxx
• 说明: 获取分时数据，字段名和数据分离，减少网络传输量

1.6 获取集合竞价数据

• 接口: GET ${STOCKBOOT_API_URL}/quote/call-auction/{stockCode}?tradeDate=xxx
• 说明: 获取早盘集合竞价数据（9:15-9:25）

1.7 获取集合竞价数据（优化传输）

• 接口: GET ${STOCKBOOT_API_URL}/quote/call-auction/{stockCode}/optimized?tradeDate=xxx
• 说明: 获取集合竞价数据，字段名和数据分离，减少网络传输量

1.8 获取股票基础数据

• 接口: GET ${STOCKBOOT_API_URL}/quote/basic-data/{stockCode}
• 说明: 获取融资融券、次新、市盈率、市净率、板块、概念等基础数据
• 示例:

  curl "${STOCKBOOT_API_URL}/quote/basic-data/600519"
  

1.9 获取历史K线数据

• 接口: GET ${STOCKBOOT_API_URL}/quote/kline/{stockCode}?interval=D&startDate=xxx&endDate=xxx&appendToday=false
• 参数:
  • interval: K线周期 (D=日, W=周, M=月, Q=季, Y=年)
  • startDate: 开始日期
  • endDate: 结束日期
  • appendToday: 是否包含今天
• 示例:

  curl "${STOCKBOOT_API_URL}/quote/kline/600519?interval=D&appendToday=true"
  

1.10 获取历史K线数据（优化传输）

• 接口: GET ${STOCKBOOT_API_URL}/quote/kline/{stockCode}/optimized?interval=D&startDate=xxx&endDate=xxx&appendToday=false
• 说明: 获取历史K线数据，字段名和数据分离，减少网络传输量

---

二、动态选股接口 (/dynamic-select)

• 接口地址: POST ${STOCKBOOT_API_URL}/dynamic-select/execute
• 说明: 使用 POST 方法 + HTTPS 加密传输
• Body: {"sentence": "选股条件"}
• 示例:

  curl -X POST "${STOCKBOOT_API_URL}/dynamic-select/execute" \
    -H "Content-Type: application/json" \
    -d '{"sentence": "涨停"}'
  

---

三、动态选股使用方式

当用户提出选股需求时，将用户的自然语言转换为查询条件，调用 API 并返回结果。

查询语法示例

从日志中已知支持的查询模式：

1. 涨跌停类:

   • 涨停 - 今日涨停的股票
   • 跌停 - 今日跌停的股票
   • 涨幅大于8%未涨停非ST - 涨幅大但未涨停
   • 非一字涨停非ST - 非一字板涨停

2. 涨幅类:

   • 涨幅大于5%
   • 涨幅小于-3%
   • 连续3天上涨
   • 前5日平均涨幅大于20%

3. 财务指标:

   • 市盈率小于20
   • 市净率小于2
   • 流通市值小于50亿

4. 组合条件 (用分号分隔):

   • 涨幅大于5%;非ST
   • 前5日平均涨幅大于20%;前10日涨停次数大于1
   • 连续5日净买入且主力净流入占比大于10%非ST

5. 排除条件:

   • 非ST - 排除ST股票
   • 非新股 - 排除新股

执行流程

1. 解析用户的选股意图
2. 构建查询条件字符串
3. 调用 API（HTTPS + POST）:

   curl -X POST "${STOCKBOOT_API_URL}/dynamic-select/execute" \
     -H "Content-Type: application/json" \
     -d '{"sentence": "涨停"}'
   

4. 格式化返回结果

返回格式

API 返回 JSON，包含：

• sentence: 查询条件
• stocks: 股票列表（code, name, marketType）
• totalCount: 符合条件的股票数量
• costTime: 查询耗时(ms)

示例对话

用户: 帮我找今天涨停的股票 助手: 调用接口查询"涨停"，返回涨停股票列表

用户: 有没有市盈率低的小盘股？ 助手: 调用接口查询"市盈率小于20;流通市值小于50亿"

用户: 最近3天连续上涨的非ST股票 助手: 调用接口查询"连续3天上涨非ST"