前言¶
做 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 。
