AI导哈

Robinhood投资组合追踪器

一个命令行界面的Robinhood投资组合追踪工具，提供登录、查看投资组合、基本交易和模拟交易功能。

  • by kvcpers
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 kvcpers/Robinhood-Portfolio-Tracker-MCP

使用说明

Robinhood投资组合追踪器（命令行界面）

这个项目为Robinhood提供了一个命令行投资组合追踪器，支持登录、查看投资组合以及进行基本交易。它还包括一个模拟交易模式，用于安全测试。

重要提示：真实货币交易存在风险。请先使用模拟模式。您需对您的账户及遵守监管规定负责。

特点/特性

  • 使用用户名/密码或设备令牌（带会话缓存）登录
  • 查看投资组合持仓、现金、绩效概览
  • 下达市场买卖订单（计划支持限价功能）
  • 带有本地状态文件的模拟交易模式
  • 简单的动量策略示例及再平衡指令

快速入门

  1. 创建并激活虚拟环境
python3 -m venv .venv && source .venv/bin/activate
  1. 安装依赖项
pip install -r requirements.txt
  1. 设置环境变量
export RH_USERNAME="your_email@example.com"
export RH_PASSWORD="your_password"
export RH_DEVICE_TOKEN="your_device_token_optional"
export RH_PAPER="true"  # set to "false" to enable live trading
# Optional: if you already have an access token from the web app
export RH_ACCESS_TOKEN="paste_access_token_here"
export RH_TOKEN_TYPE="Bearer"
  1. 运行命令行界面（CLI）
python -m robinhood_tracker --help

命令

  • login验证并缓存会话
  • portfolio显示位置、股权和现金
  • buy --symbol AAPL --quantity 1市价买入
  • sell --symbol AAPL --quantity 1市场出售
  • rebalance --symbols AAPL,MSFT,GOOGL --allocations 40,30,30示例策略

交易机器人命令

  • bot add --symbol AAPL --quantity 10 --stop-loss -5.0 --take-profit 10.0添加位置以进行监控
  • bot remove --symbol AAPL从监控中移除位置
  • bot start --interval 5启动机器人（每5分钟检查一次）
  • bot stop停止机器人
  • bot status显示监控的仓位和当前盈亏情况
  • bot check手动检查所有位置一次

MCP（模型上下文协议）集成

该项目包括一个全面的MCP适配器，用于人工智能模型的集成。

可用工具

MCP适配器提供了15种交易和投资组合管理工具：

投资组合管理

  • get_portfolio - 获取投资组合概览和持仓情况
  • get_health - 检查API服务器状态
  • login - 使用Robinhood进行身份验证

交易操作

  • buy_stock - 以指定代码和数量购买股票
  • sell_stock - 出售指定代码和数量的股票
  • rebalance_portfolio - 自动调整以达到目标配置比例

交易机器人管理

  • get_bot_status - 获取机器人状态和监控中的仓位
  • add_bot_position - 添加带有止损/止盈的位置
  • remove_bot_position - 从监控中移除位置
  • start_bot - 启动自动化交易机器人
  • stop_bot - 停止自动化交易机器人
  • check_bot_positions - 手动检查所有位置

期权交易

  • get_options_positions - 获取当前期权持仓
  • get_options_orders - 获取最新的期权订单
  • get_options_instruments - 获取符号的可用选项

使用示例

# List all available tools
python3 mcp_robinhood_adapter.py --list-tools

# Get portfolio
python3 mcp_robinhood_adapter.py --tool get_portfolio

# Buy stock
python3 mcp_robinhood_adapter.py --tool buy_stock --params '{"symbol": "AAPL", "quantity": 1}'

# Add position to bot
python3 mcp_robinhood_adapter.py --tool add_bot_position --params '{"symbol": "AAPL", "quantity": 1, "stop_loss": 5, "take_profit": 10}'

人工智能模型集成

配置您的AI模型以使用MCP服务器：

{
  "mcpServers": {
    "robinhood": {
      "command": "python3",
      "args": ["/path/to/robinhood_tracker/mcp_robinhood_adapter.py"]
    }
  }
}

安全注意事项

  • 永远不要提交凭证。使用环境变量或 .env 文件未被 Git 跟踪。
  • 纸张模式将本地状态写入 .paper_state.json。
  • MCP服务器通过本地HTTP API（127.0.0.1:5000）与Python后端进行通信。

免责声明

这不是财务建议。使用后果自负。

相关 MCP