概述

国信智能选股 Skill

概述

此skill提供国信证券智能选股接口的调用能力，用于根据财务指标、技术指标、市值等条件筛选符合条件的股票。

环境要求

Python 3.13 及以上版本

skill使用引导

首次使用流程

检查API Key配置状态

首先读取 SECRET.md 文件中的 gs_api_key 字段

如果存在且不为空，直接使用该API Key进行查询

如果不存在或为空，引导用户获取API Key

引导用户获取API Key

当检测到没有有效的API Key时，向用户说明：

> 使用国信智能选股功能需要先配置API Key。请按以下步骤获取：

> 1. 访问 https://www.guosen.com.cn/gs/xxskills/key-index.html?softName=tx_skills 注册/登录账号

> 2. 登录后，点击网页一级标题栏的"登录"按钮，在弹窗上可一键复制API Key

> 3. 获取后请告诉我您的API Key，我来帮您配置

保存API Key

用户提供API Key后，智能体需要：

将API Key写入 SECRET.md 文件，字段名为 gs_api_key

确认写入成功后，继续执行用户的选股查询

如果写入失败，提示用户并询问是否重试

更新API Key

如果用户需要更换API Key，可以使用指令如"更新国信API Key"或"更换我的API Key"，智能体应：

引导用户提供新的API Key

更新 SECRET.md 中的 gs_api_key 字段

确认更新成功

API Key 存储格式

在 SECRET.md 文件中，API Key 应按以下格式存储：

gs_api_key: 用户的国信证券API Key

使用场景

当Agent需要回答以下类型的问题时，应使用此skill：

根据财务指标筛选股票（如市盈率、市净率、净利润等）
根据技术指标选股（如均线、MACD、KDJ等）
查找满足特定条件的股票组合
行业板块筛选
涨停板、跌停板股票查询
资金流向筛选

接口信息

基本信息

接口地址: /mcp/smart_stock_picking
请求方法: GET
完整URL: https://dgzt.guosen.com.cn/skills/agent/mcp/smart_stock_picking?searchstring={条件}&searchtype={类型}&apiKey={API密钥}&softName=tx_skills
认证方式: 通过请求参数apiKey进行身份验证

请求参数

参数名	类型	必填	说明
--------	------	------	------
searchstring	String	是	选股条件，例如："市盈率小于20的银行股"
searchtype	String	是	搜索类型，详见下表
apiKey	String	是	API密钥，用于身份验证，每次调用技能时由用户配置
softName	String	是	固定字符串，送tx_skills

searchtype 搜索类型

类型值	说明
--------	------
stock	股票
fund	基金
HK_stock	港股
US_stock	美股
NEEQ	新三板
index	指数

响应格式

成功响应：

{
  "result": [
        {
            "code": 0,
            "msg": "请求成功"
        }
    ],
  "data": {
    "tables": [
      // 返回的数据表格
    ]
  }
}

失败响应：

{
    "result": [
        {
        	"code": -1,
        	"msg": "查询失败:no data."
        }    
    ],
    "data": null
}

调用示例

HTTP请求示例

GET /mcp/smart_stock_picking?searchstring=市盈率小于20的银行股&searchtype=stock&softName=tx_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port

查询不同类型资产

# 查询股票
GET /mcp/smart_stock_picking?searchstring=市盈率小于20的银行股&searchtype=stock&softName=tx_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port

# 查询基金
GET /mcp/smart_stock_picking?searchstring=近一年收益超过20%的基金&searchtype=fund&softName=tx_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port

# 查询港股
GET /mcp/smart_stock_picking?searchstring=当前macd为金叉的价格最高的前十只股票&searchtype=HK_stock&softName=tx_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port

# 查询美股
GET /mcp/smart_stock_picking?searchstring=苹果相关股票&searchtype=US_stock&softName=tx_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port

# 查询指数
GET /mcp/smart_stock_picking?searchstring=上证指数&searchtype=index&softName=tx_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port

# 查新三板
GET /mcp/smart_stock_picking?searchstring=最近放量上涨的10家公司&searchtype=NEEQ&softName=tx_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port

响应示例

