前言¶

在 Agent 裏問「這隻 ETF 怎麼樣」「值不值得買」「爲什麼突然大跌」，模型往往只能泛泛而談：缺少實時行情、持倉穿透和異動歸因，結論很難對照數據覈對。自己打開行情軟件、基金公告和新聞再手工彙總，又打斷對話節奏。

下面介紹 SkillHub 上的 DEEPQ-ETF分析。它把「認代碼 → 拉數據 → 按維度出報告」寫進 SKILL.md，由 Agent 在合適的問題下自動選用一組 DeepQ 數據工具，覆蓋從概況到異動解釋的常見調研路徑。

這是什麼¶

DEEPQ-ETF分析 面向「指定一隻 ETF 基金」做結構化分析：基本信息、實時行情、技術面、基本面、業績、底層資產、消息面，以及價格異動歸因。發佈在 SkillHub 社區，命名空間爲 @user_e7dd0698/etf-analysis，官方入口：

https://api.skillhub.cn/user_e7dd0698/etf-analysis

SkillHub 側歸類爲 professional；公開資料中該技能評分 99740，累計下載 766 次（與同類 DEEPQ 行情/基金技能同屬 user_e7dd0698 發佈者）。

技能通過 MCP 調用 DeepQ 側工具（見下文工具列表）。同作者的 DEEPQ-基金分析 技能包中寫明依賴 DeepQ MCP Server，並標註 requires_api_key；ETF 技能使用的 guessFundCode 等與基金分析同屬 DeepQ 工具族，啓用前同樣需要可用的 MCP 與 API 訪問能力。

核心功能¶

技能說明中的能力邊界如下（按數據維度歸納，工具名保持原文）：

觸發場景（技能描述中的 Use when 示例）：

• 「分析滬深300ETF」
• 「科創50ETF值得買嗎」
• 「這隻ETF爲什麼大跌」

當用戶詢問某 ETF 概況、是否值得買入，或近期劇烈波動原因時，Agent 應加載本 Skill，並按問題深淺組合上述工具，而不是僅做無數據支撐的泛泛建議。

安裝與啓用¶

1. 從 SkillHub 安裝 Skill¶

當前通過 SkillHub 開放下載接口 slug=etf-analysis 未能拉取到技能包（返回 404），請以官方主頁的安裝指引爲準：

https://api.skillhub.cn/user_e7dd0698/etf-analysis

在 Cursor、Codex CLI、Claude Code 等支持 Agent Skills 的環境中，一般將技能目錄（含 SKILL.md）放入項目或全局 skills 路徑，並在設置中啓用；具體菜單名稱以各客戶端文檔爲準。同倉庫內其他 Skill 常見寫法爲：

skillhub install <slug>

若 CLI 已配置 SkillHub，可在主頁確認該技能的 slug 後再執行安裝；覈實不到客戶端差異時，以官方頁說明優先。

2. 配置 DeepQ MCP Server¶

工具調用依賴 MCP。以下配置摘自已發佈的 DEEPQ-基金分析 技能包（同 deepqtech 維護、同一 MCP 接入方式），替換其中的 <DEEPQ_API_KEY> 後合併進 Agent 的 MCP 配置（如 Cursor 的 mcp.json）。

優先使用 Streamable HTTP（無需本地安裝 @deepqtech/mcp-server-js）：

{
  "mcpServers": {
    "Deepq-all-in-one-auth-streamable": {
      "type": "streamableHttp",
      "url": "https://cgi.deepq.tech:9198/mcp-servers/mcp?access_token=<DEEPQ_API_KEY>"
    }
  }
}

備選：Stdio 本地進程：

{
  "mcpServers": {
    "Deepq-all-in-one-auth-stdio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@deepqtech/mcp-server-js@latest", "start"],
      "env": {
        "DEEPQ_API_KEY": "<DEEPQ_API_KEY>"
      }
    }
  }
}

API Key：技能包建議優先讀取環境變量 DEEPQ_API_KEY；未設置時文檔中給出過默認 Key 字符串（生產環境建議改用自有 Key）。修改 MCP 配置後需重啓 Agent 或開啓新會話，使工具列表刷新。

典型用法¶

無需記憶工具參數名，用自然語言觸發即可；Agent 按 SKILL.md 先 guessFundCode，再並行或按需調用分析類工具。

概況調研

分析滬深300ETF

預期路徑：解析代碼 → etfBasicInfo、etfLatestPrice → 視問題補充 etfTechAnalysis / etfFunAnalysis / etfPerformance。

買入與否類問題

科創50ETF值得買嗎

預期路徑：在概況與業績基礎上，結合 etfUnderAssets、etfRelatedNews 組織風險與邏輯說明；輸出應爲「數據 + 條件判斷」，而非單一買賣口令。

異動解釋

這隻ETF爲什麼大跌

預期路徑：在行情與業績快照後重點調用 etfPriceFluctReason，並用 etfRelatedNews 交叉覈對消息面。

經過上面的步驟，同一會話內可以連續追問「重倉行業」「近一年回撤」等，由 Agent 決定是否追加 etfUnderAssets、etfPerformance 等調用。

適用場景與注意¶

適合誰

• 需要在對話裏快速拉齊單隻 ETF 的多維事實、再自己做決策的研究者或開發者。
• 已在使用 Cursor 等 Agent，並希望用 Skill 固定「分析一隻 ETF」的執行路徑，避免每次手寫提示詞列數據源。

限制與注意

• 依賴 DeepQ MCP 與網絡；Key 無效或 MCP 未加載時，工具調用會失敗，Skill 無法替代數據源本身。
• 技能輸出用於信息整理與輔助研究，不構成投資建議；「值得買嗎」類問題應結合個人風險偏好自行判斷。
• 官方主頁與開放 API 對 etf-analysis 的元數據拉取在撰寫時存在不一致（主頁 URL 有效、部分 API 未返回該 slug）；安裝與版本以 SkillHub 頁面爲準。
• 同發佈者的 DEEPQ 基金/股票類 Skill 在 SkillHub 上標記需 API Key；部署前確認密鑰與合規要求。

結尾¶

DEEPQ-ETF分析 把單隻 ETF 從代碼識別到行情、業績、持倉、資訊和異動歸因串成一條可複用的 Agent 工作流，適合「先查清事實再討論觀點」的用法。安裝與更新請以 SkillHub 官方頁爲準：

https://api.skillhub.cn/user_e7dd0698/etf-analysis