前言¶

做量化腳本、研報輔助或投研問答時，常見做法是手寫 REST 客戶端、維護指標字典，或在對話裏貼 CSV。數據口徑和公告檢索往往還要另接一套服務。下面介紹 SkillHub 上的 ifind-finance-data2：把同花順 iFinD 金融數據 MCP 能力封裝成通用 Skill，讓 Cursor、Claude Code 等 Agent 在對話裏按自然語言發起股票、基金、宏觀、公告等查詢。

這是什麼¶

ifind-finance-data2（座標 @user_c163d6d4/ifind-finance-data2）是社區來源（community）、分類爲 professional 的 Agent Skill。SkillHub 當前發佈版本爲 1.0.0；頁面標註 requires_api_key=true，使用前需配置 iFinD MCP 密鑰。

Skill 自述能力：同花順金融數據查詢，覆蓋股票、基金、宏觀經濟、行業經濟、新聞公告、債券、港美股及指數板塊，並支持智能選股、選基、宏觀行業經濟指標查詢、金融公告資訊搜索等。技能文檔中的產品主頁爲 https://www.51ifind.com。底層通過 call.py / call-node.js 調用同花順金融數據 MCP 接口，而不是讓模型憑空編造行情。

核心功能¶

按 Skill 文檔，能力按 server_type 劃分，Agent 通過 call(server_type, tool_name, params) 發起請求。

1. 股票（stock）：智能選股 search_stocks、摘要與行情 get_stock_info、財務 get_stock_financials、股東、風險指標、ESG、重大事件等。
2. 基金（fund）：選基搜索、資料、行情業績、持倉、持有人、基金公司信息等。
3. 宏觀與行業指標（edb）：search_edb 搜指標，get_edb_data 取數；適合「先搜再查」。
4. 新聞公告（news）：search_news、search_notice 語義檢索；search_trending_news 查熱點，支持時間範圍與條數。
5. 債券（bond）：基本信息、行情估值、發債主體財務、可轉債等特殊指標。
6. 港美股（global_stock）：選股、基本資料、行情、財務、公告事件；選股需帶 market（港股/美股）。
7. 指數板塊（index）：指數行情與板塊成分等指標。

文檔建議：query 類參數可組合多主體、多指標，但主體與指標數量宜控制在 5 個以內；板塊類查詢需注意行業或時間範圍過大導致結果截斷。

安裝與啓用¶

從 SkillHub 安裝¶

官方 Skill 頁給出的安裝方式是：讓 AI 按 SkillHub 安裝說明文檔操作，並安裝指定座標。可將下面提示詞發給 Agent：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_c163d6d4/ifind-finance-data2`。

說明：skillhub.md 安裝頁在抓取時返回 500，具體 CLI 子命令以該文檔當前內容爲準；座標與版本以 SkillHub 爲準。

密鑰與環境¶

首次使用前需配置密鑰。Skill 文檔要求：

• 在技能目錄的 mcp_config.json 中寫入有效 auth_token（示例佔位爲「您的 iFinD-MCP 密鑰」）。
• 若無有效密鑰，需到 MCP 官網 → 個人中心 → 密鑰 獲取並寫入；文檔「首次使用」一節也提到 config.json，與注意事項中的 mcp_config.json 並存，實際取數腳本以 mcp_config.json 爲準（Node 與 Python 方案共用）。
• 運行環境需具備 Node.js 或 Python 之一；Python 方案需安裝 requests。未指定語言且環境不確定時，文檔推薦優先用 Node.js（call-node.js，無額外 npm 依賴）。

併發與權益¶

文檔默認按免費用戶處理：每秒最多 2 個併發請求；個人版正式 5、企業版正式 10。不確定權益時可引導用戶在 MCP 官網查看。

典型用法¶

安裝並寫好 auth_token 後，Agent 在技能目錄內調用封裝函數即可；請求地址與鑑權由腳本內置，無需自行拼 URL。

Node.js（推薦在無 Python 或環境不明時使用）：

const { call } = require('./call-node.js');

(async () => {
  const result = await call("stock", "search_stocks", {
    query: "電子行業市值排名前20的股票"
  });
  console.log(JSON.stringify(result, null, 2));
})();

Python：

from call import call

result = call("stock", "search_stocks", {"query": "電子行業市值排名前20的股票"})
print(result)

返回值結構包含 ok、status_code，成功時有 data，失敗時有 error；調用方應檢查 ok。

宏觀指標可先搜後查：

call("edb", "search_edb", {"query": "新能源汽車產量相關指標"})
call("edb", "get_edb_data", {"query": "新能源汽車產量當月值（202301-202506）"})

公告檢索示例（時間格式 YYYY-MM-DD）：

call("news", "search_notice", {
    "query": "光迅科技2024年度報告 光模塊技術",
    "time_start": "2025-01-01",
    "time_end": "2026-01-01",
    "size": 5
})

當工具名報錯或與服務端不一致時，可備用 list_tools(server_type) 拉取當前在線工具列表；正常情況應優先使用文檔中的 tool_name 直接 call。

適用場景與注意¶

適合誰

• 已在 Cursor / 支持 Skill 的編碼 Agent 裏做投研、寫回測腳本、整理公告要點，希望統一走 iFinD 口徑的開發者。
• 需要在一個對話裏串聯選股、財報指標、宏觀 EDB、新聞公告檢索，而不想爲每類數據單獨寫 HTTP 客戶端的團隊。

限制與注意

• 必須自備 iFinD MCP 密鑰；SkillHub 標籤已標明 requires_api_key=true。
• 數據與合規邊界以同花順 iFinD / MCP 服務條款爲準；Skill 爲社區發佈（發佈者 user_c163d6d4），與官方產品支持渠道可能不同。
• 遵守文檔中的併發上限；熱點新聞類查詢條件過多可能無結果，可放寬條件或改用資訊搜索。
• 文檔要求單次任務結束後清理 Agent 臨時生成的取數腳本，避免目錄裏殘留重複邏輯。

SkillHub 頁面統計（以抓取爲準）：評分 100000，下載 3072 次；可作爲社區專業類金融 Skill 的參考熱度，不代表服務質量承諾。

結尾¶

經過上面的步驟，ifind-finance-data2 的價值可以概括爲：把 iFinD 多品類金融數據 MCP 收斂成 Agent 可讀的 Skill 約定（server_type + 自然語言 query），降低在對話裏查行情、財報、宏觀與公告的集成成本。官方 Skill 地址：https://api.skillhub.cn/user_c163d6d4/ifind-finance-data2；SkillHub 展示頁：https://www.skillhub.cn/skills/user_c163d6d4/ifind-finance-data2。