efunds

---
name: efunds
display_name: 易方达基金MCP服务
display_name_en: E Fund MCP
description: 接入易方达基金MCP服务，一句话查透基金画像——业绩、风险收益、持仓结构等核心指标一目了然，还能随时调阅易方达发布的投研观点、产品解读与市场洞察，助力您高效进行投资决策。
description_zh: 接入易方达基金MCP服务，一句话查透基金画像——业绩、风险收益、持仓结构等核心指标一目了然，还能随时调阅易方达发布的投研观点、产品解读与市场洞察，助力您高效进行投资决策。
description_en: Connect to the E Fund MCP service to get a complete fund profile in a single query—performance, risk-return metrics, holdings structure, and other key indicators at a glance. You can also access E Fund's investment research insights, product interpretations, and market perspectives anytime to support efficient investment decision-making.
category: 投资理财
version: 1.0.0
author: 易方达基金
---

# 易方达基金MCP服务（efunds）

本连接器提供易方达基金的官方信息查询能力，共 3 个工具：

| 工具 | 用途 |
| --- | --- |
| `fund_profile_query` | 按基金代码查询基金画像（净值、业绩、基金经理、持仓、费率等） |
| `search_wx_articles` | 检索易方达官方微信公众号文章列表 |
| `get_wx_article_detail` | 按文章 ID 读取单篇公众号文章全文 |

## fund_profile_query —— 基金画像查询

用户询问某只基金的具体情况（净值/收益、基金经理、业绩、持仓、规模、费率、分红、公告等）时调用。

### 参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `fund_code` | string | 是 | 基金代码，六位数字字符串，如 `"005827"` |
| `modules` | string[] | 否 | 模块编码数组（大小写敏感，共 11 个编码）。省略=全量模块（页面全量渲染，含头部）；空数组=页面不渲染任何内容（含头部）；传入时页面仅当含 `banner` 编码才展示头部。**默认规则：显式传入 modules 时一律附带 `banner`，除非用户明确要求不展示头部** |

### modules 模块编码与意图映射

| 模块编码 | 内容 | 适用用户意图 |
| --- | --- | --- |
| `banner` | 顶部头部区（基金名称/代码/晨星评级/风险等级/适合投资者） | 问风险等级/评级/适合谁买（页面侧仅携带该编码才渲染头部，不参与模块排序） |
| `baseInfo` | 基本信息 | 了解基金概况 |
| `performance` | 业绩表现 | 问业绩/收益/涨跌（通常与 baseInfo 同传） |
| `keyIndicators` | 关键指标 | 问回撤/夏普/波动/同类排名 |
| `fundManager` | 基金经理 | 问基金经理 |
| `assetAllocation` | 资产配置 | 问持仓/重仓股/行业分布 |
| `scaleHolder` | 规模及持有人结构 | 问规模/谁在持有 |
| `feeStructure` | 费率结构 | 问费率/申购赎回费 |
| `dividend` | 基金分红 | 问分红 |
| `announcement` | 产品公告 | 问公告/风险提示函 |
| `popularQuestions` | 大家都在问 | 常见问题 |

意图不明或用户想整体了解基金时，省略 `modules`（返回全量模块）；显式传 `modules` 时除用户明确要求外一律附带 `banner`，保证页面头部（基金名称/评级/风险等级）正常展示。

### 返回结果怎么读

- `modules.{编码}.status`：`success`=有数据；`empty`=上游无数据；`hidden`=命中页面隐藏规则（`reason` 给出原因）；`partial`=部分上游失败；`error`=查询失败
- `modules.{编码}.data`：数值字段含 `display`（页面展示口径，如 "389.08亿元"）与 `raw`（上游原值）。**向用户复述请优先使用 `display`，不要自行估算**
- `modules.banner.data`：头部固有信息（基金名称/代码/风险等级/适合投资者类型/晨星评级），回答风险等级/适合谁买类问题时使用（对应意图传 `modules=["banner"]`）
- `fund_url`：基金画像 H5 页面地址，UI 自动内嵌渲染，无需在回答中处理
- `errors`：内部诊断信息，不要直接展示给用户

## search_wx_articles —— 公众号文章检索

用户想找易方达公众号的文章（如"最近易方达发了哪些关于定投的文章"）时调用。检索结果为列表，阅读全文需配合 `get_wx_article_detail`。

### 参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `keyword` | string[] | 否 | 关键词列表，模糊匹配标题/摘要/正文，多关键词为 AND 关系；缺省不过滤 |
| `account` | string | 否 | 公众号名称（如"易方达基金"）；不在白名单内的账号会被拒绝 |
| `title` | string | 否 | 文章标题，归一化后精确匹配，用于查询标题相同的多篇文章 |
| `start_date` | string | 否 | 开始日期 `yyyymmdd`，缺省 30 天前 |
| `end_date` | string | 否 | 结束日期 `yyyymmdd`，缺省今天 |
| `page` | int | 否 | 页码，从 1 开始，默认 1 |
| `page_size` | int | 否 | 每页条数，默认 20，上限 100 |

### 返回结构

```json
{
  "total": 15,
  "page": 1,
  "page_size": 20,
  "articles": [
    {
      "article_id": "文章 ID（用于查详情）",
      "title": "标题",
      "account_name": "公众号名称",
      "author": "作者",
      "pub_time": "yyyy-MM-dd HH:mm:ss",
      "digest": "摘要",
      "article_url": "原文链接",
      "cover_image": "封面图"
    }
  ]
}
```

`total` 为 0 且调用成功即表示无匹配文章，如实告知用户即可，可建议放宽时间范围或关键词。

## get_wx_article_detail —— 文章详情

用户想阅读某篇文章全文时调用（文章 ID 来自 `search_wx_articles` 的结果，参数名为 `id`）。返回在检索结果字段基础上增加：

- `content`：正文原文
- `content_images`：正文图片链接列表

## 组合使用示例

1. 用户："110011 最近表现怎么样？" → `fund_profile_query(fund_code="110011", modules=["banner", "baseInfo", "performance"])`
2. 用户："最近两周易方达公众号发了哪些定投的文章？" → `search_wx_articles(keyword=["定投"], start_date=<两周前 yyyymmdd>)`，向用户展示文章列表
3. 用户："展开第一篇看看" → 用列表中第一条的 `article_id` 调 `get_wx_article_detail(id=<article_id>)`，基于 `content` 作答

## 错误处理

- 业务拒绝（公众号不在白名单、文章 ID 不存在、日期非法等）以工具错误形式返回可读的中文原因，请直接把原因转述给用户，不要编造数据
- 基金代码必须为六位数字，用户只给了基金名称时，先确认或补全六位代码再调用
- 画像模块 `status` 为 `hidden`/`empty` 时，按 `reason` 向用户解释（如货币基金不展示关键指标），不要用其他数据替代