Financial-API

环境要求

• Node.js 环境（npx、npm ci 与 npm run build 依赖）
• 同花顺金融数据服务的统一 API Key（官网管理页创建）
• 支持 MCP 或 Agent Skill 的 AI 客户端（如 Claude、Cursor、Windsurf）

安装与启动步骤

1. 1获取 API Key

   打开同花顺金融数据服务管理页注册并创建统一的 API Key，后续 API、MCP、CLI、SDK 共用这一个 Key。

2. 2安装 hithink-finance S

   推荐用 npx skills add 安装官方 Skill，它会在每个 Agent 会话首次使用时静默检查并自动更新自身。

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

   复制

3. 3无网络时改用 Skill Hub

   网络受限无法执行 npx 时，把这条提示词发给你的 AI，让它按 Skill Hub 说明安装同一个 Skill。

   请根据 https://skillhub.cn/install/skillhub.md，安装 hithink-finance。

   复制

4. 4重开会话直接提问

   安装完成后重新打开 Agent 会话，直接描述金融数据需求，Agent 会自动在 API、MCP、CLI、SDK 间选择。

   查询贵州茅台的最新行情，并分析近一年的涨跌幅、最大回撤和均线趋势。

   复制

5. 5用 SQL 查询本地库

   安装 CLI 后可用 db query 对本地 DuckDB 前复权日线执行 SQL，结果以 JSON 格式化输出。

   hithink-finance db query 
     --sql "SELECT * FROM v_daily_qfq LIMIT 10" 
     --format json

   复制

6. 6源码方式验证

   仅在参与仓库开发或 npm 暂不可用时使用：进入 CLI 目录安装依赖、构建并检查能力与环境。

   cd hithink-finance-cli
   npm ci --ignore-scripts
   npm run build
   node dist/cli/main.js capabilities --format json
   node dist/cli/main.js doctor --format json

   复制

关键配置

如何确认成功

安装 Skill 后重新打开会话提问行情类问题能返回数据；或执行 CLI 的 doctor 命令输出正常即成功。

常见问题

注意事项

• 手工复制 Skill 时必须保留完整目录（含 references/），不要只复制 SKILL.md。
• 同花顺AI客户端尚未发布接入本项目数据源的版本，当前请使用 API、MCP、CLI、Python SDK 和 Agent Skill 接入。
• 输出需注明数据源、时间范围、报告期和复权口径，金融分析结果需注明“非投资建议”。
• 真实数据不可用时明确说明原因，不要用模拟数据或静态示例冒充。