| name | gs-smart-stock-picking |
| description | 国信智能选股skill，用于根据各种财务指标和技术指标筛选符合条件的股票。当用户需要根据特定条件查找股票时使用此skill。任务只在主agent执行,不在子agent执行。 |
国信智能选股 Skill
概述
此skill提供国信证券智能选股接口的调用能力，用于根据财务指标、技术指标、市值等条件筛选符合条件的股票。
skill使用引导
首次使用流程
-
检查API Key配置状态
-
引导用户获取API Key
当检测到没有有效的API Key时，向用户说明：
使用国信智能选股功能需要先配置API Key。请按以下步骤获取：
- 访问 https://www.guosen.com.cn/gs/xxskills/index.html 注册/登录账号
- 登录后，点击网页一级标题栏的"登录"按钮，在弹窗上可一键复制API Key
- 获取后请告诉我您的API Key，我来帮您配置
-
保存API Key
用户提供API Key后，智能体需要：
-
更新API Key
如果用户需要更换API Key，可以使用指令如"更新国信API Key"或"更换我的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=goldsun_skills
- 认证方式: 通过请求参数apiKey进行身份验证
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| searchstring | String | 是 | 选股条件，例如："市盈率小于20的银行股" |
| searchtype | String | 是 | 搜索类型，详见下表 |
| apiKey | String | 是 | API密钥，用于身份验证，每次调用技能时由用户配置 |
| softName | String | 是 | 固定字符串，送goldsun_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=goldsun_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port
查询不同类型资产
# 查询股票
GET /mcp/smart_stock_picking?searchstring=市盈率小于20的银行股&searchtype=stock&softName=goldsun_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port
# 查询基金
GET /mcp/smart_stock_picking?searchstring=近一年收益超过20%的基金&searchtype=fund&softName=goldsun_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port
# 查询港股
GET /mcp/smart_stock_picking?searchstring=当前macd为金叉的价格最高的前十只股票&searchtype=HK_stock&softName=goldsun_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port
# 查询美股
GET /mcp/smart_stock_picking?searchstring=苹果相关股票&searchtype=US_stock&softName=goldsun_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port
# 查询指数
GET /mcp/smart_stock_picking?searchstring=上证指数&searchtype=index&softName=goldsun_skills&apiKey=your-api-key HTTP/1.1
Host: your-server-host:port
# 查新三板
GET /mcp/smart_stock_picking?searchstring=最近放量上涨的10家公司&searchtype=NEEQ&softName=goldsun_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
查询条件示例
以下是一些常用的指标选股查询条件：
| 查询类型 | 示例searchstring | 说明 |
|---|
| 市盈率筛选 | "市盈率小于15的股票" | 筛选PE低于指定值的股票 |
| 市净率筛选 | "市净率小于2的股票" | 筛选PB低于指定值的股票 |
| 净利润筛选 | "净利润增长超过30%的股票" | 筛选净利润同比增长的股票 |
| 行业筛选 | "医药行业股票" | 筛选特定行业的股票 |
| 资金流向 | "主力资金净流入的股票" | 筛选资金流入的股票 |
| 涨停板 | "今日涨停的股票" | 筛选涨停股票 |
| 跌停板 | "今日跌停的股票" | 筛选跌停股票 |
| 综合筛选 | "市盈率小于20且净利润增长超过20%的科技股" | 多条件组合筛选 |
技能使用说明
请严格调用脚本来执行skill！！！
脚本gs_stock_picking.py文件在scripts目录底下
脚本运行方式
-
前提条件:
- 安装 Python 3.6 或更高版本
- 安装 requests 库:
pip install requests
-
运行命令:
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
风险提示文案
风险提示：选股结果和实时行情可能有一定差异，选股结果仅作参考，不构成投资建议，请用户自主决策并自行承担投资风险。
注意事项
- 认证方式: 请求通过MCP网关统一鉴权，需在调用skill时提供有效的
apiKey
- 查询内容: searchstring参数需要清晰描述筛选条件，用户输入的中文描述即可
- 搜索类型: 根据查询目标选择正确的searchtype参数
- 返回数据: 返回的股票数据可能包含多个字段，具体字段取决于查询条件
- 脚本依赖: 脚本需要 requests 库，使用前请确保已安装
- 错误处理: 脚本会捕获请求异常并打印错误信息
- 风险提示: 每次skill调用后固定输出风险提示文案，这一点很重要，请牢记！
