前言¶

做量化脚本、研报辅助或投研问答时，常见做法是手写 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。