前言¶

在 IDE 或对话式 Agent 里做 A 股研究，常见做法是临时拼 curl、翻零散接口文档，或在 CLI、MCP、HTTP 之间来回切换。标的要先消歧成带市场后缀的代码，财报和估值还要对齐报告期与口径；一旦涉及全市场或长窗口，结果体量又容易把上下文撑爆。下面介绍 SkillHub 上的「同花顺金融数据」Skill（坐标 @org-6602ci5n/hithink-finance）：它把同花顺金融数据服务的任务路由、凭据约定和 REST / MCP / CLI 契约收进一份 SKILL.md，让 Agent 按场景选路，而不是每次从零摸索。

这是什么¶

「同花顺金融数据」是同花顺金融数据服务的统一 Agent 入口。发布方为浙江同花顺网络科技有限公司，在 SkillHub 上归类为 professional，当前版本 1.1.2，标签标明 requires_api_key=true（远端取数需要 API Key）。Skill 简介写明：通过同花顺金融数据服务查询、分析、同步或导出 A 股、指数、基金、期货、期权与本地 DuckDB 数据，并用于选择和配置 CLI、MCP、REST API 以及执行金融取数任务。官方 GitHub 仓库为 HiThink-Tech/Financial-API；执行任务时优先读取 Skill 内置文档，无需再克隆仓库。

SkillHub 页面：https://www.skillhub.cn/skills/org-6602ci5n/hithink-finance；API 坐标页：https://api.skillhub.cn/org-6602ci5n/hithink-finance。

核心功能¶

Skill 按用户意图在三种主路径之间路由，并内置各路径的业务契约说明。

数据与任务层面，Skill 文档覆盖的能力包括：A 股行情、财报、最新估值、集合竞价、指数/板块/特色数据、公募基金、公开期货期权资料与行情，以及本地 DuckDB 同步与导出。执行规则强调：名称或代码不唯一时先搜索消歧为 thscode；A 股历史行情未指定复权时默认 forward（前复权）；全市场或长窗口结果应落盘并只回报路径与行数摘要；成功验收以业务信封为准（REST/MCP 的 code=0，CLI 退出码 0 且 JSON ok=true）。

文档同时标明能力边界：分钟 K/tick/Level-2、港股/美股、基金申赎与订单执行等不在当前公开接入范围内；部分「端内专用」能力仅在同花顺 AI 客户端提供，不作为公开 REST、MCP、CLI 或 Python SDK 入口。

安装与启用¶

在 SkillHub 安装 Skill¶

官方页面要求按 SkillHub 安装说明安装本 Skill。先确认是否已有 skillhub CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装或仅 CLI（见 https://skillhub.cn/install/skillhub.md）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

skillhub install @org-6602ci5n/hithink-finance --dir <skills 目录>

常用路径示例（来自 SkillHub 安装文档）：

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

安装完成后，Agent 在新会话中加载该目录下的 SKILL.md 即可按内置 references 执行任务。

配置 API Key（与接入方式无关）¶

远端接入共用同一 API Key，在管理后台获取：https://fuyao.aicubes.cn/admin/（须保留末尾 /，避免扫码登录态因 HTTP 降级丢失）。推荐检查顺序：

1. 环境变量 HITHINK_FINANCE_API_KEY
2. 用户级 credentials.env（Linux：${XDG_CONFIG_HOME:-~/.config}/hithink-finance/credentials.env，文件内一行 HITHINK_FINANCE_API_KEY=...）
3. 兼容已有 FUYAO_TOKEN、API_KEY 或 CLI 系统凭据

配置 API Key 不要求先安装 CLI；选定 CLI 路径且需要同步系统凭据时，可通过 stdin 登录：

printf '%s' "$HITHINK_FINANCE_API_KEY" | \
  hithink-finance auth login --api-key-stdin --format json

可选：安装 hithink-finance CLI¶

当任务适合 CLI（含本地 DuckDB）且 PATH 中尚无命令时，Skill 约定可先告知用户再安装。要求 Node.js >=22.12.0 与可用 npm：

npm install -g @hithink-tech/hithink-finance-cli
hithink-finance version --format json

安装后可用 hithink-finance skills status --format json 与 capabilities --format json 核对命令与内置 Skill 来源，再执行具体取数。

典型用法¶

下面步骤来自 Skill 内置契约，可按环境复现。

1. REST：搜索标的并验证认证

用最小请求确认 Key 与搜索接口可用（将 <API_KEY> 替换为真实 Key，勿写入仓库或日志）：

curl 'https://fuyao.aicubes.cn/api/meta/tickers/search?q=600519&limit=1' \
  -H 'X-api-key: <API_KEY>'

成功条件为 HTTP 200 且响应体 code == 0；标的代码使用完整 thscode（例如 600519.SH），不要猜测交易所后缀。

2. CLI：检查环境与内置能力

hithink-finance version --format json
hithink-finance auth status --format json
hithink-finance skills status --format json
hithink-finance capabilities --format json

确定使用 CLI 完成金融任务时，应以上述 capabilities 与命令 --help 为准，而不是仅阅读 Skill 总览。

3. Agent 侧的自然语言任务

向 Agent 描述资产类别、时间窗口、新鲜度与输出规模即可，例如「查询某公司最近四个季度的利润表指标并落盘 CSV」。Skill 要求 Agent：缺失信息会显著改变结果时才简短确认；优先本地 DuckDB 中足够新的历史 OHLCV；远端失败时报告阶段与脱敏错误，不用静态示例冒充真实数据。

适用场景与注意¶

适合谁

• 在 Cursor、Claude Code、Codex 等支持 Skills 的客户端里，需要稳定对接同花顺 A 股及相关市场的研发、量化或数据分析 Agent。
• 需要在一次对话里完成「选 REST / MCP / CLI → 读契约 → 配置 Key → 取数/同步」的团队，希望减少手写胶水代码。

限制与坑

• 必须自备 API Key；Skill 不会用全市场下载代替认证校验。
• 管理后台 URL 务必使用带尾斜杠的 HTTPS 地址；扫码登录依赖可见浏览器窗口，自动化「已打开」不等于用户能看到二维码。
• Key 不得进入命令参数、项目文件或 Git；聊天里直接粘贴 Key 时，平台可能保留消息记录。
• SkillHub 安装与 GitHub 上 npx skills update hithink-finance 的更新路径不同；从 SkillHub 安装时，内置文档以当前安装包为准。
• 公开接口与端内客户端能力有明确分界，命中端内能力时应改走客户端入口，而非强行调用公开 API。

结尾¶

「同花顺金融数据」Skill 把同花顺金融数据服务的接入选择、凭据规则和业务契约收敛到 Agent 可读的一份文档里，适合作为 A 股及相关品种取数、同步与分析时的默认 playbook。安装与详情见 SkillHub：https://www.skillhub.cn/skills/org-6602ci5n/hithink-finance，坐标页：https://api.skillhub.cn/org-6602ci5n/hithink-finance。