ETF智能筛选

技能调用方式

python /workspace/projects/gs-etf-filter/scripts/get_data.py --help

功能范围

1. 专业榜单筛选

通过专业榜单直接获取筛选结果，支持以下榜单：

2. 自定义筛选

支持7大维度24个指标的筛选：

环境要求

• Python 3.13 及以上版本

前置准备

获取API Key

该技能依赖国信证券小信智慧助手的数据服务，需要先配置API Key。

配置步骤：

1. 访问 https://www.guosen.com.cn/gs/xxskills/key-index.html?softName=tx_skills 注册/登录账号
2. 登录后获取您的API Key。登录位置：网页一级标题栏-登录。登录后，点击账号，在弹窗上可一键复制API Key。
3. 在技能凭证配置中填入API Key

API Key持久化存储（重要）

当用户提供API Key并完成凭证配置后，智能体必须执行以下操作：

1. 立即写入memory.md：
• 创建或更新 ./memory.md 文件
• 添加以下内容：

```markdown

## 国信证券ETF筛选服务配置

• API Key: [用户提供的API Key]
• 环境变量名: COZE_GUOSEN_API_KEY_7627056463827140634
• 配置时间: [当前时间]

```

1. 后续调用脚本时设置环境变量：
• 从memory.md读取API Key
• 在调用脚本前设置环境变量：

```python

import os

api_key = 从memory.md读取的API Key

os.environ["COZE_GUOSEN_API_KEY_7627056463827140634"] = api_key

```

• 然后调用脚本执行ETF筛选

1. 确认存储成功：告知用户API Key已保存，后续使用无需重复配置

注意事项：

• memory.md用于智能体长期记忆，确保API Key在会话间保持有效
• 环境变量 COZE_GUOSEN_API_KEY_7627056463827140634 是脚本读取API Key的唯一途径
• 每次调用脚本前必须设置该环境变量，否则脚本将无法获取API Key
• 如用户更换API Key，需同步更新memory.md中的配置

安装依赖

依赖已在SKILL.md前言区定义，系统会自动安装。

智能体调用脚本流程

智能体在调用脚本执行ETF筛选时，必须遵循以下流程：

1. 检查并读取memory.md：
• 检查 ./memory.md 文件是否存在
• 读取其中的API Key和环境变量名

1. 设置环境变量：

```python

import os

# 从memory.md读取API Key

api_key = "从memory.md读取的API Key"

# 设置环境变量

os.environ["COZE_GUOSEN_API_KEY_7627056463827140634"] = api_key

```

1. 调用脚本执行筛选：

```bash

python /workspace/projects/gs-etf-filter/scripts/get_data.py [参数]

```

1. 读取结果并展示：
• 读取脚本输出的txt或xlsx文件
• 格式化展示ETF数据

注意事项：

• 每次调用脚本前都必须设置环境变量
• 如果memory.md中不存在API Key，需要提示用户先配置
• 环境变量名必须是 COZE_GUOSEN_API_KEY_7627056463827140634，不能更改

输出说明

脚本会在 /workspace/projects/gs-etf-filter/scripts/output/ 目录下生成中间结果文件（xlsx、txt），这些文件仅用于数据存储，不应向用户展示文件路径或文件内容。

智能体输出要求

智能体在脚本执行完成后，必须：

1. 读取脚本输出的txt或xlsx文件，解析其中的数据
2. 直接将筛选到的全部ETF以表格或列表形式完整呈现给用户（最多100只），不得省略或截断，仅需展示以下字段：
• ETF名称（产品名称）
• ETF代码（产品代码）
• ETF价格（最新价）
• ETF最新涨跌幅（实时涨跌）
• ETF规模（最新规模/规模(亿)）
• ETF成立年限
3. 首行说明筛选到的ETF只数和本次筛选条件
4. 末行固定输出：筛选结果展示满足条件的前100只ETF。
5. 不得向用户展示文件路径、文件名等中间文件信息

使用示例

专业榜单调用

python /workspace/projects/gs-etf-filter/scripts/get_data.py --list-id 21 --class-id 2
python /workspace/projects/gs-etf-filter/scripts/get_data.py --list-id 13 --class-id 1 --order-col nowrange

自定义筛选调用

# 筛选规模>10亿且管理费率<0.5%的宽基ETF
python /workspace/projects/gs-etf-filter/scripts/get_data.py --class1 2 --endamt "10,100000" --tgfandglf "0,0.5"

# 筛选近1年业绩排名前25%的行业ETF
python /workspace/projects/gs-etf-filter/scripts/get_data.py --class1 1 --profitrank "profit1yrank:25"

# 按夏普比率排序
python /workspace/projects/gs-etf-filter/scripts/get_data.py --class1 1 --order-col sharpe1yrank --order-type 1

补充说明

• 本技能面向ETF筛选分析，不提供投资建议
• 支持中英文输入
• 筛选结果最多返回满足条件的前100只ETF
• 脚本取数完成后，智能体应读取结果文件，直接向用户呈现数据表格和分析报告，不得展示文件路径
• 智能体在首次配置API Key后，必须将API Key写入memory.md进行持久化存储
• 后续使用时，智能体应从memory.md读取API Key，无需用户重复提供

必须输出的声明内容

每次调用本SKILL后，智能体必须在输出末尾附上以下风险提示：

> 风险提示:筛选结果展示满足条件的前100只ETF。