ahang1598 易方达基金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 |
返回结构
{
"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：正文图片链接列表
组合使用示例
- 用户："110011 最近表现怎么样？" →
fund_profile_query(fund_code="110011", modules=["banner", "baseInfo", "performance"]) - 用户："最近两周易方达公众号发了哪些定投的文章？" →
search_wx_articles(keyword=["定投"], start_date=<两周前 yyyymmdd>)，向用户展示文章列表 - 用户："展开第一篇看看" → 用列表中第一条的
article_id调get_wx_article_detail(id=<article_id>)，基于content作答
错误处理
- 业务拒绝（公众号不在白名单、文章 ID 不存在、日期非法等）以工具错误形式返回可读的中文原因，请直接把原因转述给用户，不要编造数据
- 基金代码必须为六位数字，用户只给了基金名称时，先确认或补全六位代码再调用
- 画像模块
status为hidden/empty时，按reason向用户解释（如货币基金不展示关键指标），不要用其他数据替代