前言¶
在 IDE 或對話式 Agent 裏做 A 股研究，常見做法是臨時拼 curl、翻零散接口文檔，或在 CLI、MCP、HTTP 之間來回切換。標的要先消歧成帶市場後綴的代碼，財報和估值還要對齊報告期與口徑；一旦涉及全市場或長窗口，結果體量又容易把上下文撐爆。下面介紹 SkillHub 上的「同花順金融數據」Skill（座標 @org-6602ci5n/hithink-finance）：它把同花順金融數據服務的任務路由、憑據約定和 REST / MCP / CLI 契約收進一份 SKILL.md，讓 Agent 按場景選路，而不是每次從零摸索。
這是什麼¶
「同花順金融數據」是同花順金融數據服務的統一 Agent 入口。發佈方爲浙江同花順網絡科技有限公司，在 SkillHub 上歸類爲 professional，當前版本 1.1.2，標籤標明 requires_api_key=true（遠端取數需要 API Key）。Skill 簡介寫明：通過同花順金融數據服務查詢、分析、同步或導出 A 股、指數、基金、期貨、期權與本地 DuckDB 數據，並用於選擇和配置 CLI、MCP、REST API 以及執行金融取數任務。官方 GitHub 倉庫爲 HiThink-Tech/Financial-API；執行任務時優先讀取 Skill 內置文檔，無需再克隆倉庫。
SkillHub 頁面：https://www.skillhub.cn/skills/org-6602ci5n/hithink-finance；API 座標頁：https://api.skillhub.cn/org-6602ci5n/hithink-finance。
核心功能¶
Skill 按用戶意圖在三種主路徑之間路由，並內置各路徑的業務契約說明。
| 場景 | 首選 | 說明 |
|---|---|---|
| 終端、Agent 自動化、遠端與本地 DuckDB 一體化 | CLI | 包名 @hithink-tech/hithink-finance-cli，覆蓋 symbol、market、financials、valuation、index、fund、special、futures、options 及 data / db 等命令域 |
| 當前 Chat/IDE 已連接託管 MCP 服務 | MCP | 按業務域讀取 MCP 路由文檔，並以當前 tools/list 與 schema 爲準 |
| HTTP、自定義語言或服務端集成 | REST API | Base URL https://fuyao.aicubes.cn，公開數據端點爲 GET，認證頭 X-api-key |
數據與任務層面，Skill 文檔覆蓋的能力包括：A 股行情、財報、最新估值、集合競價、指數/板塊/特色數據、公募基金、公開期貨期權資料與行情，以及本地 DuckDB 同步與導出。執行規則強調：名稱或代碼不唯一時先搜索消歧爲 thscode；A 股歷史行情未指定復權時默認 forward（前復權）；全市場或長窗口結果應落盤並只回報路徑與行數摘要；成功驗收以業務信封爲準（REST/MCP 的 code=0，CLI 退出碼 0 且 JSON ok=true）。
文檔同時標明能力邊界：分鐘 K/tick/Level-2、港股/美股、基金申贖與訂單執行等不在當前公開接入範圍內；部分「端內專用」能力僅在同花順 AI 客戶端提供，不作爲公開 REST、MCP、CLI 或 Python SDK 入口。
安裝與啓用¶
在 SkillHub 安裝 Skill¶
官方頁面要求按 SkillHub 安裝說明安裝本 Skill。先確認是否已有 skillhub CLI：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝或僅 CLI（見 https://skillhub.cn/install/skillhub.md）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。
skillhub install @org-6602ci5n/hithink-finance --dir <skills 目錄>
常用路徑示例（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後，Agent 在新會話中加載該目錄下的 SKILL.md 即可按內置 references 執行任務。
配置 API Key（與接入方式無關）¶
遠端接入共用同一 API Key，在管理後臺獲取：https://fuyao.aicubes.cn/admin/（須保留末尾 /，避免掃碼登錄態因 HTTP 降級丟失）。推薦檢查順序：
- 環境變量
HITHINK_FINANCE_API_KEY - 用戶級
credentials.env（Linux：${XDG_CONFIG_HOME:-~/.config}/hithink-finance/credentials.env，文件內一行HITHINK_FINANCE_API_KEY=...） - 兼容已有
FUYAO_TOKEN、API_KEY或 CLI 系統憑據
配置 API Key 不要求先安裝 CLI；選定 CLI 路徑且需要同步系統憑據時，可通過 stdin 登錄：
printf '%s' "$HITHINK_FINANCE_API_KEY" | \
hithink-finance auth login --api-key-stdin --format json
可選：安裝 hithink-finance CLI¶
當任務適合 CLI（含本地 DuckDB）且 PATH 中尚無命令時，Skill 約定可先告知用戶再安裝。要求 Node.js >=22.12.0 與可用 npm：
npm install -g @hithink-tech/hithink-finance-cli
hithink-finance version --format json
安裝後可用 hithink-finance skills status --format json 與 capabilities --format json 覈對命令與內置 Skill 來源，再執行具體取數。
典型用法¶
下面步驟來自 Skill 內置契約，可按環境復現。
1. REST：搜索標的並驗證認證
用最小請求確認 Key 與搜索接口可用（將 <API_KEY> 替換爲真實 Key，勿寫入倉庫或日誌）：
curl 'https://fuyao.aicubes.cn/api/meta/tickers/search?q=600519&limit=1' \
-H 'X-api-key: <API_KEY>'
成功條件爲 HTTP 200 且響應體 code == 0；標的代碼使用完整 thscode（例如 600519.SH），不要猜測交易所後綴。
2. CLI：檢查環境與內置能力
hithink-finance version --format json
hithink-finance auth status --format json
hithink-finance skills status --format json
hithink-finance capabilities --format json
確定使用 CLI 完成金融任務時，應以上述 capabilities 與命令 --help 爲準，而不是僅閱讀 Skill 總覽。
3. Agent 側的自然語言任務
向 Agent 描述資產類別、時間窗口、新鮮度與輸出規模即可，例如「查詢某公司最近四個季度的利潤表指標並落盤 CSV」。Skill 要求 Agent：缺失信息會顯著改變結果時才簡短確認；優先本地 DuckDB 中足夠新的歷史 OHLCV；遠端失敗時報告階段與脫敏錯誤，不用靜態示例冒充真實數據。
適用場景與注意¶
適合誰
- 在 Cursor、Claude Code、Codex 等支持 Skills 的客戶端裏，需要穩定對接同花順 A 股及相關市場的研發、量化或數據分析 Agent。
- 需要在一次對話裏完成「選 REST / MCP / CLI → 讀契約 → 配置 Key → 取數/同步」的團隊，希望減少手寫膠水代碼。
限制與坑
- 必須自備 API Key；Skill 不會用全市場下載代替認證校驗。
- 管理後臺 URL 務必使用帶尾斜槓的 HTTPS 地址；掃碼登錄依賴可見瀏覽器窗口，自動化「已打開」不等於用戶能看到二維碼。
- Key 不得進入命令參數、項目文件或 Git；聊天裏直接粘貼 Key 時，平臺可能保留消息記錄。
- SkillHub 安裝與 GitHub 上
npx skills update hithink-finance的更新路徑不同；從 SkillHub 安裝時，內置文檔以當前安裝包爲準。 - 公開接口與端內客戶端能力有明確分界，命中端內能力時應改走客戶端入口，而非強行調用公開 API。
結尾¶
「同花順金融數據」Skill 把同花順金融數據服務的接入選擇、憑據規則和業務契約收斂到 Agent 可讀的一份文檔裏，適合作爲 A 股及相關品種取數、同步與分析時的默認 playbook。安裝與詳情見 SkillHub：https://www.skillhub.cn/skills/org-6602ci5n/hithink-finance，座標頁：https://api.skillhub.cn/org-6602ci5n/hithink-finance。
