前言¶

做 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 。