SkillHub

stock-select

v1.5.1

智能选股技能，类似同花顺问财。使用自然语言查询符合条件的股票，如"涨停的股票"、"市盈率小于20"、"连续3天上涨"等。触发词：选股、问财、股票查询、动态选股、筛选股票、符合条件的股票。

Sourced from ClawHub, Authored by Hailong Wang

Installation

Please help me install the skill `stock-select` from SkillHub official store. npx skills add wanghl-cn/stock-select

智能选股技能

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

外部依赖声明

本技能依赖以下外部 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}
  • 说明: 获取股票实时行情，包括五档买卖
  • 示例: bash curl "${STOCKBOOT_API_URL}/quote/600519"
  • 返回字段: code, stockName, currentPrice, changeRate, volume, amount, 五档买卖等

1.2 批量获取股票行情

  • 接口: POST ${STOCKBOOT_API_URL}/quote/batch
  • 说明: 批量获取多只股票实时行情（优化传输格式，字段分离）
  • Body: ["600519", "000001", "300750"]
  • 示例: bash 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"}
  • 示例: bash 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
  • 说明: 获取股票分时行情数据，不指定日期则获取当天
  • 示例: bash 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}
  • 说明: 获取融资融券、次新、市盈率、市净率、板块、概念等基础数据
  • 示例: bash 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: 是否包含今天
  • 示例: bash 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": "选股条件"}
  • 示例: bash curl -X POST "${STOCKBOOT_API_URL}/dynamic-select/execute" -H "Content-Type: application/json" -d '{"sentence": "涨停"}'

三、动态选股使用方式

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

查询语法示例

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

  1. 涨跌停类:
  2. 涨停 - 今日涨停的股票
  3. 跌停 - 今日跌停的股票
  4. 涨幅大于8%未涨停非ST - 涨幅大但未涨停

  5. 非一字涨停非ST - 非一字板涨停

  6. 涨幅类:

  7. 涨幅大于5%
  8. 涨幅小于-3%
  9. 连续3天上涨

  10. 前5日平均涨幅大于20%

  11. 财务指标:

  12. 市盈率小于20
  13. 市净率小于2

  14. 流通市值小于50亿

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

  16. 涨幅大于5%;非ST
  17. 前5日平均涨幅大于20%;前10日涨停次数大于1

  18. 连续5日净买入且主力净流入占比大于10%非ST

  19. 排除条件:

  20. 非ST - 排除ST股票
  21. 非新股 - 排除新股

执行流程

  1. 解析用户的选股意图
  2. 构建查询条件字符串
  3. 调用 API（HTTPS + POST）: bash 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"