前言¶
做量化脚本、投研助手或金融问答时，常见做法是各自对接交易所、券商或数据商的 HTTP 接口：标的代码体系不统一，实时价、K 线、盘口、基本面字段分散在不同文档里，Agent 也很难在对话里稳定「查到数」。下面介绍 SkillHub 上的 TickDB Real-time Market Data API（坐标 @user_dae4fbf4/tickdb-market-data-api，当前版本 1.0.8）：把 TickDB 的统一实时行情能力封装成 Agent Skill，在用户谈到价格、行情、K 线等话题时由模型按 Skill 指引去查数据，而不是临时编造数值。
这是什么¶
TickDB Real-time Market Data API 是社区来源（community）、分类为 professional 的 Skill，由发布者 user_dae4fbf4 维护。定位一句话：通过 TickDB 的统一实时行情数据 API，覆盖多资产类别的查询能力，并写入 Skill 的触发与使用说明，供 Cursor、Claude Code 等支持 Skills 的客户端加载。
官方 Skill 页与 API 入口：
- SkillHub：https://www.skillhub.cn/skills/user_dae4fbf4/tickdb-market-data-api
- https://api.skillhub.cn/user_dae4fbf4/tickdb-market-data-api
Skill 标注 requires_api_key=true，使用前需要自行准备 TickDB 侧 API Key（具体申请方式以 TickDB 官方文档为准；Skill 页未展开环境变量名，安装后请阅读包内 SKILL.md）。
核心功能¶
以下能力均来自 Skill 官方简介，未在页面单独列接口清单时，不展开未核实的 endpoint 名称。
- 资产覆盖：外汇、贵金属、指数、美股、港股、A 股、加密货币。
- 行情与衍生数据：实时行情、K 线、订单簿（买卖盘）、资金流向、股票基本面（如市值、市盈率等表述场景）。
- 对话触发：当用户提及价格、行情、K 线、买卖盘、市值、市盈率、资金流向、分时走势、交易日历等金融数据相关话题时，Agent 应启用本 Skill 并按其中说明调用 TickDB API。
SkillHub 侧数据（抓取时）：评分 100000，下载 1093，安装 30。
安装与启用¶
安装流程遵循 SkillHub 通用说明（https://skillhub.cn/install/skillhub.md）。也可将下面提示词发给 AI，由其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_dae4fbf4/tickdb-market-data-api`。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可用官方脚本（完整安装含默认 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、安装本 Skill 到当前 Agent 的 skills 目录¶
必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。
skillhub install @user_dae4fbf4/tickdb-market-data-api --dir <skills 目录>
常用路径（来自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按客户端要求重启或刷新 Agent，并配置 TickDB API Key（见包内 SKILL.md）。
典型用法¶
官方页面未提供独立 curl 示例；典型用法是对话驱动，由 Skill 约束 Agent 在相关意图下查询 TickDB，而不是手写全部分支。
- 完成安装与 API Key 配置。
- 在对话中直接提问，例如：「贵州茅台最新价和今日 K 线」「美元指数实时报价」「某美股订单簿前五档」「某标的市盈率与市值」。
- Agent 识别到行情、K 线、买卖盘、基本面、交易日历等关键词后，按 Skill 说明选择合适的数据类型并向 TickDB 发起查询，将结果整理成自然语言或表格返回。
若需确认具体参数（标的代码格式、周期、市场枚举等），以安装后 Skill 目录中的 SKILL.md 及 TickDB API 文档为准。
适用场景与注意¶
适合谁
- 需要在 Agent 对话里查多市场实时/基本面数据，又不想每次让模型「凭记忆」回答价格的开发者或研究员。
- 已使用 SkillHub 管理 Skills，希望用统一坐标
@user_dae4fbf4/tickdb-market-data-api分发到 Cursor、Claude Code 等环境。
限制与注意
- 依赖外网 TickDB API 与有效 API Key；未配置 Key 时 Skill 无法完成真实查询。
- 数据范围、频率、合规使用以 TickDB 服务条款为准；本 Skill 不负责数据授权与实盘交易执行。
- 社区 Skill，升级时关注 SkillHub 上的版本号（当前 1.0.8），必要时重新
skillhub install或按 SkillHub 文档更新。
结尾¶
TickDB Real-time Market Data API 把多市场实时行情、K 线、盘口、资金流向与基本面查询收敛到一套 TickDB API，并通过 Skill 的触发条件接到日常对话里。若你正在搭建金融类 Agent，可从 SkillHub 安装页与 API 入口入手：https://www.skillhub.cn/skills/user_dae4fbf4/tickdb-market-data-api 。
