跳到主要内容

Agent Skill 快速开始

hithink-finance Skill 是 Agent 使用同花顺金融数据的统一入口。安装后，用户可以直接描述数据需求，由 Agent 完成标的消歧、选择 REST API、MCP、CLI 或 Python，并处理结构化输出。

GitHub · Skill 源码

查看完整 Skill 目录、说明文件和配套 references。

SkillHub · hithink-finance

打开 SkillHub 页面，查看并安装 hithink-finance。

完成后你将拥有​

  • 一个能识别金融数据意图的 Agent 统一入口。
  • 对标的检索、行情、财务、估值、指数、基金、特色数据和本地数据的路由能力。
  • 一套安全使用 API Key、处理大结果和报告数据口径的执行规则。

Skill 不是另一份 API 契约，也不会绕过账号权限。它帮助 Agent 在当前环境中选择正确的官方入口。

前置条件​

  • 支持 Skills 的 Agent，例如 Codex 或 Claude Code。
  • Node.js 和 npm/npx。
  • GitHub 网络访问，或可手工复制的完整 Skill 目录。
  • 从 API Key 管理 创建的 Key。

第 1 步：安装 Skill​

推荐通过 Skills CLI 全局安装：

npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes

无法通过 GitHub 安装时，可以让 Agent 按 Skill Hub 安装指南 安装 hithink-finance。

手工安装时，将源仓的完整 skills/hithink-finance/ 目录复制到当前 Agent 文档声明的 Skills 发现目录。必须保留 references/ 及其子目录，不要只复制 SKILL.md。

第 2 步：重新打开 Agent 会话​

多数 Agent 只在会话启动时扫描 Skills。安装完成后，新建一个会话，不要仅在安装前已打开的会话中测试。

在新会话中可先说：

请检查 hithink-finance Skill 是否已加载，只报告检查结果，暂时不安装或升级其他工具。

Agent 应能识别 hithink-finance 的适用范围和主路由。单纯看到某个目录存在不等于当前 Agent 已发现该 Skill，以 Agent 实际加载结果为准。

第 3 步：配置统一 API Key​

Skill 按以下顺序复用凭据：

  1. 当前任务通过安全输入提供的 Key。
  2. HITHINK_FINANCE_API_KEY 环境变量。
  3. 用户级 hithink-finance/credentials.env。
  4. 兼容的旧凭据来源或已有 CLI 系统凭据。

推荐使用用户级环境变量 HITHINK_FINANCE_API_KEY。配置完成后重启 Agent，使新进程继承该变量。

注意

不要把 Key 写入 Skill 文件、Prompt、项目配置、日志或 Git。如果用户主动将 Key 交给 Agent，Agent 不应复述它，只能将它写入用户授权的安全凭据来源。

第 4 步：完成首次真实任务​

在新会话直接描述需求，不需要先提供 thscode、接口名或命令参数：

查询贵州茅台的最新行情。请先搜索并确认标准证券代码，再获取真实数据，注明数据时间和来源。

成功判定​

一次完整的首次任务应包含：

  1. Agent 将名称消歧为唯一 thscode，不猜测交易所后缀。
  2. Agent 选择当前已可用的 CLI、MCP、REST API 或 Python 主路径。
  3. 真实请求成功，返回非空数据。
  4. 结果注明数据源和数据时间；涉及分析时注明“非投资建议”。

只读取 Skill 文件、离线契约或示例数据，不能证明当前账号的线上权限可用。

第 5 步：继续使用​

你可以继续用业务语言描述任务：

获取沪深300当前成分股，并将结果保存为本地文件。
查询宁德时代最近四期利润表和主要盈利指标，注明报告期和数据来源。

全市场、多年、多标的或分页全集应让 Agent 落盘，只在对话中返回文件路径、行数、时间窗口和摘要。

常见问题​

Agent 没有识别 Skill​

确认安装的是完整 hithink-finance 目录，然后新建 Agent 会话。如果手工复制，检查目标是当前 Agent 实际的 Skills 发现目录，而不是任意项目目录。

Agent 重复要求 API Key​

先确认 Agent 进程是否继承 HITHINK_FINANCE_API_KEY，再检查用户级 credentials.env。切换 CLI、MCP 或 Python 时应复用同一凭据，无需重新创建 Key。

Agent 返回静态示例​

要求 Agent 明确报告实际使用的工具、数据时间、数据源以及线上请求的成功条件。真实数据不可用时，Agent 应报告原因，不应用模拟数据冒充。

下一步​