portfolio-manager

💼 专业级资产配置与风险分析顾问

基于 Alpaca API 实时数据的投资组合分析工具,提供资产配置、风险评估与再平衡建议,帮助投资者优化持仓结构并降低集中风险。

收藏
2.5k
安装
654
版本
v0.1.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

Portfolio Manager 是一款专为 Alpaca 经纪账户用户设计的投资组合分析技能。它通过 MCP(Model Context Protocol)协议连接 Alpaca API,自动获取用户的实时持仓数据、账户资产和历史交易记录,随后执行六大维度的深度分析:资产配置评估、多元化风险检测、风险指标计算(包括 Beta 系数和最大回撤)、个股头寸深度剖析、业绩归因分析以及再平衡策略生成。

使用该技能时,用户只需授权 Alpaca API 访问权限,系统便会自动拉取完整的投资组合快照。分析引擎会依据现代投资组合理论,对比用户当前持仓与保守型、稳健型、成长型、激进型四类标准资产配置模型,识别超配板块和集中度过高的个股风险。最终输出一份结构化的 Markdown 分析报告,包含具体的买卖建议、税务损失收割机会以及分优先级的行动清单。

显著优点

该技能的最大优势在于数据实时性与分析框架的专业性结合。不同于需要手动录入持仓的传统分析工具,它直接对接 Alpaca 官方 API,确保所有分析基于最新市场数据。其内置的多元化评估体系采用赫芬达尔-赫希曼指数(HHI)量化集中度风险,并提供针对个股、板块、市值、地域四个维度的穿透式分析。

另一个突出特点是可执行的建议输出。系统不仅指出"科技板块占比过高"这类问题,更会给出具体的调仓方案,例如"减持 AAPL 50 股,将科技板块占比从 45% 降至 30%,释放资金增持 XLF 以提升金融板块配置"。同时支持税损收割机会识别、股息收入预测和情景压力测试(牛市/熊市/加息环境)等高级功能。

潜在缺点与局限性

首先,平台依赖性较强。该技能仅支持 Alpaca 经纪商用户,无法直接接入盈透证券、富途、老虎等其他券商账户,非 Alpaca 用户只能通过手动 CSV 导入方式使用,体验大打折扣。

其次,数据来源受限。虽然 Alpaca 提供免费的实盘交易 API,但其市场数据覆盖范围、实时性(部分为延迟报价)以及历史数据深度可能不及专业金融终端。对于期权、加密货币或场外市场交易品种的支撑也存在局限。

此外,分析建议的普适性限制。系统基于标准资产配置理论生成建议,但无法充分考虑用户的个性化税务状况、流动性需求、ESG 偏好或特殊投资限制(如禁投名单)。对于需要复杂衍生品对冲策略或跨账户统一视图(如同时管理 IRA 和 taxable account)的用户,功能尚显不足。

适合的目标群体

本技能最适合使用 Alpaca 平台的 DIY 个人投资者,尤其是持仓数量在 10-50 只之间、希望获得机构级组合分析但不愿支付高昂投顾费用的中高级投资者。对于刚完成初始建仓、需要验证资产配置合理性的新手,以及面临再平衡决策、担心单一股票集中风险的长线价值投资者,该工具能提供清晰的数据支持。

教育场景下,投资学学生或 CFA 考生也可利用该技能将现代投资组合理论(MPT)、资本资产定价模型(CAPM)等抽象概念与实际持仓数据结合,加深对风险分散、Beta 系数、夏普比率等指标的理解。

使用风险与注意事项

API 安全风险是首要考量。用户需要在环境变量中配置 Alpaca API 密钥,尽管该技能采用只读权限设计(仅查询持仓,不执行交易),但若用户设备被植入恶意软件,API 密钥仍存在泄露风险。建议用户定期轮换密钥,并仅授予 "view" 权限而非 "trade" 权限。

数据隐私方面,虽然代码审查确认无数据上报行为,但用户仍需信任 Alpaca 平台的隐私政策。持仓数据、账户净值等敏感信息在传输过程中虽经 HTTPS 加密,但理论上 Alpaca 服务器会留存 API 调用日志。

市场风险提示方面,该工具提供的再平衡建议基于历史数据和当前估值指标,无法预测黑天鹅事件或突发市场崩盘。用户应理解所有建议均为信息参考,不构成投资建议,特别是在高波动市场环境中,机械遵循再平衡信号可能导致频繁交易和摩擦成本上升。

安全解读

核心用法

Portfolio Manager Skill 通过与 Alpaca MCP Server 集成,自动获取用户真实持仓数据,执行六步分析流程:获取账户与持仓信息 → 补充市场数据与基本面 → 资产类别/行业/市值/地域分配分析 → 集中度与相关性多元化评估 → Beta、最大回撤、波动率等风险指标计算 → 个股估值与技术面诊断 → 最终输出再平衡交易建议与优先级排序。

显著优点

1. 数据实时性:直接对接持牌券商API,持仓、盈亏、购买力为真实数据,杜绝手工输入误差。
2. 分析体系完整:覆盖资产配置、多元化、风险、业绩、个股、再平衡六大维度,方法论参照现代投资组合理论。

3. 输出 actionable:明确给出 TRIM/ADD/HOLD/SELL 指令、具体股数/金额、优先级分级(Immediate/High/Medium/Low),便于直接执行。

4. 合规设计:全程只读API,无交易权限;支持模拟账户(Paper Trading)先行验证。

5. 扩展功能:内置税务亏损收割(Tax-Loss Harvesting)、股息收入分析、情景压力测试(牛/熊市/加息)等进阶模块。

潜在缺点与局限

  • 地域局限:Alpaca 主要为美股券商,对 A 股、港股、加密资产支持有限,国际投资者覆盖不足。
  • 依赖外部MCP:功能强绑定 Alpaca MCP Server,若服务器未配置或连接故障,Skill 无法运行,需手动CSV备选。
  • 无预测能力:分析基于历史与当前数据,未来收益预测、宏观择时建议需用户自行判断。
  • 税费估算粗糙:仅提供资本利得估算,未集成具体用户税率、持有期、 wash sale 规则自动计算,需税务专业人士复核。
  • 个人开发者维护:维护者 veeramanikandanr48 为 GitHub 个人账号,长期更新频率与安全响应能力存在不确定性。

适合人群

  • 已在 Alpaca 开户(真实或模拟)的美股投资者
  • 需要定期 portfolio review 的自主投资者与理财顾问
  • 希望量化集中度风险、Beta 暴露、行业偏离的理性投资者
  • 具备基础金融知识,能独立判断建议并承担决策责任的用户

常规风险

1. 数据敏感:Skill 处理真实账户净值、持仓盈亏等财务隐私,需在可信环境运行,避免日志泄露。
2. API 密钥管理:需妥善保管 ALPACA_API_KEY/SECRET,建议使用只读权限、环境变量 600 权限、定期轮换。

3. 市场数据延迟:免费行情可能为延迟 15 分钟报价,高频决策需确认实时行情订阅。

4. 模型局限:Beta/标准差等指标基于历史数据,极端行情下风险度量可能失效(尾部风险低估)。

5. 合规声明:输出含标准免责声明,不构成投资建议,用户需自行承担交易决策后果。

portfolio-manager 内容

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