前言¶
在 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 访问能力。
核心功能¶
技能说明中的能力边界如下（按数据维度归纳，工具名保持原文）：
| 维度 | 对应工具 | 用途 |
|---|---|---|
| 代码识别 | guessFundCode |
将用户说的 ETF 名称或简称解析为可查代码 |
| 基本信息 | etfBasicInfo |
基金类型、规模、跟踪标的等概况 |
| 实时行情 | etfLatestPrice |
现价及当日行情相关字段 |
| 技术面 | etfTechAnalysis |
技术指标向的分析结果 |
| 基本面 | etfFunAnalysis |
基本面维度指标与解读 |
| 业绩 | etfPerformance |
各周期收益、回撤等业绩表现 |
| 底层资产 | etfUnderAssets |
持仓、行业或资产配置等穿透信息 |
| 消息面 | etfRelatedNews |
与标的相关的资讯条目 |
| 异动归因 | etfPriceFluctReason |
大涨大跌等原因归纳 |
触发场景（技能描述中的 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
