# 同花顺 iFinD MCP 文档（全文）
> 由文档源自动生成，共 29 篇。索引见 https://mcp.51ifind.com/llms.txt
---
# 前置准备
> 文档路径: https://mcp.51ifind.com/#/documents/guide-prepare
> 分组: 前置准备
## 前置准备
* 要顺利使用iFinD-MCP服务，您需要以下前置准备
* 先阅读本说明，再选择您偏好的AI应用相关指南进行配置
* AI应用配置指南页默认您已经做好以下准备
### 开通MCP服务
* 通过本页面右上角登录，支持同花顺APP账号或iFinD账号，新用户登录后直接开通试用
* 在 `登录 -> 个人中心 -> 用量` 路径查看当前用户类型及用量权益
### MCP密钥
* `个人中心 -> 密钥` 获取用户密钥（以下统称 `MCP密钥`）
* 该密钥同时支持MCP服务与本页面Agent-SKILL
### 应用MCP支持
* 确认您的AI应用是否支持MCP协议
* 常见的直接支持MCP协议的AI应用客户端包括 `Trae`、`Cursor`、`Workbuddy`、`Codex` 等
* 更多第三方AI应用是否支持MCP协议需您自行确认
* 若AI应用支持MCP，建议使用下文MCP服务配置方案（如 `Trae`）
* 若AI应用不支持MCP，建议使用下文Agent-SKILL配置方案（如 `OpenClaw`）
### MCP服务与配置
* `个人中心 -> MCP` 页面列举了多个MCP服务配置
* 根据您的数据范围需求选择MCP服务，如 `A股数据`
* 点击 `生成配置`，即可复制该MCP服务的配置文本，应用于本页面相关MCP配置环境（以下统称为 `MCP配置`）
* 注: 生成配置弹窗中可切换要使用的MCP密钥，页面会记住您上次的选择
### Agent-SKILL安装包
* `个人中心 -> SKILL` 页面，点击下载，获取SKILL安装包
* 适用于本页面 `Agent-SKILL` 相关软件配置指南
---
# 一键配置
> 文档路径: https://mcp.51ifind.com/#/documents/guide-one-click
> 分组: 一键配置
import OneClickStartButton from '@/components/docs/OneClickStartButton'
## 一键配置
* 三步接入 iFinD MCP&SKILL，在你的 Agent 里直接查数、做研究
* 无需手动下载安装包或编辑配置文件，Agent 会按指引自动完成 SKILL 安装
* 开始前请先完成 [前置准备](#/documents/guide-prepare) 中的登录与开通
### 第一步：复制安装提示词
* 复制下方安装提示词，Agent 会按指引自动完成 SKILL 安装
```text
阅读 https://mcp.51ifind.com/gwstatic/static/ds_web/ifind-mcp-web/skills/SKILL_INSTALL_GUIDE.md，完成SKILL安装
```
### 第二步：发给你的 Agent
* 将安装提示词粘贴到 Agent 对话框发送即可
* 支持的环境包括 `AiFind`、`WorkBuddy`、`Cursor`、`Claude Code`、`ChatGPT`
* 其他 Agent 若支持读取网页并执行安装指令，也可按相同方式尝试
### 第三步：复制 MCP 密钥
* 在 `个人中心 -> 密钥` 复制 `MCP密钥`，Agent 提示填写时粘贴
* 也可点击上方按钮打开一键开始弹窗，登录后在弹窗中直接复制密钥
* 还没有密钥时，在 `个人中心 -> 密钥` 创建一个
MCP密钥等同账号权限，请勿外传。
### 接入后试试这些问句
* 安装完成后，可在 Agent 中直接提问，例如：
```text
使用IFIND MCP，解读宁德时代最新一期财报，指出营收、利润、现金流的变化与主要风险点
```
* 更多问句可在一键开始弹窗的「接入后试试这些问句」中一键复制，或在首页「热门场景案例」中查看
若一键安装未成功，可参考下方「Agent-Skill安装案例」或「MCP安装案例」中对应应用的指南手动配置。
---
# 常见问题
> 文档路径: https://mcp.51ifind.com/#/documents/guide-faq
> 分组: 常见问题
import ProductFaq from '@/components/product/ProductFaq'
## 常见问题
使用 iFinD MCP 过程中常见问题解答
---
# OpenClaw
> 文档路径: https://mcp.51ifind.com/#/documents/guide-agent-skill-openclaw
> 分组: Agent-Skill安装案例
## OpenClaw Skill 配置指南
鉴于近期 **OpenClaw** 智能体用户量激增，为解决其暂不支持 **MCP 生态** 的问题，我们特此提供 **Skill 解决方案**。
### 环境配置
请确保您的本地环境已满足以下要求：
**Node.js 环境** 或 **Python 环境** 已安装。
> *注：Node.js 是安装 OpenClaw 的前置条件。若您能成功安装并启动 OpenClaw，即表示环境已就绪。*
---
### 配置步骤
#### ① 获取 Skill 安装包
1.下载SKILL安装包
2. 将解压后的 `ifind-finance-data` 文件夹保存至您的本地路径。
- 本案例以路径 `E:\ifind-finance-data\` 为例。
#### ② 查询 Skills 目录
启动 **OpenClaw**，并通过对话询问其技能存放目录：
> **提示语**：“你的 agent-skills 技能存放目录有哪些？”
#### ③ 复制文件夹至技能目录
要求 OpenClaw 将您本地解压的文件夹（如 `E:\ifind-finance-data\`）**完整复制**到其 skills 目录下。
> **提示语**：“我在 `E:\ifind-finance-data\` 文件夹下面放置了一个 skill，请将整个文件夹复制到你的 skill 路径下面。”
> *（注：实际操作时，请将路径替换为您本地的实际解压保存位置）*
#### ④ 配置 MCP 密钥
在聊天窗口发送您的 **MCP 密钥**，并指令其写入配置文件：
> **提示语**：“帮我将密钥配置到该技能的 `mcp_config.json`，我的密钥是：`{粘贴您的 MCP 密钥}`”
**特别提示**：
虽然 AI 自动写入密钥非常便捷，但存在小概率的字符错误。若您遇到 **401 密钥报错**，请务必：
1. 检查配置文件内容。
2. 确认 AI 写入时是否错漏字符。
3. 如有错误，请重新发送密钥，并要求 AI **逐字校对**后再次写入。
**如何获取密钥？**
MCP 密钥即您在 **iFinD 终端** “一键复制”内容中，`Authorization` 字段对应的那段长代码（或在开通试用界面中直接选择"MCP密钥"）。
#### ⑤ 启动测试
完成配置后，启动 Skill 并进行提问测试。
> **注**：配置成功后，后续使用无需重复输入密钥。
---
# Qclaw
> 文档路径: https://mcp.51ifind.com/#/documents/guide-agent-skill-qclaw
> 分组: Agent-Skill安装案例
## Qclaw 使用指南
## 产品简介
**Qclaw**是腾讯基于开源框架 **OpenClaw** 推出的产品化智能体助手。其核心优势在于**零门槛本地部署**与**微信深度集成**，用户无需配置复杂的环境或输入命令行，即可通过个人微信远程下达指令，操控电脑完成各类任务。
> **注意**：目前部分高级功能或内测资格可能需要在腾讯产品官网进行申请。
- **官网地址**：[https://qclaw.qq.com/](https://qclaw.qq.com/)
- **前置准备**：
1. 参考本页面 `前置准备`
2. 在 `SKILL` 页面下载安装包
3. 解压至本地目录
### 环境配置
请确保您的本地环境已满足以下要求：
**Node.js 环境** 或 **Python 环境** 已安装。
---
## 快速上手步骤
### 1. 启动与场景选择
安装并打开 Qclaw 客户端。点击 **Skill** 按钮进入会话场景，亦可直接开始对话。
### 2. 配置技能路径
告知 AI 您刚才**解压后的本地文件夹绝对路径**，并指令其将该路径复制到系统的 `skill` 目录中。
### 3. 写入 MCP 密钥
在聊天框中输入从 iFinD 终端一键复制的 **MCP 密钥**（请选择“仅密钥”模式），并要求 AI 自动完成配置。
> ** 故障排查提示**
> 虽然 AI 自动写入密钥非常便捷，但存在小概率的字符错误风险。
> - 若遇到 **401 密钥报错**，请优先检查配置文件。
> - 确认 AI 写入时是否出现字符错漏。
> - 如有错误，请重新发送密钥，并明确要求 AI **逐字校对**后再次写入。
### 4. 模型配置（可选）
如果您拥有外部大模型服务 API，可在此步骤进行自定义模型配置；否则软件将默认使用内置模型。
### 5. 技能管理验证
点击左下角 **设置** 图标，进入 **技能管理** 页面，确认相关技能开关已处于 **启用** 状态。
*(注：此处原图序号重复，请参照实际界面操作)*
### 6. 功能验证
尝试提出一个具体的**金融数据问题**，以验证技能是否正常工作及数据返回是否准确。
### 7. 微信互联体验
Qclaw 支持在 **个人微信的客服消息页面** 直接与智能体交互，实现真正的移动端远程操控。
> **说明**：微信连通功能需参考腾讯官网教程，完成 Qclaw 与微信账号的绑定配置后方可使用。
---
# 阿里云百炼
> 文档路径: https://mcp.51ifind.com/#/documents/guide-ai-bailian
> 分组: MCP安装案例
## 阿里云百炼
- 本页面分享在 **阿里云百炼平台** 使用 同花顺 MCP
### 访问阿里云百炼平台 MCP 广场并开通功能
[阿里云百炼MCP广场](https://bailian.console.aliyun.com/cn-beijing/?spm=5176.29597918.J_SEsSjsNv72yRuRFS2VknO.2.11097b086AJNoZ&tab=app#/mcp-market)
### ①登录阿里云百炼，选择应用开发-MCP管理-创建MCP服务（脚本部署）
百炼官网：https://bailian.console.aliyun.com/
### ②选择HTTP方式，在配置文本框粘贴MCP配置json
注：部分版本百炼平台要求将“streamablehttp”写为“streamableHttp”（H大写）
### ③配置完成后，在自定义服务找到同花顺MCP服务点击进入
### ④在工具列表中可以进行单个工具测试
### ⑤在左上角“创建应用”中创建自定义智能体
### ⑥在智能体中配置同花顺MCP服务，对话后AI即可按需获取相应数据
- 根据个人个性化要求加入系统提示词
- 左侧栏浏览工具列表说明以调试AI工具选择
- 基础模型建议选择性能较强且支持工具调用的模型（如：qwen-max、deepseek-v3.1等）
---
# 飞书Aily
> 文档路径: https://mcp.51ifind.com/#/documents/guide-feishu-aily
> 分组: MCP安装案例
## 飞书Aily
本文档介绍如何在`飞书Aily`中使用ifind-mcp数据服务
写在最前：
- 由于当前版本`飞书Aily`暂不支持自定义MCP的鉴权方式，因此需采用SKILL模式
- 由于`飞书Aily`采用云上传SKILL模式，LLM无写入权限，因此需自行配置密钥后压缩上传
- 本文档为专门针对”飞书Aily”，默认用户已阅读”前置准备”
### 1. MCP官网下载SKILL压缩包 `ifind-finance-data` ，解压后编辑 `mcp_config.json` 文件
### 2. MCP官网复制个人MCP密钥，粘贴到配置文件，替换`您的iFinD-MCP密钥`占位符
> 完成后保存文件并重新压缩 `ifind-finance-data.zip`
### 3. 打开飞书进入Aily
> 左侧栏选择飞书Aily，右上角点击创建SKILL-上传技能
### 4. 上传SKILL安装包后确认技能描述无误并保存
### 5. 在聊天中确认SKILL状态
> 切换AI聊天窗，输入斜杠"/"并在下拉菜单选定ifind-finance-data技能
> 输入"帮我检查该技能配置文件，查看是否存在密钥"
### 6. 提出金融数据问题测试可用性
> 输入问题测试取数、EDB、资讯工具是否有效。例如：
> 1. 同花顺最新收盘价
> 2. 六氟磷酸锂最新产量
> 3. 可控核聚变近期资讯
>
> 确认可以获取结果后即可正常使用。
---
# Cursor
> 文档路径: https://mcp.51ifind.com/#/documents/guide-client-cursor
> 分组: MCP安装案例
## Cursor
- 本页面介绍如何在 **Cursor** 中使用 同花顺 MCP
### ①访问官网并安装 Cursor
Cursor官方网站：[Cursor官网](https://cursor.com/cn)
### ②在客户端设置中找到 MCP 或工具界面，选择通过本地 json 配置 MCP
### ③粘贴带有您密钥的MCP配置json文本
### ④在MCP服务清单处即可看到工具列表及工具说明，此时与Agent对话即可自动调用
---
# Trae
> 文档路径: https://mcp.51ifind.com/#/documents/guide-client-trae
> 分组: MCP安装案例
## Trae
- 本页面介绍如何在 **Trae** 中使用 MCP 金融数据服务
- Trae为字节跳动开发，对标 **Claude-code** 的一款AI编译器，擅长支持复杂研究任务的规划
- 原生支持MCP，配置非常简便
官方下载链接：[Trae官网](https://www.trae.cn/sem?utm_source=360&utm_medium=360_sem&utm_campaign=48620092&utm_term=trae_sem_360_wc_pc_1_ocpc_pinp_hx_tongy_ymcs&account_id=3525181797&ad_platform_id=360_search_lead&new_user=1&a_keywordid=70137543197&ug_ad_level_3_id=11291660923&ug_ad_level_2_id=2348597167&ug_ad_level_1_id=2478908815&ug_device=pc&ug_semver=v1.0.0&qhclickid=3d1b9704a84b9eb9)
### ①在客户端设置找到MCP界面
### ②通过手动导入json配置MCP
### ③粘贴带有您密钥的MCP配置json文本（注：Trae不支持粘贴多个）
### ④获取MCP工具列表
### ⑤选择配置MCP工具的智能体并提出任务
### ⑥智能体自主调用工具并完成报告
---
# CherryStudio
> 文档路径: https://mcp.51ifind.com/#/documents/guide-client-cherrystudio
> 分组: MCP安装案例
## CherryStudio
### ①下载并安装CherryStudio
官网下载：[CherryStudio官网](https://www.cherry-ai.com/download)
官网MCP指南：[CherryStudio-MCP指南](https://docs.cherry-ai.com/advanced-basic/mcp)
#### 配置模型供应商并确认模型请求检测
### ②选择MCP服务器，从JSON导入
#### 注意：该界面右上角显示红色警告标志 ⚠ 代表缺乏必要环境配置，需先安装
### ③粘贴带有MCP密钥的配置信息
注意：cherrystudio不支持一次配置多个MCP服务，需手动拆分后多次粘贴
### ④启用MCP服务，服务界面可自定义名称，工具界面可查看具体工具信息
### ⑤返回首页并创建一助手
注意：
经测试，cherrystudio在Agent模式下对MCP的支持不稳定，经常出现无法发现工具或无法请求的情况，强烈建议选择助手模式（测试使用版本为Cherry-Studio-1.7.24-x64）
### ⑥编辑助手
### ⑦设置MCP服务器发现选项为手动
### ⑧返回助手界面，在聊天栏确认MCP服务配置无误，同时界面上方修改模型
建议使用支持工具调用的性能较强模型
### ⑨提问确认工具配置无误即可开始任务
---
# WorkBuddy
> 文档路径: https://mcp.51ifind.com/#/documents/guild-work-buddy
> 分组: MCP安装案例
## WorkBuddy
- 本页面介绍如何在 **WorkBuddy** 中使用 MCP 金融数据服务
- 官方下载链接：[WorkBuddy官网](https://www.codebuddy.cn/)
### ①进入workbuddy，选择 `技能 -> MCP服务器`
### ②点击 `配置` 进入配置界面
### ③在iFinD-MCP官网选择数据范围并生成配置文件
### ④粘贴到配置界面并保存，看到所选MCP服务已配置
### ⑤回到聊天界面，确认AI已经能够使用相关工具
---
# Qoder
> 文档路径: https://mcp.51ifind.com/#/documents/guide-qoder
> 分组: MCP安装案例
## Qoder 配置指南
本文档介绍如何在 `Qoder` 中配置并使用 MCP 数据服务。
### 1. 进入 MCP 服务设置
> 在右上角打开 Qoder 设置，并在左侧菜单中选择 MCP 服务。
### 2. 添加新的 MCP 服务
> 在设置面板中选择 `我的服务`，然后点击右上角的 `添加` 按钮。
### 3. 粘贴并保存配置信息
> 复制粘贴 MCP 官网生成的完整配置（Qoder 支持多个服务合并一次粘贴），随后点击关闭以保存设置。
### 4. 测试数据可用性
> 确认多个 MCP 服务均已成功启动后，在右上角切出 `AI侧栏`，通过提问来测试数据获取的可用性。
---
# OpenClaw
> 文档路径: https://mcp.51ifind.com/#/documents/guide-lobster-openclaw
> 分组: MCP安装案例
## 龙虾类客户端使用帮助
龙虾类客户端指2026年年初兴起的，以openclaw为首的同类智能体软件，其与过去第三方AI客户端的核心区别在于：
①接受外部触发信号来执行任务（如定时、应用API信号，而非仅通过人工提问触发）
②通过工具控制操作系统且权限极高
典型产品如：openclaw、copaw、kimiclaw、maxclaw等
## Openclaw
- **注意:** 本教程涉及对openclaw进行二次改造以适配MCP，如您不具备二次开发能力，建议使用本页面 `Agent-Skill -> OpenClaw` 方案
```text
重大风险提示：
Openclaw不是原生MCP生态，无法直接配置在openclaw中调用MCP工具，需要依赖外部插件或skill进行间接调用，鉴于openclaw权限等级高，且第三方插件或skill可能存在安全风险，此类插件或skill方案不唯一，我们强烈建议由贵司开发人员对插件或skill内容进行详细检验后再进行配置。
在本部分我们参考网络资料给出一种MCP通过skill方式链接的方案样例（以windows环境的mcporter技能为例），仅供参考不做推荐。
如您自主决定配置第三方skill或插件，由此引发的安全风险自负。
```
- 参考内容链接：[知乎参考文章](https://zhuanlan.zhihu.com/p/2003066270254396687)
### ①通过npm安装mcporter技能
在CMD执行 **npm install -g mcporter**
```cmd
npm install -g mcporter
```
（需要已安装Node.js、Git环境，相关工具安装方案成熟，可参考网络公开信息）
注意：
由于openclaw发布以来经历多个版本的名称更改，在安装过程中尽可能选择最新版本，如发现安装后系统目录名称不是openclaw，而是如clawdbot等旧版本名称，则相关插件方案可能失效，建议更换安装方法。
### ②通过openclaw聊天确认已配备该技能
### ③在/.openclaw/workspace/.config路径下创建mcporter.json
并将带有您密钥的完整MCP服务配置json信息写入该文件
### ④刷新openclaw并通过对话要求其启动mcporter技能
### ⑤输入金融问题即可测试工具可用性
备注：由于本方案openclaw依赖skill间接读取工具，而非自动注入系统提示词，因此每次新任务开始前，都需要提示它启动mcporter技能，才能有效识别工具
---
# Copaw
> 文档路径: https://mcp.51ifind.com/#/documents/guide-lobster-copaw
> 分组: MCP安装案例
## Copaw
Copaw是由阿里巴巴通义实验室开发的龙虾类智能体产品，该产品原生支持MCP生态
官网教程：https://copaw.agentscope.io/
### ①启动网页服务并找到MCP左侧栏菜单
### ②创建MCP客户端并直接粘贴完整的MCP服务配置json
注意：
Copaw支持同时配置多个MCP，您可以直接复制完整的MCP服务配置json
创建后确认多个客户端已经处于链接状态
③发起对话即可确认工具清单
---
# SKILL 安装引导
> 文档路径: https://mcp.51ifind.com/#/documents/skill-install-guide
> 分组: Agent-Skill安装案例
# 安装引导：ifind-finance-data 金融数据查询 SKILL
本页是给 IDE 内置 AI 助手（Cursor、Claude Code、Cline 等）自动安装 `ifind-finance-data` SKILL 的引导文档；
若需手动配置，请参考下方对应的 MCP / Agent-SKILL 安装案例。
> **你的任务**：按本文档的步骤，自动完成此 SKILL 技能包的下载、解压、配置和验证。
>
> **安装包下载地址**：
> ```
> {ZIP_URL}=https://s.thsi.cn/cd/ifind-java-ds-bff-web-container/ifind-mcp-web/skills/ifind-finance-data-1.5.0.zip
> ```
> **核心步骤**：确定 SKILL 目录 → 下载 ZIP → 解压（去版本号，目录名固定为 `ifind-finance-data`）→ 探测 Node/Python 环境 → 让用户提供密钥写入配置 → 运行自检脚本验证 → 报告结果。
>
> 严格按步骤执行。每步先执行再判断，不要跳过任何一步。若所有重试均失败，引导用户前往 iFinD MCP 官网使用指南（https://mcp.51ifind.com/#/docs/guide-prepare）寻求人工配置（注意：ZIP下载链接文字与真实版本无关，仅检查内容即可）。
---
## 执行原则（优先级最高，所有步骤均受此约束）
1. **不要默认推断安装范围**：不得根据当前工作目录或打开文件路径推断安装目录。只有用户明确指定路径或明确选择了范围才视为确认。像"安装""装一下""配置一下"这类表述不算确认。
2. **不要跳过自检**：文件下载完成不等于功能可用，必须完成第 6 步自检才能报告安装成功。
3. **不要用占位符密钥发请求**：`mcp_config.json` 中的 `"your ifind-mcp key"` 是占位符，拿到真实密钥之前不得发起 API 请求。
4. **不要直接运行 `node call-node.js` 或 `python call.py`**：这两个脚本是函数库，直接运行只打印提示，不代表成功或失败。验证必须通过第 6 步的临时自检脚本。
5. **路径加双引号**：含空格或中文的路径，命令中一律用双引号包裹。
6. **Windows PowerShell 注意编码**：含中文参数时先执行 `chcp 65001` 或 `[Console]::OutputEncoding = [Text.Encoding]::UTF8`。
7. **每步先执行再判断**：不要凭推理假设条件满足，必须实际运行检测命令（如 `ls`、`dir`、`node --version`）获取真实结果后再进入下一步。
---
## 总览
解压后应得到的目录结构（`/ifind-finance-data/` 下）：
```
SKILL.md ← 技能说明文档
mcp_config.json ← 需写入用户密钥
call-node.js ← Node.js 调用脚本（推荐，零依赖）
call.py ← Python 调用脚本（备选，需 requests 库）
references/ ← 各数据类别参考文档（8 个 .md 文件）
```
---
## 第 1 步：确定 SKILL 安装目录
**必须实际执行文件系统检测命令**，不要凭推理判断目录是否存在。
### 1.1 自动探测（按优先级逐条执行检测）
对下表中的每个候选目录，**实际执行检测命令**（如 `ls`、`dir`、`Test-Path`），命中的第一个真实存在的目录即作为 `SKILL_ROOT`。如果该目录属于当前智能体自身或通用目录，直接使用，无需询问用户。
| 智能体 | 候选 SKILL 根目录 | 检测命令示例 |
| :--- | :--- | :--- |
| Claude Code | `~/.claude/skills/` | `Test-Path "$env:USERPROFILE\.claude\skills"` 或 `ls -d ~/.claude/skills/` |
| Cursor | `~/.cursor/skills/` | `Test-Path "$env:USERPROFILE\.cursor\skills"` 或 `ls -d ~/.cursor/skills/` |
| Cline / Roo | `~/.cline/skills/` 或 `~/.roo/skills/` | 同上方式检测 |
| GitHub Copilot / Codex CLI | `~/.agents/skills/` | 同上方式检测 |
| Windsurf | `~/.windsurf/skills/` | 同上方式检测 |
| Trae | `~/.trae/skills/` | 同上方式检测 |
| 通用 | `~/.config/agents/skills/` | 同上方式检测 |
### 1.2 命中处理
- 命中的目录是**当前智能体自身**的默认目录，或通用目录（如 `~/.config/agents/skills/`）→ 直接使用，无需询问。
- 命中的目录**疑似其他智能体软件**的 SKILL 目录（如当前是 Cursor 但仅探测到 `~/.windsurf/skills/` 存在）→ 向用户确认："检测到以下可能适用的 SKILL 目录：`<列表>`，请问安装到哪个？"
### 1.3 均未命中
**不要自己盲目创建目录**。列出上表中的候选路径，询问用户希望使用哪个或自行指定。可推荐 `~/.config/agents/skills/` 作为通用选项。
### 1.4 目录不存在则创建
确定 `SKILL_ROOT` 后，若该目录不存在，创建它（`mkdir -p` / `New-Item -ItemType Directory -Force`）。
**成功判定**：已确定一个明确的 `SKILL_ROOT` 绝对路径，且该目录已存在（可以是刚创建的）。
**失败处理**：询问用户协同确定 SKILL 目录，不可自行假设。
### 1.5 已有同名技能
- 若用户SKILL目录下已存在命名为 "ifind-finance-data-x.x.x" 的SKILL目录，主动询问用户是否要用重新下载并覆盖旧版本
---
## 第 2 步：下载 ZIP 安装包
下载到系统临时目录。
**Windows (PowerShell)**：
```powershell
$zip = "$env:TEMP\ifind-skill.zip"
Invoke-WebRequest -Uri "{ZIP_URL}" -OutFile $zip -UseBasicParsing
```
**macOS / Linux**：
```bash
zip_file="/tmp/ifind-skill.zip"
curl -fSL -o "$zip_file" "{ZIP_URL}"
```
**成功判定**：执行 `ls -la` 或 `dir` 确认文件大小 > 1KB。
**失败处理**：SSL/证书错 → curl 加 `-k`，PowerShell 加 `-UseBasicParsing`；404/超时/0字节 → 告知用户链接 `{ZIP_URL}` 可能失效，不要自行更换 URL；下载异常小 → 重试一次，仍失败则同上处理。
---
## 第 3 步：解压到 SKILL_ROOT
> **关键**：最终目录名必须是 `ifind-finance-data`（**不带版本号**），结构为 `/ifind-finance-data/SKILL.md`。
>
> ZIP 内部可能有多层嵌套（如外层目录带版本号、或双层同名嵌套），下面的脚本已自动按 SKILL.md 位置纠偏，请严格复制执行。
复制以下代码块前，**先用实际路径替换 `$SKILL_ROOT` 变量**，然后执行。
**Windows (PowerShell)**：
```powershell
$SKILL_ROOT = "<替换为第1步确定的绝对路径>"
$zip = "$env:TEMP\ifind-skill.zip"
$tmpExtract = "$env:TEMP\ifind_extract"
Remove-Item -Recurse -Force $tmpExtract -ErrorAction SilentlyContinue
Expand-Archive -Path $zip -DestinationPath $tmpExtract -Force
$src = Get-ChildItem -Recurse -Filter "SKILL.md" $tmpExtract |
Select-Object -First 1 -ExpandProperty DirectoryName
Copy-Item -Recurse -Force $src "$SKILL_ROOT\ifind-finance-data"
```
**macOS / Linux**：
```bash
SKILL_ROOT="<替换为第1步确定的绝对路径>"
zip_file="/tmp/ifind-skill.zip"
tmp_extract="/tmp/ifind_extract_$$"
rm -rf "$tmp_extract"; mkdir -p "$tmp_extract"
unzip -q "$zip_file" -d "$tmp_extract" 2>/dev/null || tar -xf "$zip_file" -C "$tmp_extract"
src=$(find "$tmp_extract" -name SKILL.md -print -quit | xargs dirname)
mkdir -p "$SKILL_ROOT"
cp -R "$src" "$SKILL_ROOT/ifind-finance-data"
```
**成功判定**：逐一确认以下文件存在：
- `$SKILL_ROOT/ifind-finance-data/SKILL.md`
- `$SKILL_ROOT/ifind-finance-data/call-node.js`
- `$SKILL_ROOT/ifind-finance-data/mcp_config.json`
- `$SKILL_ROOT/ifind-finance-data/call.py`
- `$SKILL_ROOT/ifind-finance-data/references/`（目录存在即可）
**失败处理**：目录名带版本号 → 重命名为 `ifind-finance-data`；多层嵌套 → 把包含 SKILL.md 的最内层目录内容平移到 `ifind-finance-data/`；Linux 缺 `unzip` → `apt-get install -y unzip` 或 `brew install unzip` 后重试；`Expand-Archive` 不可用 → 改用 `[System.IO.Compression.ZipFile]::ExtractToDirectory($zip, $tmpExtract)`。
---
## 第 4 步：探测运行环境
Node.js 或 Python，满足其一即可（推荐 Node.js）。
执行以下检测命令，**必须实际运行**：
```bash
node --version
# 或
python --version # Windows 通常指向 Python 3
python3 --version # macOS / Linux
python -c "import requests" 2>&1
python3 -c "import requests" 2>&1
```
环境优先级：Node.js >= 14 首选（零依赖）；Python 3 + requests 已安装可用；Python 3 缺 requests → `pip install requests` 后可用。
**成功判定**：至少 1 个环境可用。记录实际可用的版本。
**失败处理**：两个都没有 → 提示安装 Node.js LTS（https://nodejs.org/）；requests 安装失败 → 建议切换 Node.js。
---
## 第 5 步：配置密钥
必须有真实密钥，不可用占位符。
1. 提示用户："请到同花顺 MCP 官网 → 个人中心 → 密钥管理（https://mcp.51ifind.com）获取 API 密钥，然后直接把密钥发给我。"
2. 收到密钥后先清洗：去除首尾空白字符。
3. 构造 JSON 写入（**不要用字符串拼接**）：读取 `mcp_config.json` → 写入 `{"auth_token": "<清洗后的密钥>"}` → 用 `JSON.stringify` / `json.dump` 序列化。
4. 写后验证：读回确认 `auth_token` 不等于占位符、不为空、不含首尾空格。
5. 完成后对用户说"密钥已安全写入配置文件"，**不要**展示完整密钥。
**成功判定**：`auth_token` 不是占位符且非空，JSON 合法。
**失败处理**：密钥明显不合法（如单字符）→ 提示确认完整复制；用户无密钥 → 引导注册 https://mcp.51ifind.com；JSON 写入报错或读回异常 → 重新"读取 → 修改对象 → 序列化 → 写入"流程。
---
## 第 6 步：可用性自检
> `call-node.js` 和 `call.py` 是函数库，直接运行只打印提示，必须通过临时自检脚本验证。
### 6.1 路径准备
复制脚本前，**把 `` 替换为 `ifind-finance-data` 目录的绝对路径**。Windows 反斜杠路径需用 `\\` 或 `/`。
### 6.2 执行自检
优先 Node.js，不可用则 Python。
**Node.js** — 写入 `$TEMP/__skill_selfcheck.js`，执行 `node "$env:TEMP\__skill_selfcheck.js"`（Windows）或 `node "$TEMP/__skill_selfcheck.js"`（macOS/Linux）：
```javascript
try {
const { listTools } = require("/call-node.js");
(async () => {
try {
const r = await listTools("stock");
console.log("SELFCHECK_RESULT:", JSON.stringify(r).slice(0, 500));
} catch (e) {
console.log("SELFCHECK_ERROR:", e.message);
}
})();
} catch (e) {
console.log("SELFCHECK_ERROR (require):", e.message);
}
```
**Python** — 写入 `$TEMP/__skill_selfcheck.py`，执行 `python "$env:TEMP\__skill_selfcheck.py"` 或 `python3 "$TEMP/__skill_selfcheck.py"`：
```python
import sys, json
sys.path.insert(0, r"")
try:
from call import list_tools
r = list_tools("stock")
print("SELFCHECK_RESULT:", json.dumps(r, ensure_ascii=False, default=str)[:500])
except Exception as e:
print("SELFCHECK_ERROR:", str(e))
```
### 6.3 结果判定
**成功**：输出含 `SELFCHECK_RESULT:` 且后续为有效 JSON（即使部分工具无权限，通信成功即通过）。
**失败参照**：
| 输出 | 处理 |
| :--- | :--- |
| `SELFCHECK_ERROR (require):` | 检查 SKILL_DIR 路径和反斜杠转义 |
| `401` / `auth` 相关 | 回第 5 步，确认密钥完整无多余字符 |
| `403` / 权限不足 | 安装已成功，告知用户当前权益受限 |
| `404` / 网络错误 / 超时 | 安装已成功（404 属服务端），网络错误则检查 `api-mcp.51ifind.com:8643` 可达性 |
| `Cannot find module` / `ImportError` | 检查路径和文件名大小写 |
| `No module named 'requests'` | `pip install requests` 后重试 |
| 输出"请按说明发起调用" | 直接执行了脚本入口而非自检脚本，重新按本节方式创建 |
### 6.4 收尾
自检完成后删除临时脚本文件（`__skill_selfcheck.js` / `__skill_selfcheck.py`）。
---
## 第 7 步：最终报告与引导
1. **输出安装摘要**，格式如下：
```
=== ifind-finance-data SKILL 安装报告 ===
安装目录：/ifind-finance-data
运行环境：Node vX.X.X / Python 3.X.X
自检结果：通过 / 未通过
自检方法：list_tools("stock")
密钥状态：已配置（脱敏显示为 ***）
技能状态：当前已可用 / 当前不可用（原因）
```
2. **提醒用户**：可能需要**重启当前智能体或重新加载 Skills**，宿主才能识别到新安装的 Skill。如果安装后看不到技能，请先尝试重启。
3. **主动提供试用引导**："SKILL 已就绪，想现在试一个金融数据查询吗？比如查最新行情：'帮我查一下贵州茅台（600519）的最新行情'。"
---
## 附录 A：SKILL 目录不匹配时的特殊情况处理
### 如果目标目录已存在旧版本
先询问用户："检测到目录 `/ifind-finance-data` 已存在，是否覆盖安装？（选择"是"将删除旧版本后安装新版本）"
- 用户确认后，删除旧目录，继续安装流程
- 用户拒绝后，询问是否需要安装到其他目录
### 如果 `mcp_config.json` 已有有效密钥
安装过程发现已有有效密钥时，**保留现有密钥**，不要覆盖。仅当密钥为空或仍为占位符时才进入第 5 步配置流程。
---
## 附录 B：常见 LLM 终端操作注意事项
1. **占位符替换**：本文档中所有 ``、``、`{ZIP_URL}` 等占位符，必须在执行前替换为实际值。其中 `{ZIP_URL}` 的值为文档顶部声明的下载地址。
2. **不得篡改 URL**：下载地址即为文档顶部声明的 `{ZIP_URL}`，不得自行修改域名或路径。
3. **命令分步执行**：每一步的命令都应该在独立终端中执行，确认成功后再进入下一步。不要把所有命令拼成一个大脚本。
4. **实际读取输出**：不要假设命令成功，必须实际读取命令输出并对照「成功判定」逐项检查。
5. **如果你无法执行终端命令**（如你是 Web 聊天界面而非 IDE 内置智能体），请直接告诉用户："我无法在您的环境中执行终端命令。请将此安装引导文档发送给您的 IDE 内置 AI 助手（如 Cursor、Claude Code、Cline 等），它们可以自动完成安装。"
---
# 概览与综合服务
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/overview
> 分组: 综合服务
## 同花顺 iFinD MCP 工具文档
让 AI 通过对话获取专业金融数据。
iFinD MCP 为 AI 应用提供金融数据查询与内容检索能力，并提供快查企业数据和法智法律信息服务。用户可以围绕公司、市场、基金、行业、经济及法律信息等主题提出问题，获取相关数据或内容，由 AI 进一步整理为资料、对比和研究参考。
金融数据可通过综合服务统一查询，也可使用各细分服务。快查与法智为独立服务。下文介绍各工具的主要用途，并各附一条提问示例，具体可用数据以账号权益和实际返回为准。
## 综合服务
通过统一入口，提供股票、基金、债券、港美股、指数板块、期货期权、宏观行业及新闻公告等金融信息查询。综合服务与下方细分服务覆盖的金融数据方向相同，工具组织有所不同；企业数据和法律信息分别由快查、法智提供。
面向多个证券市场提供基础资料、日行情、财务及相关指标查询，便于围绕关注对象获取不同方面的数据。
根据指定市场和筛选条件查找股票或基金，为证券发现、产品比较和研究选题提供候选对象。
汇总A股公司的基本情况和近期信息，帮助快速了解关注公司的业务与市场表现。
统一查询支持的A股、基金、交易所债券和指数的交易日日内快照或分钟数据。
根据宏观、行业或产品主题查找相关经济指标，帮助了解可供研究参考的数据方向。
查询相应经济指标的数值与时间序列，为趋势观察和历史比较提供数据参考。
检索与公司、行业或主题有关的财经资讯片段，帮助了解事件背景与信息动态。
查找公告中与问题相关的内容段落，辅助了解公开披露的经营、财务及重要事项。
查询近期受到关注的事件资讯，帮助了解市场讨论的话题与动态。
## 金融细分领域 MCP
金融细分领域 MCP 由综合服务按数据领域拆分而来，便于针对特定业务场景单独或组合使用。例如，基金研究可单独选择基金服务，公司研究可组合A股与新闻公告服务。
按需接入有助于减少无关工具信息的加载和上下文占用，控制 Token 消耗，具体效果与所用 AI 应用的工具加载方式有关。已配置综合服务时，无需重复配置同范围的细分服务。
## 快查与法智
---
# A股
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/cn-stock
> 分组: 金融细分领域 MCP
## A股
围绕上市公司，提供从基本资料、市场表现到经营财务的多方面信息。既可帮助用户发现关注对象，也可用于了解一家公司的业务情况、历史表现和公开事件。
根据用户关注的行业、业务或数据条件查找相关股票，为后续比较和研究提供候选对象。
汇总公司的基本情况与近期相关信息，适合在开始研究时快速了解一家公司。
提供证券与公司的基础信息，帮助了解公司身份、上市情况、行业归属及业务背景。
查询历史日行情及相关技术数据，用于观察价格变化、交易表现和不同阶段的市场走势。
查询股本结构与股东相关信息，帮助了解公司的股份构成及披露的持股情况。
提供财务报表、经营分析和估值相关数据，为了解经营规模、盈利表现和财务结构提供参考。
从历史行情角度提供量化风险相关指标，辅助观察证券的市场风险特征及其变化。
查询融资、分红、股东变动等公开事件的相关信息，帮助了解上市公司的重要事项。
提供ESG评级等相关信息，为了解公司在环境、社会责任和治理方面的评价提供参考。
查询支持股票的交易日日内快照或分钟数据，用于观察当日价格与交易情况。
---
# 基金
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/fund
> 分组: 金融细分领域 MCP
## 基金
围绕基金产品，提供基本资料、业绩表现、披露投资信息及管理人相关数据，帮助用户从产品本身、投资方向和管理机构等角度了解基金。
根据产品类型、业绩、投资方向或管理人等条件查找基金，为基金筛选和产品比较提供参考。
查询基金的分类、成立情况、管理人及其他基础资料，帮助了解产品的基本属性。
提供基金日净值、行情及业绩相关数据，用于观察产品表现及不同阶段的变化。
查询基金份额及可用的持有人相关字段，帮助了解产品份额变化与披露的持有结构。
提供披露持仓与资产配置相关信息，帮助了解基金在相应报告期的投资方向及组合构成。
查询基金自身的报告期财务及分红相关信息，补充净值和收益表现之外的产品资料。
提供基金所属管理人的相关资料与机构维度数据，帮助了解产品背后的管理机构。
查询支持基金的交易日日内行情及相关参考指标，用于观察场内交易基金的当日表现。
---
# 指数与板块
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/index
> 分组: 金融细分领域 MCP
## 指数与板块
提供指数与股票板块相关数据，便于观察整体市场、行业或主题的表现。指数数据侧重指数本身，板块数据侧重相应分类及成分的统计信息。
查询支持指数的日行情、估值等相关指标，为了解市场基准和各类指数表现提供数据参考。
查询市场、行业及概念等板块的相关信息，用于了解分类板块及其成分的整体情况。
提供支持指数的交易日日内快照或分钟数据，帮助观察当日市场变化。
---
# 宏观与行业经济
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/edb
> 分组: 金融细分领域 MCP
## 宏观与行业经济
涵盖宏观、区域、行业及大宗商品等领域的经济数据，可用于了解经济运行、产业变化和相关产品的供需情况。不同领域的数据来源与统计口径有所区别。
根据研究主题或数据需求查找相关经济指标，帮助了解有哪些数据可供参考。
查询相应经济指标的数值与时间序列，为趋势观察、历史比较和后续分析提供数据。
---
# 新闻与公告
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/news
> 分组: 金融细分领域 MCP
## 新闻与公告
围绕公司、行业和市场主题检索相关内容，帮助用户了解信息动态、查阅公开披露内容及关注近期事件。检索结果以相关内容或片段呈现。
查找与公司、行业或主题相关的财经资讯片段，为了解事件背景与信息动态提供参考。
查找公告中与问题相关的内容段落，辅助查阅公司经营、财务及其他公开披露信息。
侧重近期受到关注的事件资讯，帮助了解市场正在关注的话题与动态。
---
# 债券
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/bond
> 分组: 金融细分领域 MCP
## 债券
提供债券基础资料、市场行情、估值与发行人相关信息，帮助用户从证券条款、市场表现和发行主体等方面了解债券。
查询债券基础、发行与兑付相关信息，帮助了解债券身份及基本发行安排。
提供日行情、估值及风险收益相关指标，为观察债券价格表现和估值情况提供参考。
查询发债主体的财务相关指标，帮助了解发行人的经营与财务状况。
查询评级、可转债条款等与特定券种相关的信息，补充普通资料和行情之外的债券特征。
查询支持交易所债券的交易日日内快照或分钟数据，用于观察当日价格与交易情况。
---
# 港美股
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/global-stock
> 分组: 金融细分领域 MCP
## 港美股
提供港股、美股相关公司的资料、历史行情与基本面信息，帮助用户了解境外上市公司及其市场表现。
在指定市场内按条件查找相关股票，为港美股研究和公司比较提供候选对象。
查询证券与公司基础信息，帮助了解上市情况、业务背景及相关结构信息。
提供历史日行情及相关指标，用于观察价格表现、交易情况和历史变化。
查询财务与基本面相关数据，为了解经营表现、财务情况和估值水平提供参考。
查询分红、回购等公开事件相关信息，帮助了解公司重要事项及股东回报安排。
---
# 期货期权
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/future
> 分组: 金融细分领域 MCP
## 期货期权
提供支持期货期权合约的基本资料、日行情及成交持仓相关信息，帮助用户了解合约属性和市场表现。
查询合约及标的相关信息，帮助了解合约身份、基本属性与相关交易安排。
提供日行情、成交持仓及相关指标，为观察合约价格变化与交易活跃情况提供参考。
---
# 快查企业数据
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/kuaicha
> 分组: 企业与法律信息
## 快查企业数据
面向工商企业信息查询，覆盖企业基本资料、股东股权、经营动态、知识产权和风险相关信息等方向。可用于了解非上市企业，也可补充上市公司及其关联企业的背景资料。
根据用户关心的企业信息，查找可用的查询能力，帮助确定有哪些相关数据可以获取。
查询相应企业的工商、股权、经营及其他可用信息，为企业背景了解和研究提供资料。
---
# 法智法律信息
> 文档路径: https://mcp.51ifind.com/#/documents/mcp/fazhi
> 分组: 企业与法律信息
## 法智法律信息
提供法律法规、司法案例、裁判文书及法律实务相关内容检索，适用于法规查阅、案例研究和合规资料整理。
查找与问题相关的司法案例，帮助了解争议焦点、裁判观点及相关实践。
阅读特定案件的裁判文书内容，帮助进一步了解案情、法院观点和裁判结果。
检索相关法律法规及条文，为了解某类事项的法律规定提供资料。
阅读指定法规的内容，围绕关注主题整理其中的制度安排与相关规定。
查找法律实务文章及相关解读，补充法规、案例之外的实践背景与研究材料。
阅读指定网页中的公开内容，辅助整理政策说明、公告和办事指南等相关资料。
---
# iFinD金融数据MCP产品分档权益介绍-企业版-1.0.2
> 文档路径: https://mcp.51ifind.com/#/documents/enterprise-tier-benefits-1.0.2
> 分组: 企业版权益
版本号 1.0.2
# iFinD 金融数据 MCP 产品分档权益介绍｜企业版
## 一、价格与具体额度
企业版价格及各档具体额度请联系客服获取。联系热线 952555，拨通后回复 iFinD业务。
本文仅介绍企业版各项权益的含义与档位间的相对差异，**不代表具体额度承诺**；实际额度以双方确认的商务方案或合同约定为准，并可根据机构业务规模按需配置。
## 二、企业版权益概览
iFinD 金融数据 MCP 让 AI 助手能够调用金融数据工具：用户提出查询需求，AI 助手获取所需数据后，可继续完成解释、比较或分析。对业务用户来说，选择档位时无需先掌握 MCP 的技术细节，重点是看**一个月能查多少、某类数据能查多少、多人集中使用时能发起多少请求，以及能否将较大结果下载为 CSV**。
企业版分为**企业专业版、企业高级版、企业旗舰版**。三个档位均提供高于个人版的请求并发，均支持 CSV 下载和高频实时行情独立限流池；随着档位提高，各项额度依次提升。
| **分类** | **权益** | **企业专业版** | **企业高级版** | **企业旗舰版** |
| ------ | ---------------- | ------------- | ------------- | ------------- |
| 定位 | 定位 | 机构团队日常使用 | 用量更大的机构 | 大规模、高强度使用 |
| 基本权益 | 账号调用总量 | 充足 | 更高 | 最高 |
| 基本权益 | 账号请求并发额度 | 高并发 | 高并发 | 高并发 |
| 基本权益 | 原 MCP 基础工具 | 支持 | 支持 | 支持 |
| 付费权益 | 工商企业数据类工具（快查） | 支持 | 支持，额度更高 | 支持，额度最高 |
| 付费权益 | 法律信息查询类工具（法智） | 支持 | 支持，额度更高 | 支持，额度最高 |
| 付费权益 | 宏观经济数据搜索（EDB 搜索） | 支持 | 支持，额度更高 | 支持，额度最高 |
| 付费权益 | 智能证券筛选类工具 | 支持 | 支持 | 支持 |
| 付费权益 | CSV 下载模式 | 支持 | 支持 | 支持 |
| 付费权益 | CSV 下载次数与单次文件容量 | 支持 | 支持，额度更高 | 支持，额度最高 |
| 付费权益 | 高频实时行情独立限流池 | 支持 | 支持，额度更高 | 支持，额度最高 |
以上各档具体额度请联系客服确认。以下逐项解释这些权益如何计算，以及它们对实际工作的影响。**所有工具调用均受账号调用总量约束**；某个工具即使还有单独额度，也不能突破账号总量。
## 三、调用总量：企业档位按月计算
### 从一次业务提问理解“调用”
一次对话不一定只产生一次工具调用。例如，用户请 AI 助手“查找相关行业指标，并给出近一年的变化”，助手可能先调用搜索工具定位指标，再调用取数工具取得数据。**每向一个工具发起一次请求，就发生一次工具调用**；用户的一次提问可能包含多次调用。
现有工具在未触发大数据量追加扣除时，每次基础调用扣除 1 次账号调用额度。为控制进入 AI 对话的文本数据量，普通文本返回可能受到截断限制；通常在截断范围内不会补充扣次。少数需要提取较多数据的查询，特别是 CSV 批量下载，可能按实际提取数据量追加扣除次数，因此不能仅按“一个请求”或“一个文件”推算扣次。后续新增的高级或复杂工具，其基础扣次也可能不同。
### 对业务使用的影响
企业档位的调用总量按月计算，适合估算团队整月的使用规模。AI 助手为了完成一次综合分析而发起的多步查询，会逐次消耗额度；若团队经常进行多轮检索或提取较大数据集，还应考虑可能发生的追加扣次。建议在咨询时向客服说明团队人数和主要使用场景，以便匹配合适的档位。
## 四、特定工具额度：能否持续查询某类数据
### 为什么除了总量，还有工具自己的上限
账号调用总量是所有工具共享的额度；部分工具另设单独的月度上限。调用这些工具时，**账号总量和工具单独上限同时生效**。工具单独上限并不是在账号总量之外另行赠送的额度。
快查、法智类工具的单独上限按**每个工具**分别计算，并非将全类别工具的调用合并为一个额度。
### 各类工具有什么用
| 工具类别 | 可用于哪些工作 |
| ---------------- | -------------------------- |
| 工商企业数据类工具（快查） | 查询工商企业信息，或按地区、行业等条件查找和统计企业 |
| 法律信息查询类工具（法智） | 检索法律法规、历史案例、法律相关网页及资讯 |
| 宏观经济数据搜索（EDB 搜索） | 查找与自然语言需求相关的宏观、行业经济指标 |
| 智能证券筛选类工具 | 依据自然语言条件筛选证券，包括 A 股智能选股、智能选基、港美股智能选股 |
**快查：** 适合处理非上市企业等工商企业资料。例如，投研人员需要了解目标企业的注册地址、经营范围或知识产权；也可以按地区、行业等条件寻找企业。快查提供先搜索可用查询接口、再执行具体查询的方式，减少用户记忆复杂接口名称的负担。
**法智：** 面向法律信息查询。例如，合规或风控人员需要查找某类业务相关的法规和历史案例。若法律资料检索是高频工作，应特别关注这一项，而不只看账号总量。
**EDB 搜索：** 帮助 AI 助手从大量宏观和行业经济指标中找到与业务表述相近的指标，再配合 EDB 取数工具查询具体数据。例如，用户提出“找反映某行业景气度的指标”，可以先搜索候选指标，确认后再取数。搜索与取数属于不同工具步骤，发生调用时都占用账号调用总量。
**智能证券筛选：** 三个企业档位均开放这类工具，每次使用消耗账号调用总量。
### 对业务使用的影响
选择档位时，应先找出团队最常用的数据类别。如果工作主要围绕非上市企业研究，重点看快查；如果经常做合规检索，重点看法智；如果持续研究宏观和行业指标，重点看 EDB 搜索。只看账号月度总量，可能忽略常用工具先达到其单独上限的情况。
## 五、请求并发：多人或多项查询集中发生时的能力
### 什么是请求并发
AI 助手取得数据时，会向 MCP 工具发出网络请求。一个人让助手同时比较多只证券，或多名同事在同一账号下同时发起查询，都会让请求在短时间内集中出现。这里的**请求并发额度**可理解为账号短时间内可集中发起的工具请求数量。它衡量的是请求密度，**不是**一个月可调用的总次数。
当集中发起的请求超过额度时，可能出现“用户请求频率过高，请稍后再试”的提示，需要稍后重试。并发额度越高，越能容纳同一时段的多项查询；它不改变账号调用总量，也不表示每次查询都能在固定时间内完成。
### 对业务使用的影响
如果团队成员使用时间较分散，或一次只查少量数据，请求并发的压力通常较小。若多名成员共用账号，或者智能体需要同时对大量对象发起查询，并发额度就会直接影响能否顺畅提交这些请求。企业版并发额度高于个人版，并可按业务需要配置，具体请联系客服确认，联系热线 952555，拨通后回复 iFinD业务。
## 六、CSV 下载：较大结果如何交给后续分析
### 为什么需要 CSV 模式
日常查询结果通常以文本形式进入 AI 对话，便于助手立即解释。但是，若一次查询包含大量证券、日期或指标，把完整结果全部放进对话，既会占用较多对话容量，也不便于后续整理。因此，文本结果可能受到截断限制；需要取得较大完整结果时，可使用 CSV 下载模式，由服务生成 CSV 文件并提供下载链接，供后续分析使用。
例如，用户希望提取一批证券在多个交易日的涨跌幅并继续计算、制表，CSV 比在对话中逐行展示全部数据更适合。**单元格**是表格中一行与一列交叉形成的一个数据位置；“单次 CSV 单元格上限”约束一份文件最多可包含的数据规模，与每月能下载多少份文件是两项不同限制。
### 对业务使用的影响
如果偶尔下载较大的数据结果，应重点看**单次单元格上限**；如果经常生成多个文件，还要看**每月下载次数**。CSV 下载并非只占一次基础调用额度：当实际提取的数据量较大时，还可能追加扣除账号月度调用次数。因此，CSV 次数、单次文件容量和账号月度总量需要一起考虑。
MCP 主要用于 AI 助手在对话中按需取数、完成分析。如果工作流程需要长期、大批量地提取、存储或写入数据库，可考虑同花顺 iFinD 的数据接口 API 或数据库产品。
## 七、高频实时行情独立限流池：日内密集查询的专项额度
### 它与普通请求并发有什么关系
高频实时行情工具主要用于证券日内实时行情和分钟 K 线等查询。例如，盘中持续查看一组证券的最新价格，或反复获取分钟行情供后续判断。这类工作对请求密度较敏感，因此除账号整体请求并发额度外，三个企业档位还提供**专用于高频实时行情工具的独立限流池**。
独立限流池是额外的请求额度，不是额外的月度调用次数；相关工具调用仍计入账号月度总量。
---
# iFinD金融数据MCP产品分档权益介绍-个人版-1.0.2
> 文档路径: https://mcp.51ifind.com/#/documents/personal-tier-benefits-1.0.2
> 分组: 个人版权益
版本号 1.0.2
# iFinD 金融数据 MCP 产品分档权益介绍｜个人版
## 一、定价：三个档位的月卡、季卡与年卡价格
个人版三个档位均提供月卡、季卡、年卡三种购买周期。下表列出各档位在三种周期下的价格、换算月均价与单次均价。
| **档位** | **月卡价格** | **季卡价格** | **年卡价格** | **换算月均价** | **单次均价** |
| ------ | -------- | -------- | --------- | --------- | -------- |
| 个人基础版 | 40 元/月 | 120 元/季 | 399 元/年 | 40 元 | 0.0133 元 |
| 个人专业版 | 99 元/月 | 297 元/季 | 1,188 元/年 | 99 元 | 0.0124 元 |
| 个人旗舰版 | 199 元/月 | 597 元/季 | 2,388 元/年 | 199 元 | 0.0100 元 |
## 二、个人版权益概览
iFinD 金融数据 MCP 让 AI 助手能够调用金融数据工具：用户提出查询需求，AI 助手获取所需数据后，可继续完成解释、比较或分析。选择档位时，重点不在于掌握 MCP 的技术细节，而在于判断**一个月预计查询多少、是否经常使用特定数据工具、是否需要下载较大结果，以及会不会在盘中密集查询实时行情**。
个人版分为**个人基础版、个人专业版、个人旗舰版**。三个档位的账号请求并发额度相同，均支持 CSV 下载；专业版和旗舰版还提供高频实时行情独立限流池。档位越高，月度调用总量、快查与法智等工具额度、EDB 搜索额度以及 CSV 下载能力越高。
| **分类** | **权益** | **免费试用版** | **个人基础版** | **个人专业版** | **个人旗舰版** |
| ------ | ---------------- | ------------- | --------- | ------------ | ------------ |
| 定位 | 定位 | 免费体验 | 高阶功能极佳体验 | 主推荐版本 | 更大个人权益 |
| 基本权益 | 账号调用总量 | 2,000 次，永久总量 | 3,000 次/月 | 8,000 次/月 | 20,000 次/月 |
| 基本权益 | 账号请求并发额度 | 2 次/秒 | 5 次/秒 | 5 次/秒 | 5 次/秒 |
| 基本权益 | 原 MCP 基础工具 | 支持 | 支持 | 支持 | 支持 |
| 付费权益 | 工商企业数据类工具（快查） | 每个 50 次/月 | 每个 50 次/月 | 每个 1,000 次/月 | 每个 2,000 次/月 |
| 付费权益 | 法律信息查询类工具（法智） | 每个 50 次/月 | 每个 50 次/月 | 每个 100 次/月 | 每个 200 次/月 |
| 付费权益 | 宏观经济数据搜索（EDB 搜索） | 20 次/月 | 20 次/月 | 200 次/月 | 500 次/月 |
| 付费权益 | 智能证券筛选类工具 | 相关三项各 100 次/月 | 无单独次数上限 | 无单独次数上限 | 无单独次数上限 |
| 付费权益 | CSV 下载模式 | 不支持 | 支持 | 支持 | 支持 |
| 付费权益 | CSV 下载次数 | 不支持 | 5 次/月 | 100 次/月 | 300 次/月 |
| 付费权益 | 单次 CSV 单元格上限 | 不支持 | 2,000 个 | 6,000 个 | 12,000 个 |
| 付费权益 | 高频实时行情独立限流池 | 不支持 | 不支持 | 5 次/秒 | 5 次/秒 |
免费试用版提供永久总计 2,000 次调用额度，额度不会按月刷新，并发额度为 2 次/秒。三个个人档位的调用总量按月计算，并发额度均为 5 次/秒。个人基础版的快查、法智和 EDB 搜索单独额度与免费试用版相同，但已支持 CSV 下载，智能证券筛选类工具也不再设单独次数上限。个人专业版和个人旗舰版进一步提高这些特定工具与 CSV 下载额度，并提供高频实时行情独立限流池。智能证券筛选类工具的免费额度分别对应“智能选基”“港美股智能选股”“智能证券筛选”三项。
以下逐项解释这些权益如何计算，以及它们对实际工作的影响。**所有工具调用均受账号调用总量约束**；某个工具即使还有单独额度，也不能突破账号总量。
## 三、调用总量：免费试用为永久额度，个人档位按月计算
### 从一次提问理解“调用”
一次对话不一定只产生一次工具调用。例如，用户请 AI 助手“找到某个行业的相关经济指标，并查看近一年的变化”，助手可能先调用搜索工具定位指标，再调用取数工具取得数据。**每向一个工具发起一次请求，就发生一次工具调用**；用户的一次提问可能包含多次调用。
现有工具在未触发大数据量追加扣除时，每次基础调用扣除 1 次账号调用额度。为控制进入 AI 对话的文本数据量，普通文本返回可能受到截断限制；通常在截断范围内不会补充扣次。少数需要提取较多数据的查询，特别是 CSV 批量下载，可能按实际提取数据量追加扣除次数，因此不能仅按“一个请求”或“一个文件”推算扣次。后续新增的高级或复杂工具，其基础扣次也可能不同。
### 各档额度
| 免费试用版 | 个人基础版 | 个人专业版 | 个人旗舰版 |
| ------------ | --------- | --------- | ---------- |
| 2,000 次，永久总量 | 3,000 次/月 | 8,000 次/月 | 20,000 次/月 |
### 对使用的影响
免费试用版的 2,000 次是账号永久可用的总额度，**不会每月刷新**；其快查、法智等工具虽另有单项月度上限，仍须受这 2,000 次总量约束。三个个人档位的总量则按月计算。若经常进行多步比较、反复筛选，或一次查询较大数据集，应考虑一次提问可能产生多次工具调用，以及大数据量查询可能追加扣次。
## 四、特定工具额度：常用的数据类别能查多少次
### 为什么除了总量，还有工具自己的上限
账号调用总量是所有工具共享的额度；部分工具另设单独的月度上限。调用这些工具时，**账号总量和工具单独上限同时生效**。例如，个人专业版某个快查工具的上限为 1,000 次/月，这 1,000 次仍计入该账号 8,000 次/月的总量。
“快查旗下全部工具（每个）”和“法智旗下全部工具（每个）”中的**每个**，表示同一类别下每个工具分别计算上限，并非将全类别工具的调用合并为一个额度。
### 各类工具有什么用，权益如何区分
| **工具类别** | **可用于哪些工作** | **免费试用版** | **个人基础版** | **个人专业版** | **个人旗舰版** |
| ---------------- | -------------------------- | --------- | --------- | ------------ | ------------ |
| 工商企业数据类工具（快查） | 查询工商企业信息，或按地区、行业等条件查找和统计企业 | 每个 50 次/月 | 每个 50 次/月 | 每个 1,000 次/月 | 每个 2,000 次/月 |
| 法律信息查询类工具（法智） | 检索法律法规、历史案例、法律相关网页及资讯 | 每个 50 次/月 | 每个 50 次/月 | 每个 100 次/月 | 每个 200 次/月 |
| 宏观经济数据搜索（EDB 搜索） | 查找与自然语言需求相关的宏观、行业经济指标 | 20 次/月 | 20 次/月 | 200 次/月 | 500 次/月 |
**快查：** 适合处理非上市企业等工商企业资料。例如，了解一家公司的注册地址、经营范围或知识产权，或按地区和行业寻找企业。快查提供先搜索可用查询接口、再执行具体查询的方式，无需事先记住复杂接口名称。个人基础版的单工具上限与免费试用版相同，个人专业版和个人旗舰版则依次提高。
**法智：** 面向法律信息查询。例如，查找某类业务相关的法规、历史案例或法律资讯。个人基础版、个人专业版、个人旗舰版的单工具上限分别为每个 50、100、200 次/月。如果经常研究法规和案例，这项上限可能比账号总量更早影响使用。
**EDB 搜索：** 帮助 AI 助手从大量宏观和行业经济指标中找到与日常表述相近的指标，再配合 EDB 取数工具查询具体数据。例如，用户提出“找反映某行业景气度的指标”，可以先搜索候选指标，确认后再取数。搜索与取数属于不同工具步骤，发生调用时都占用账号调用总量。个人专业版和个人旗舰版的搜索额度分别为 200、500 次/月，适合更频繁地探索指标。
**智能证券筛选：** 支持依据自然语言条件筛选证券，包括 A 股智能选股、智能选基、港美股智能选股。三个个人档位均开放这类工具，**没有单独的工具次数上限**，但每次使用仍消耗账号调用总量。免费试用版中，“智能选基”“港美股智能选股”“智能证券筛选”分别为 100 次/月。
### 对使用的影响
先看自己最常查询的数据类别，再比较对应工具的单独上限。例如，常研究宏观和行业数据，应重点看 EDB 搜索；常查询工商资料或法规案例，应重点看快查、法智。账号总量较高，并不代表某一类受单独限额约束的工具可以无限使用。
## 五、请求并发：一次集中查询多少项
### 什么是请求并发
AI 助手取得数据时，会向 MCP 工具发出网络请求。如果让助手同时比较多只证券，或一次任务需要并行查询多个对象，请求就可能在短时间内集中出现。这里的**请求并发额度**按“次/秒”展示，可理解为账号短时间内可集中发起的工具请求数量。它衡量的是请求密度，**不是**一个月可调用的总次数。
当集中发起的请求超过额度时，可能出现“用户请求频率过高，请稍后再试”的提示，需要稍后重试。并发额度不改变账号调用总量，也不表示每次查询都能在固定时间内完成。
### 各档额度
| 免费试用版 | 个人基础版 | 个人专业版 | 个人旗舰版 |
| ----- | ----- | ----- | ----- |
| 2 次/秒 | 5 次/秒 | 5 次/秒 | 5 次/秒 |
### 对使用的影响
免费试用版的请求并发额度为 2 次/秒，三个个人档位均提高至 5 次/秒。如果主要关心普通工具在同一时段能集中发起多少请求，三个个人档位之间没有差异；档位之间的区别主要体现在月度总量、特定工具额度、CSV 下载和高频实时行情专项额度。
## 六、CSV 下载：较大结果如何交给后续分析
### 为什么需要 CSV 模式
日常查询结果通常以文本形式进入 AI 对话，便于助手立即解释。但是，若一次查询包含大量证券、日期或指标，把完整结果全部放进对话，既会占用较多对话容量，也不便于后续整理。因此，文本结果可能受到截断限制；需要取得较大完整结果时，可使用 CSV 下载模式，由服务生成 CSV 文件并提供下载链接，供后续分析使用。
例如，用户希望提取一批证券在多个交易日的涨跌幅并继续计算、制表，CSV 比在对话中逐行展示全部数据更适合。**单元格**是表格中一行与一列交叉形成的一个数据位置；“单次 CSV 单元格上限”约束一份文件最多可包含的数据规模，与每月能下载多少份文件是两项不同限制。
### 各档额度
| 权益 | 个人基础版 | 个人专业版 | 个人旗舰版 | 免费试用版 |
| ------------ | ------- | ------- | -------- | ----- |
| CSV 下载模式 | 支持 | 支持 | 支持 | 不支持 |
| CSV 下载次数 | 5 次/月 | 100 次/月 | 300 次/月 | 不支持 |
| 单次 CSV 单元格上限 | 2,000 个 | 6,000 个 | 12,000 个 | 不支持 |
### 对使用的影响
如果偶尔下载较大的数据结果，应重点看**单次单元格上限**；如果需要经常生成多个文件，还要看**每月下载次数**。个人基础版支持 CSV，但每月只有 5 次下载额度；个人专业版和个人旗舰版适合更频繁地生成文件。CSV 下载在提取较多数据时可能追加扣除账号月度调用次数，因此下载次数、单次文件容量和账号月度总量需要一起考虑。
MCP 主要用于 AI 助手在对话中按需取数、完成分析。如果工作流程需要长期、大批量地提取、存储或写入数据库，可考虑同花顺 iFinD 的数据接口 API 或数据库产品。
## 七、高频实时行情独立限流池：日内密集查询的专项额度
### 它与普通请求并发有什么关系
高频实时行情工具主要用于证券日内实时行情和分钟 K 线等查询。例如，盘中持续查看一组证券的最新价格，或反复获取分钟行情供后续判断。这类工作对请求密度较敏感，因此部分档位除账号整体请求并发额度外，还提供**专用于高频实时行情工具的独立限流池**。
独立限流池是额外的请求额度，不是额外的月度调用次数。以个人专业版为例，账号整体并发额度为 5 次/秒，高频实时行情独立额度为 5 次/秒；高频实时行情工具可合计使用 10 次/秒的请求额度，相关工具调用仍计入账号月度总量。
### 各档额度
| 个人基础版 | 个人专业版 | 个人旗舰版 | 免费试用版 |
| ----- | ----- | ----- | ----- |
| 不支持 | 5 次/秒 | 5 次/秒 | 不支持 |
### 对使用的影响
如果主要在盘后做低频研究，这项额度通常不是首要比较因素。如果需要盘中频繁查询多只证券的实时行情或分钟 K 线，个人专业版和个人旗舰版均提供相同的专项请求额度；在两者之间选择时，可进一步比较月度调用总量与其他工具额度。个人基础版没有高频实时行情独立限流池，但仍可在账号整体并发额度内使用相关工具。
---
# 2026.09.23 个人版套餐价格调整公告
> 文档路径: https://mcp.51ifind.com/#/documents/changelog-2026-09-23-price-adjustment
> 分组: 公告
# 个人版套餐价格调整公告
自 2026 年 9 月 23 日左右起生效
为持续提升 iFinD MCP 的数据服务质量与稳定性，我们将于 **2026 年 9 月 23 日左右** 对个人版套餐价格进行调整，并同步上线新版套餐体系。原个人版套餐调整为「基础版 / 专业版 / 旗舰版」三档，提供更清晰的额度梯度与权益选择。
> **已购套餐权益不受影响。**
>
> 凡在本次调整生效之前完成购买的用户，其套餐价格、有效期、数据问答额度、并发数及其他全部权益，均按购买时的约定继续执行——**不追溯、不补差、不减少、不影响使用**。
>
> **本次调整生效后**，新购买（含续订）的订单按新版套餐的价格与权益执行。
## 新版套餐概览
| 套餐 | 月卡 | 季卡 | 年卡 | 月度额度 | 并发 |
| --- | --- | --- | --- | --- | --- |
| 基础版 | ¥40 | ¥120 | ¥399 | 3,000 次 / 月 | 5 次 / 秒 |
| 专业版 | ¥99 | ¥297 | ¥1,188 | 8,000 次 / 月 | 5 次 / 秒 |
| 旗舰版 | ¥199 | ¥597 | ¥2,388 | 20,000 次 / 月 | 5 次 / 秒 |
基础版月卡价格与原个人版月卡保持一致；专业版、旗舰版为本次新增档位，面向更高用量场景，月度额度最高提升至 20,000 次 / 月。
## 影响范围
| 项目 | 说明 |
| --- | --- |
| 生效时间 | 本次价格调整自 **2026 年 9 月 23 日左右** 起生效。 |
| 已购套餐 | 调整生效前已购订单及当前生效中的套餐**不受影响**，价格、有效期、额度及全部权益按原约定继续执行，**不追溯、不补差**。 |
| 调整生效后 | 新购与续订按新版套餐的价格与权益执行。 |
| 企业版 | 企业版订阅方案本次不参与调整。 |
## 常见问题
### 我已经购买的套餐会受影响吗？
不会。已购套餐的价格、有效期、额度及全部权益，均按购买时的约定继续执行，不追溯、不补差。
### 我的数据问答额度会变少吗？
不会。已购用户的月度额度仍按购买时的标准执行，不因本次调整而减少。
### 套餐到期后按什么价格购买？
按调整后的新套餐价格购买。本次调整均为**一次性购买**，不会自动续费，到期后由你自行决定是否购买。
### 新版套餐的额度是多少？
基础版 3,000 次 / 月、专业版 8,000 次 / 月、旗舰版 20,000 次 / 月，并发均为 5 次 / 秒。
### 我还能升级到更高档位吗？
可以。生效中的套餐支持升级至更高档位，升级后按新档位权益执行。具体规则见订阅页说明。
### 可以退款吗？
本次为价格调整，已购订单不涉及退款。如需取消当前订阅，请按《会员服务协议》约定的退款规则办理。
### 企业版会一起调整吗？
不会。本次调整仅涉及个人版套餐，企业版订阅方案保持不变。
[查看新版套餐](#/pricing)