Portfolio Manager

📊 智能投资组合分析与再平衡助手

基于Alpaca API的专业投资组合分析工具,实时获取持仓数据,提供资产配置、风险评估、多元化分析及再平衡建议,适合需要量化投资管理的个人投资者

收藏
18.6k
安装
4.2k
版本
0.1.0
CLS 安全性认证2026-05-18
点击查看完整报告 >

使用说明

核心用法

Portfolio Manager 通过 Alpaca MCP Server 集成,实现投资账户的自动化深度分析。工作流程分为七个步骤:首先调用 Alpaca API 获取实时持仓、账户权益和交易历史;其次为每个持仓补充市场数据、基本面和技术面信息;随后执行四层组合级分析——资产配置(跨资产类别、行业、市值和地域)、多元化评估(集中度风险、HHI指数、相关性分析)、风险计量(组合Beta、最大回撤、尾部风险)以及业绩归因;再对前10-15大持仓进行个股深度诊断;最终生成具体的再平衡方案并输出完整Markdown报告。

显著优点

数据实时性与准确性:直接对接Alpaca经纪商API,杜绝手工录入错误,分析基于真实持仓而非模拟数据。分析框架系统化:整合现代投资组合理论,涵盖资产配置、多元化、风险、业绩四大维度,方法论严谨。输出高度结构化:生成包含执行摘要、持仓概览、风险评分、个股诊断、再平衡建议及行动清单的专业报告,可直接存档或分享。可操作性极强:明确标注TRIM/ADD/HOLD/SELL建议、具体股数/金额、优先级分级及税务影响估算。扩展功能丰富:支持税务亏损收割、股息收入分析、情景模拟(牛熊市/利率上升)等高级特性。

潜在缺点与局限性

数据源单一依赖:核心功能绑定Alpaca MCP Server,若未配置或API故障则无法使用,虽有手工录入备选但体验大幅下降。分析深度受限:个股基本面数据依赖WebSearch或外部API,可能不完整或延迟;技术分析仅限于简单移动平均线,缺乏复杂指标计算能力。相关性分析为估算:未明确使用历史价格数据计算真实相关系数,可能依赖行业经验判断。税务建议粗略:资本利得估算未考虑持有期长短、 wash sale 规则细节及用户具体税率档次,需专业税务师复核。无预测能力:基于历史数据和当前状态分析,无法预测市场走势或个股未来表现。

适合人群

主要面向使用Alpaca作为经纪商的个人投资者,尤其适合:持仓数量15-30只、需要定期再平衡的中等规模组合管理者;关注资产配置纪律性、希望降低组合波动性的稳健型投资者;以及具备基础投资知识、能理解Beta、夏普比率等指标、寻求数据驱动决策的自助型投资者。不适合纯新手(缺乏解读能力)、超大规模组合(需机构级工具)或高频交易者(分析频率不匹配)。

常规风险

数据风险:API延迟或错误可能导致分析基于过期数据,建议关键决策前人工核对。模型风险:目标资产配置模板为通用建议,可能与用户实际风险偏好错配。执行风险:再平衡建议未考虑市场流动性、滑点及交易成本,大额交易需分批实施。合规风险:输出含免责声明,但用户可能误将信息建议当作投资建议,需强调咨询持牌顾问的必要性。隐私风险:通过MCP传输账户数据,需确认Alpaca API密钥的安全存储。

安全解读

核心用法

Portfolio Manager 是一款面向美股投资者的专业组合分析工具,通过集成 Alpaca MCP Server 实现一键式持仓诊断。用户触发分析后,系统首先调用 Alpaca API 拉取实时账户净值、现金余额、持仓明细及成本基础,随后自动执行六大维度深度分析:资产类别与行业配置占比、持仓集中度与分散化评分、组合 Beta 与最大回撤等风险指标、个股盈亏表现、重点持仓的估值与技术面健康度,最终输出优先级排序的再平衡操作清单。

显著优点

数据实时性与自动化:直连券商 API 消除手工录入误差,持仓市值、未实现损益、买卖力数据均为实时拉取,确保分析基准可靠。

分析框架系统化:内置保守/均衡/成长/激进四套目标配置模板,自动对比当前持仓与理想配置,识别超配/低配缺口;采用 Herfindahl-Hirschman 指数量化集中度风险,对单一仓位超 10-15% 或单一行业超 30-40% 自动预警。

风险度量全面:除传统 Beta、标准差外,结合最大回撤、尾部风险暴露、高波动个股占比等多维度评估,输出 0-100 风险评分,便于投资者直观理解组合波动特征。

可执行建议清晰:再平衡模块区分"立即执行"(风险削减)、"高优先级"(配置漂移>10%)、"中低优先级"(微调与择机)三级动作,附具体交易数量、预估税务影响及替代标的建议,降低决策摩擦。

潜在局限

地域与品种限制:当前仅支持 Alpaca 覆盖的美股、ETF 及部分加密资产,A 股、港股、债券、衍生品等品种无法直接分析,需用户手动补充数据。

深度分析依赖外部数据:个股层面的估值、技术信号、分析师评级需通过 WebSearch 或第三方市场数据接口获取,若数据源延迟或缺失,可能影响个别持仓的投资建议质量。

税务优化能力有限:虽提示税损收割机会,但未内置 wash sale 规则自动规避、持仓期长短资本利得区分等高级税务引擎,复杂税务场景仍需人工复核。

相关性分析简化:对 5-20 只持仓的组合提供相关性矩阵估算,但缺乏历史回测驱动的协方差矩阵,分散化效果判断偏向经验法则。

适合人群

- 投资顾问/财富管理者:可借助该工具快速生成客户持仓的标准化分析报告,作为深度沟通的基础材料。

  • 美股 DIY 投资者:已在 Alpaca 开户或愿意开通,希望定期(月度/季度)获得自动化组合体检报告。
  • 资产配置型选手:持有 10-30 只标的,关注行业偏离、个股集中风险,需要系统化的再平衡纪律。

不适合:多币种全球资产配置者、复杂衍生品交易者、或需要实时交易执行(仅分析建议,无下单功能)的活跃交易员。

常规风险

API 凭证安全:密钥存储于环境变量虽优于硬编码,但用户需自行防范密钥泄露、定期轮换,并优先使用 Paper Trading 账户验证功能。

数据依赖风险:Alpaca API 服务中断、行情延迟或持仓数据异常可能导致分析结果失真,重要决策前建议人工核对关键仓位。

模型假设局限:目标配置模板基于历史回测与常规风险偏好,未考虑个人现金流需求、负债结构、税务档级等个性化因素,建议作为参考而非唯一依据。

市场风险不可消除:工具仅评估与揭示风险,无法预测黑天鹅事件或系统性危机,高 Beta 组合在极端行情中仍可能出现大幅回撤。

Portfolio Manager 内容

references文件夹
scripts文件夹
手动下载zip · 66.9 kB
alpaca-mcp-setup.mdtext/markdown
请选择文件