基金顾投 Skill (fund-advisor)

提供个人基金持仓统一管理功能，支持所有平台持仓导入、分析、查询；提供基金基础数据、持仓明细、持仓穿透等基于数据查询；提供投资组合分析、投资规划、组合回测服务；提供财经资讯、热点新闻、财经新闻查询；提供基金搜索、公告查询等服务。

‼️重要：你所有的分析过程和结论必须基于用户导入的持仓数据和qieman-mcp服务器工具获取最新的实时数据。

‼️重要：你引用的其他来源数据可能会给用户带来投资风险，请一定要使用可靠的、准确的、即时的数据，不要提供任何主观的数据和分析结论。

能力范围

1. 1. 管理用户的基金持仓数据，用户可以通过基金E账户导出所有持仓数据（包括：支付宝、京东金融、腾讯理财、雪球基金、且慢等所有平台的场外基金持仓数据），导入数据时会创建数据库文件存储用户导入的数据，后续可以配合qieman-mcp的数据查询能力进行持仓数据的综合分析。数据目录可通过 FUNDADVISORDATAPATH 环境变量配置，默认为 $HOME/.fund-advisor，数据库文件名为 fundportfolio_v1.db。

1. 2. 本技能整合qieman-mcp的五大核心能力模块：

模块	能力说明
金融数据	基金基础信息、净值历史、持仓明细、风险指标、业绩表现等
投研服务

基金筛选、基金诊断、回测分析、相关性分析、风险评估等 | | 投顾服务 | 资产配置方案、投资规划、风险匹配、财务分析等 | | 投顾内容 | 实时资讯解读、热点话题、基金经理观点、财经新闻等 | | 通用服务 | 交易日查询、图表渲染、PDF生成、时间查询等 |

完整工具清单见 references/mcp-tools-full.md

核心功能

1. 持仓管理

导入用户的持仓数据，后续进行数据分析使用。

数据获取和导入方法：通过基金E账户导出Excel，转换成csv文件后发生给你的Agent。

bash

初始化环境（检查 mcporter 和 qieman-mcp 配置）

bash scripts/fund-cli.sh init

导入 CSV 持仓文件，导入的数据会覆盖保存到本地数据库

bash scripts/fund-cli.sh import-csv tools/data/holdings.csv

导入 Excel 持仓文件，导入的数据会覆盖保存到本地数据库

bash scripts/fund-cli.sh import-excel tools/data/holdings.xlsx

同步所有数据到本地（基础信息 + 持仓详情）

bash scripts/fund-cli.sh sync --all

2. 持仓分析

bash

按列分组统计

bash scripts/fund-cli.sh group -c invest_type # 按投资类型分组
bash scripts/fund-cli.sh group -c fund_account # 按基金账户分组
bash scripts/fund-cli.sh group -c trade_account # 按交易账户分组
bash scripts/fund-cli.sh group -c fund_manager # 按基金管理人分组
bash scripts/fund-cli.sh group -c sales_agency # 按销售机构分组

按条件查询持仓明细

bash scripts/fund-cli.sh query -c fund_manager -v 易方达 # 查询易方达管理的基金 bash scripts/fund-cli.sh query -c invest_type -v 股票型 # 查询股票型基金 bash scripts/fund-cli.sh query -c fund_name -v 红利 # 查询名称包含红利的基金

查看基金详情

bash scripts/fund-cli.sh detail 004137

3. 基金投资咨询

直接通过 MCP 服务查询任意基金信息，无需本地数据库：

bash

批量查询多只基金

mcporter call qieman-mcp.BatchGetFundsDetail --args {fundCodes:[004137,000001,110022]} --output json

查询基金持仓明细

mcporter call qieman-mcp.BatchGetFundsHolding --args {fundCodes:[004137]} --output json

详细工具参考文档 references/mcp-tools-full.md

数据模型

• - FundHolding - 用户持仓
• FundInfo - 基金信息

详见 references/reference.md

导入格式

csv示例文件见 assets/sample.csv

• - Excel格式和csv格式相同，只是文件扩展名不同

详细规范见 references/csv-format.md

使用示例

示例1：查询基金信息

用户：帮我查一下易方达蓝筹精选的信息

执行：

bash
mcporter call qieman-mcp.BatchGetFundsDetail --args {fundCodes:[005827]} --output json

示例2：导入新持仓

用户：我有个CSV文件要导入

执行：

bash
bash scripts/fund-cli.sh import-csv /path/to/holdings.csv

示例3：同步最新数据

用户：更新一下基金数据

执行：

bash
bash scripts/fund-cli.sh sync --all

注意事项

1. 1. 环境要求：需要先运行 init 命令确保 mcporter 和 qieman-mcp 配置正确
2. 批量限制：MCP 服务单次最多查询 10 只基金
3. 数据时效：基金净值和持仓数据有延迟，注意查看净值日期
4. CSV 编码：支持 utf-8, utf-8-sig, gbk, gb18030 编码
5. 目录结构：工程代码位于 tools/ 目录下

高级功能场景

场景1：投资组合诊断分析

用户持有基金组合，需要诊断分析：

bash

1. 查询基金信息

mcporter call qieman-mcp.BatchGetFundsDetail \
--args {fundCodes:[005094,320007,001003,040046]} \
--output json

2. 基金相关性分析

mcporter call qieman-mcp.GetFundsCorrelation \ --args {fundCodes:[005094,320007,001003,040046]} \ --output json

3. 组合回测分析

mcporter call qieman-mcp.GetFundsBackTest \ --args {fundCodes:[005094,320007,001003,040046],weights:[0.47,0.23,0.17,0.13]} \ --output json

场景2：资产配置方案规划

用户希望制定投资方案：

bash

1. 获取资产配置方案

mcporter call qieman-mcp.GetAssetAllocationPlan \
--args {expectedAnnualReturn:0.08} \
--output json

2. 蒙特卡洛模拟

mcporter call qieman-mcp.MonteCarloSimulate \ --args {weights:[0.3,0.3,0.2,0.2],years:3} \ --output json

场景3：基金筛选与对比

用户希望筛选符合特定条件的基金：

bash

1. 基金搜索

mcporter call qieman-mcp.SearchFunds \
--args {keyword:红利,sortBy:oneYearReturn,limit:10} \
--output json

2. 基金业绩对比

mcporter call qieman-mcp.GetBatchFundPerformance \ --args {fundCodes:[005827,000001,110022]} \ --output json

3. 基金诊断

mcporter call qieman-mcp.GetFundDiagnosis \ --args {fundCode:005827} \ --output json

场景4：市场分析

用户希望了解市场情况：

bash

1. 市场温度计

mcporter call qieman-mcp.GetLatestQuotations \
--args {date:2025-03-01} \
--output json

2. 热点话题

mcporter call qieman-mcp.SearchHotTopic \ --args {limit:10} \ --output json

3. 基金经理观点

mcporter call qieman-mcp.SearchManagerViewpoint \ --args {industry:科技,limit:5} \ --output json

4. 搜索财经资讯

mcporter call qieman-mcp.SearchFinancialNews \ --args {keyword:降息,startDate:2025-01-01,limit:10} \ --output json

环境配置

1. 配置环境变量

设置 QIEMANAPIKEY 环境变量：

bash

临时设置（当前终端会话）

export QIEMAN_API