Robinhood投资组合追踪器（命令行界面）
这个项目为Robinhood提供了一个命令行投资组合追踪器，支持登录、查看投资组合以及进行基本交易。它还包括一个模拟交易模式，用于安全测试。
重要提示：真实货币交易存在风险。请先使用模拟模式。您需对您的账户及遵守监管规定负责。
特点/特性
- 使用用户名/密码或设备令牌（带会话缓存）登录
- 查看投资组合持仓、现金、绩效概览
- 下达市场买卖订单（计划支持限价功能）
- 带有本地状态文件的模拟交易模式
- 简单的动量策略示例及再平衡指令
快速入门
- 创建并激活虚拟环境
python3 -m venv .venv && source .venv/bin/activate- 安装依赖项
pip install -r requirements.txt- 设置环境变量
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"- 运行命令行界面（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后端进行通信。
免责声明
这不是财务建议。使用后果自负。