前言¶
做投研或复盘时，常见路径是打开行情终端、切多个数据源，再手工整理成表格或笔记。Agent 能写代码、能总结，但若没有稳定的金融数据入口，往往仍要你自己对接接口或导出 CSV。下面介绍 SkillHub 上的 mx-finance-data：把查询意图交给自然语言，由 Skill 基于东方财富侧数据返回结构化结果，并附带 xlsx 与 Markdown，便于继续分析或归档。
这是什么¶
mx-finance-data 是社区来源（community）、分类为 professional 的 Agent Skill，坐标为 @user_15292d5a/yjkj-mx-finance-data，当前版本 1.0.0，由发布者 user_15292d5a 维护（SkillHub 页面展示作者标识为 yjkj999999）。
一句话定位：基于东方财富数据库，支持用自然语言查询多市场、多品类的金融数据；英文说明中同时提到 L1/L2 数据、财务指标、公司概况与估值类信息。SkillHub 标签 requires_api_key=true，使用前需准备相应 API Key（具体变量名与配置步骤以安装包内 SKILL.md 为准，官方简介页未单独列出字段表）。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面展开的实现细节不展开臆测。
- 自然语言查询：用口语化问题描述标的、指标或报表需求，由 Skill 组织查询与结果呈现。
- 市场与品类：覆盖 A 股、港股、美股，以及基金、债券、ETF 等；场景描述中还包含实时行情、公司信息、估值、财务报表等类型数据。
- 输出形态：返回结果包含 xlsx 与 Markdown 文件，便于在 Excel 中继续建模，或在文档/笔记链路中引用。
- 典型用途（官方列举）：投资研究、交易复盘、市场监控、行业分析、信用研究、财报审计、资产配置等；英文说明中还提到 strategy backtesting、market monitoring、industry analysis 等方向。
SkillHub 页面统计（抓取时点）：评分 100000，下载 1036 次；安装数在元数据中显示为 0，以商店页面实时数据为准。
安装与启用¶
安装流程遵循 SkillHub 通用说明 skillhub.cn/install/skillhub.md。核心要点：技能必须装到当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。
1、检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按官方脚本安装（完整包含 CLI 与默认 Skill；也可仅装 CLI）：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 mx-finance-data¶
将 @user_15292d5a/yjkj-mx-finance-data 安装到当前环境的 skills 目录。不同客户端路径不同，安装文档给出的示例如下：
| 环境 | skills 目录（官方文档示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
以 Cursor 为例，命令形如：
skillhub install @user_15292d5a/yjkj-mx-finance-data --dir ~/.cursor/skills/
若你更习惯让 IDE 内的 Agent 代为安装，SkillHub 商品页提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_15292d5a/yjkj-mx-finance-data`。
安装完成后，按所用 Agent 的要求重启或刷新技能列表，并依照包内 SKILL.md 配置 API Key（requires_api_key=true）。
典型用法¶
官方商品页未给出逐条可复制的产品级 Demo；能力边界以简介为准：在已启用 Skill 的 Agent 对话中，用自然语言描述你要查的市场、标的与数据类型（例如行情、公司资料、估值或财报维度），由 Skill 调用东方财富侧数据并生成 xlsx / Markdown。
操作时建议：
- 问题写清市场（A / 港 / 美）、标的标识或名称、时间范围或报表期次。
- 说明希望的输出：是要表格文件、还是要便于粘贴的 Markdown 摘要。
- 首次使用前完成 API Key 配置，避免查询中途因鉴权失败中断。
具体触发话术、工具链步骤以安装后的 SKILL.md 为准；本文不编造未在官方资料出现的接口名或配置项。
适用场景与注意¶
适合谁：需要频繁拉取多市场、多品类金融数据，并希望留在 Agent 工作流里完成查询与落盘的研究、交易、风控或分析岗位；个人投资者若已配置好 API Key，也可用于监控与复盘。
使用注意：
- 数据来源标注为东方财富数据库，合规与授权边界以数据方与 Skill 提供方说明为准；SkillHub 页面标注 作者自主，使用前应自行评估风险。
- 涉及实盘或对外报告时，应对关键数字做二次校验，不宜将 Agent 输出当作唯一权威来源。
- 实时行情与历史财务指标对时效、口径敏感，查询语句应明确「截至何时」「哪一期报表」。
- 社区 Skill，版本 1.0.0；升级与变更以 SkillHub 坐标页为准。
结尾¶
mx-finance-data 把「多市场金融数据查询 + 双格式落盘」收敛进一个 Skill：自然语言提问，xlsx 与 Markdown 带走结果，减少在终端与表格之间来回切换的成本。安装与坐标信息见 SkillHub：
- 商品页：https://www.skillhub.cn/skills/user_15292d5a/yjkj-mx-finance-data
- API 元数据地址：https://api.skillhub.cn/user_15292d5a/yjkj-mx-finance-data
