前言¶

做 ETF 相关助手或投研对话时，常见做法是手写筛选 SQL、对接零散行情接口，或在网页端复制榜单结果再贴回对话。全市场产品多、维度杂，条件一组合就容易漏字段、难复现。下面介绍 SkillHub 上的企业级 Skill「国信证券-ETF筛选器」，把专业榜单与自定义多维筛选封装成 Agent 可调用的能力，由国信证券股份有限公司维护，面向 ETF 投资决策与资产配置前的产品收窄。

这是什么¶

「国信证券-ETF筛选器」是符合通用 SKILL.md 规范的 Agent Skill，坐标为 @guosen-securities/guosen-etf-filter，当前版本 1.0.0，在 SkillHub 分类为 professional，来源标记为 enterprise。官方资料中的定位是：提供全市场 ETF 产品的智能筛选与多维分析服务。

数据侧依赖国信证券小信智慧助手服务，Skill 标签标明 requires_api_key=true，使用前需自行申请并配置 API Key。SkillHub 页面显示发布者为国信证券股份有限公司；统计信息（以 SkillHub 抓取为准）评分 100000，下载 1909 次。

• 官方 API 入口：https://api.skillhub.cn/guosen-securities/guosen-etf-filter
• SkillHub 展示页：https://www.skillhub.cn/skills/guosen-securities/guosen-etf-filter

核心功能¶

经核对技能包内 SKILL.md，能力分为两类，均通过 scripts/get_data.py 取数，由智能体解析输出后向用户展示表格（不直接暴露中间文件路径）。

专业榜单筛选¶

按 classId / listId 拉取预设榜单，例如：

自定义多维筛选¶

支持 7 大维度、24 个指标，涵盖基本信息（一级/二级类型、规模、成立年限、费率等）、交易属性（T+0、融资融券等）、收益表现、风险波动、行情指标、基本面与趋势热度。参数名与取值格式在 SKILL.md 中有完整表格，例如规模 endamt 以「亿」为单位、区间用逗号或分号连接。

补充说明（官方原文要点）：

• 筛选结果最多返回满足条件的前 100 只 ETF。
• 技能面向筛选分析，不提供投资建议；每次使用后需附带指定风险提示文案。
• 运行环境要求 Python 3.13 及以上；依赖包括 httpx、pandas、openpyxl、uuid-backport 等，由技能元数据声明。

安装与启用¶

安装 SkillHub CLI（若尚未安装）¶

先确认本机是否已有 CLI：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档执行完整安装（示例为官方文档中的推荐命令）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill¶

官方页面提示可让 AI 参照 https://skillhub.cn/install/skillhub.md 安装 @guosen-securities/guosen-etf-filter。CLI 搜索结果显示的安装方式为：

skillhub install guosen-etf-filter --namespace guosen-securities --dir <skills 目录>

安装时必须用 --dir 指向当前 Agent 实际识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。常用路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

在 Cursor 下的示例：

skillhub install guosen-etf-filter --namespace guosen-securities --dir ~/.cursor/skills/

安装完成后，技能目录内包含 SKILL.md 与 scripts/get_data.py 等文件；调用脚本时请使用本机安装路径下的 scripts/get_data.py（技能文档中的 /workspace/projects/gs-etf-filter/ 为示例工作区路径，需替换为实际目录）。

配置 API Key¶

1. 打开 https://www.guosen.com.cn/gs/xxskills/key-index.html?softName=tx_skills 注册或登录。
2. 在页面一级标题栏登录后，于账号弹窗中复制 API Key。
3. 按 SKILL.md 要求写入智能体可复用的凭证（文档建议写入 ./memory.md），并在每次调用脚本前设置环境变量：

export COZE_GUOSEN_API_KEY_7627056463827140634="<你的 API Key>"

脚本仅通过环境变量名 COZE_GUOSEN_API_KEY_7627056463827140634 读取密钥，名称不可更改。更换 Key 时需同步更新持久化配置。

典型用法¶

在 Agent 已加载该 Skill 且 API Key 已配置的前提下，既可以用自然语言描述「某榜单」「某类 ETF + 规模/费率条件」，也可以直接调用脚本（将路径换成你的安装目录，记为 $SKILL_ROOT）。

专业榜单¶

查询「高分红低波动」榜单（class-id 2，list-id 21）：

python "$SKILL_ROOT/scripts/get_data.py" --list-id 21 --class-id 2

短线热榜「T+0短线突破」，并按 nowrange 排序：

python "$SKILL_ROOT/scripts/get_data.py" --list-id 13 --class-id 1 --order-col nowrange

自定义条件¶

规模 10 亿以上、托管费与管理费合计不超过 0.5% 的宽基 ETF（class1 宽基为 2）：

python "$SKILL_ROOT/scripts/get_data.py" --class1 2 --endamt "10,100000" --tgfandglf "0,0.5"

近 1 年业绩排名前 25% 的行业 ETF：

python "$SKILL_ROOT/scripts/get_data.py" --class1 1 --profitrank "profit1yrank:25"

按近 1 年夏普比率排名排序：

python "$SKILL_ROOT/scripts/get_data.py" --class1 1 --order-col sharpe1yrank --order-type 1

脚本会在其 output/ 目录生成 xlsx、txt 等中间文件；智能体应读取这些结果，向用户展示名称、代码、价格、涨跌幅、规模、成立年限等字段，并说明筛选只数与条件，不要把中间文件路径当作最终交付物。输出末尾需固定带上官方要求的风险提示：筛选结果展示满足条件的前100只ETF。

适用场景与注意¶

适合谁

• 需要在 Cursor、Claude Code、Codex 等环境里做 ETF 产品池收窄、榜单对照、条件回测式筛选的开发者或投研使用者。
• 希望由 Agent 统一走国信证券数据服务，而不是为每个维度单独接 API 的团队。

限制与注意

• 必须持有有效 API Key，并保证 Python 3.13+ 与技能声明的依赖已安装。
• 结果为筛选与分析数据，非投资建议；合规场景下需自行加免责声明与权限控制。
• 单次最多 100 条结果；中英文输入在官方说明中均支持。
• 企业源 Skill 的可用性与配额以国信证券及 SkillHub 当前策略为准，部署前建议在目标环境试装并验证一次取数。

结尾¶

「国信证券-ETF筛选器」把全市场 ETF 的专业榜单与 7 维自定义筛选收敛到一个 Skill 与一套脚本接口里，适合嵌进投研类 Agent 工作流。安装与优先源说明见 https://skillhub.cn/install/skillhub.md ，技能详情与安装提示见 https://www.skillhub.cn/skills/guosen-securities/guosen-etf-filter ，包坐标入口为 https://api.skillhub.cn/guosen-securities/guosen-etf-filter 。