前言¶
做 A 股盘面分析或量化脚本时，龙虎榜是常用的公开数据源：需要按交易日拉全市场上榜列表，有时还要追到单只股票的历史记录，并看到买入前五、卖出前五营业部席位。自己从交易所披露页整理，或零散爬第三方页面，维护成本高，也不适合直接交给 Coding Agent 按自然语言调用。
下面介绍 SkillHub 社区 Skill「A股龙虎榜市场数据 API接口」（坐标 @user_3391caa4/lhb-api）。它把 HTTP 接口约定、字段说明和 Python 客户端写进 SKILL.md，Agent 可按文档发起 Bearer 鉴权请求，或用包内 client.py 查询当日榜单、个股历史与账户配额。
这是什么¶
这是一份面向大模型 Agent 的 专业版（professional） Skill，发布者为 user_3391caa4，来源为社区（community）。当前 SkillHub 登记版本为 1.0.3（Skill 主页曾显示 v1.0.2，以检索接口返回为准）。
Skill 包体很小：除 SKILL.md 外附带 client.py（LHBClient）。数据侧说明为交易所公开披露的同源数据，时间跨度 2022 年至今，文档称总量 70,000+ 条；榜单含日榜与三日榜，并带营业部买 5 / 卖 5 明细。SkillHub 标签 requires_api_key=true，使用前需自备 API Key。
官方入口：
- Skill 主页：https://www.skillhub.cn/skills/user_3391caa4/lhb-api
- 资源主页：https://api.skillhub.cn/user_3391caa4/lhb-api
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 client.py，可按路径直接核对。
数据字段与榜单类型¶
单条记录常见字段包括：股票代码、名称、收盘价、涨跌幅、成交额、净买入、买入前五合计、卖出前五合计、上榜原因；entry_type 为 daily（日榜）或 3day（三日榜）。daily 接口返回的 brokers.buy / brokers.sell 为前五席位，含排名、名称、买入、卖出、净额。
HTTP 接口¶
基址在文档示例中为 http://fffy520.gicp.net:8003；client.py 默认 base_url 为 http://fffy520.gicp.net:19968。若请求失败，可在初始化客户端时显式传入与文档一致的 base_url，或向 Key 提供方确认当前服务地址。
| 接口 | 方法 | 作用 |
|---|---|---|
/api/lhb/daily |
GET | 指定交易日或最新交易日的完整龙虎榜（含买 5 卖 5） |
/api/lhb/history |
GET | 按股票代码查询历史上榜记录（文档说明不含营业部明细） |
/api/lhb/account |
GET | 套餐、日配额、剩余次数、到期时间（文档称不消耗配额） |
鉴权方式为请求头：
Authorization: Bearer 你的Key
配额与限制（文档约定）¶
- 首次使用自动激活；文档写明赠送 7 天免费试用（10 次/天）。
- 月/季/年卡：50 次/天；长期套餐文档写为不限量。
- 非长期套餐下，
history最多 30 条；长期不限。 - 频率：30 次/秒/Key；日配额每天 00:00 重置。
daily接口 60 分钟缓存，重复请求不重复扣配额。- 常见 HTTP：
401无效 Key，403Key 禁用或当日配额用尽，429过于频繁。
套餐续费说明链接见 Skill 文档：http://fffy520.gicp.net:8003/renew。
安装与启用¶
SkillHub 页面给出的通用安装方式是：让 AI 阅读安装说明并安装指定坐标。可将下面提示词发给 Cursor、Claude Code 等支持 Skill 的客户端：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3391caa4/lhb-api`。
说明：抓取时 https://skillhub.cn/install/skillhub.md 曾返回 500，若链接暂时不可用，可改从 SkillHub 下载包解压到本地 Skill 目录。公开下载端点为：
curl -L "https://api.skillhub.cn/api/v1/download?slug=lhb-api" -o lhb-api.zip
unzip lhb-api.zip
解压后应得到 SKILL.md 与 client.py。在 Agent 工作区启用该 Skill 后，将 API Key 配置到环境变量（与 client.py 一致）：
export LHB_API_KEY=你的Key
Cursor / Codex CLI / Claude Code 的具体 Skill 目录名因客户端版本而异，按各产品文档把上述文件放到对应 skills 路径即可；未在官方页面单独写明差异的部分，此处不展开。
典型用法¶
curl 查当日榜单¶
不传 date 时文档示例为取最新交易日；传 date=YYYY-MM-DD 为指定日。
curl "http://fffy520.gicp.net:8003/api/lhb/daily" \
-H "Authorization: Bearer 你的Key"
curl "http://fffy520.gicp.net:8003/api/lhb/daily?date=2026-05-08" \
-H "Authorization: Bearer 你的Key"
成功时 JSON 含 code、remaining（剩余配额）与 data 数组。
curl 查个股历史与账户¶
curl "http://fffy520.gicp.net:8003/api/lhb/history?code=002031" \
-H "Authorization: Bearer 你的Key"
curl "http://fffy520.gicp.net:8003/api/lhb/account" \
-H "Authorization: Bearer 你的Key"
Python 客户端¶
Skill 包内 client.py 提供 LHBClient，依赖标准库，无额外 pip 包：
from client import LHBClient
client = LHBClient("你的APIKey") # 或 LHBClient(key, base_url="http://fffy520.gicp.net:8003")
latest = client.daily()
one_day = client.daily("2026-05-08")
history = client.history("002031")
account = client.account()
命令行（需已设置 LHB_API_KEY）：
python client.py daily
python client.py daily 2026-05-08
python client.py history 002031
python client.py account
在 Agent 对话中，可直接描述需求（例如「查 2026-05-08 龙虎榜净买入前五的股票并列出买席」），由模型按 SKILL.md 选择 daily / history 并解析 brokers 字段。
适用场景与注意¶
适合谁
- 需要在对话或脚本里快速拉龙虎榜、看营业部席位，又不想每次手写 curl 的开发者。
- 做选股因子、游资席位跟踪、个股历史上榜频率统计时，可把 Skill 作为 Agent 的数据说明层。
使用注意
- 必须自备 Key；SkillHub 元数据标记
requires_api_key=true。 - 文档写开盘日 18 点更新、数据范围自 2022-01-04 起；实盘前请用
account确认配额与到期时间。 history与daily返回字段深度不同，做席位分析应优先daily。- 社区 Skill，服务域名与端口以包内文档为准；
client.py与SKILL.md默认端口不一致时，以实际可用的base_url为准。 - SkillHub 统计（检索接口）：下载约 1259 次，分类 professional；评分字段与站内展示可能与线索中的数字不一致，以 SkillHub 页面为准。
结尾¶
「A股龙虎榜市场数据 API接口」把龙虎榜 REST 约定、字段表和 LHBClient 收进一份 Agent Skill，适合在 Cursor 等环境里用自然语言驱动查榜、查历史、看配额。安装坐标为 @user_3391caa4/lhb-api，资源与说明见 https://api.skillhub.cn/user_3391caa4/lhb-api ，社区页见 https://www.skillhub.cn/skills/user_3391caa4/lhb-api 。