{
    "result":  [
        {
            "code": 0,
            "msg": "请求成功"
        }
    ],
    "data": [
        {
            "table": {
                "港股@macd金叉(条件说明)[20260319]": [
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉",
                    "2026年03月19日港股macd金叉"
                ],
                "港股@收盘价排名名次[20260319]": [
                    17,
                    20,
                    71,
                    86,
                    213,
                    257,
                    358,
                    361,
                    474,
                    517
                ],
                "港股@收盘价[20260319]": [
                    "287.600",
                    "217.600",
                    "88.000",
                    "76.050",
                    "33.340",
                    "25.820",
                    "15.610",
                    "15.480",
                    "9.670",
                    "8.330"
                ],
                "股票简称": [
                    "云知声",
                    "泡泡玛特",
                    "海致科技集团",
                    "讯飞医疗科技",
                    "瑞声科技",
                    "中信证券",
                    "中国财险",
                    "广发证券",
                    "极兔速递-W",
                    "九源基因"
                ],
                "港股@收盘价排名[20260319]": [
                    "17/2722",
                    "20/2722",
                    "71/2722",
                    "86/2722",
                    "213/2722",
                    "257/2722",
                    "358/2722",
                    "361/2722",
                    "474/2722",
                    "517/2722"
                ],
                "港股@收盘价排名基数[20260319]": [
                    2722,
                    2722,
                    2722,
                    2722,
                    2722,
                    2722,
                    2722,
                    2722,
                    2722,
                    2722
                ],
                "股票代码": [
                    "9678.HK",
                    "9992.HK",
                    "2706.HK",
                    "2506.HK",
                    "2018.HK",
                    "6030.HK",
                    "2328.HK",
                    "1776.HK",
                    "1519.HK",
                    "2566.HK"
                ]
            }
        }
    ]
}

查询条件示例

以下是一些常用的指标选股查询条件：

查询类型	示例searchstring	说明
----------	------------------	------
市盈率筛选	"市盈率小于15的股票"	筛选PE低于指定值的股票
市净率筛选	"市净率小于2的股票"	筛选PB低于指定值的股票
净利润筛选	"净利润增长超过30%的股票"	筛选净利润同比增长的股票
行业筛选	"医药行业股票"	筛选特定行业的股票
资金流向	"主力资金净流入的股票"	筛选资金流入的股票
涨停板	"今日涨停的股票"	筛选涨停股票
跌停板	"今日跌停的股票"	筛选跌停股票
综合筛选	"市盈率小于20且净利润增长超过20%的科技股"	多条件组合筛选

技能使用说明

请严格调用脚本来执行skill！！！

脚本gs_stock_picking.py文件在scripts目录底下

脚本运行方式

前提条件:

安装 Python 3.13 或更高版本
安装 requests 库: pip install requests
安装 requests 库: pip install uuid-backport

运行命令:

```bash

python gs_stock_picking.py --searchstring "市盈率小于20的银行股" --searchtype stock --api-key your-api-key

```

参数说明:

| 参数 | 说明 | 示例 |

|------|------|------|

| --searchstring | 选股条件，中文描述即可 | "市盈率小于20的银行股" |

| --searchtype | 搜索类型 | stock, fund, HK_stock, US_stock, NEEQ, index |

| --api-key | API密钥，用于身份验证 | your-api-key |

脚本返回结果解释

脚本会打印以下信息:

查询信息:

查询条件
搜索类型

执行状态:

状态码: 0 表示成功，-1 表示失败
消息: 描述执行结果

返回数据:

如果查询成功且有数据，会打印每个结果的表格数据
表格数据包含多个字段，具体字段取决于查询条件

示例输出

查询条件: 市盈率小于20的银行股
搜索类型: stock
正在查询...
状态码: 0
消息: 请求成功

结果 #1:
股票简称:
  - 工商银行
  - 建设银行
  - 农业银行
股票代码:
  - 601398.SH
  - 601939.SH
  - 601288.SH
市盈率:
  - 5.2
  - 5.5
  - 5.8

风险提示文案

选股结果最多仅显示符合条件的100只股票信息，但由于选股结果显示顺序的不确定性，以及系统重启操作等均可能导致相同条件下的股票排序发生变化，请投资者充分知悉。选股结果和实时行情可能有一定差异，选股结果仅作参考，不构成投资建议，请用户自主决策并自行承担投资风险。

注意事项

认证方式: 请求通过MCP网关统一鉴权，需在调用skill时提供有效的 apiKey
查询内容: searchstring参数需要清晰描述筛选条件，用户输入的中文描述即可
搜索类型: 根据查询目标选择正确的searchtype参数
返回数据: 返回的股票数据可能包含多个字段，具体字段取决于查询条件
脚本依赖: 脚本需要 requests 库，使用前请确保已安装
错误处理: 脚本会捕获请求异常并打印错误信息
风险提示: 每次skill调用后固定输出风险提示文案，这一点很重要，请牢记！

版本历史

共 1 个版本

v1.0.0 Initial release 当前

2026-06-05 13:07 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)