uzairansaruzi/robinhood-agent-skill

Asesor de Cartera de Robinhood

Acceso de solo lectura a tu cartera de Robinhood a través del servidor robinhood-mcp. Proporciona datos en vivo para posiciones, cotizaciones, fundamentos, noticias, ganancias, calificaciones de analistas, dividendos y opciones.

Prerrequisitos

1. Cuenta de Robinhood

Necesitas una cuenta de Robinhood (gratuita en robinhood.com).

2. Instalación del Servidor MCP

El paquete robinhood-mcp proporciona el servidor MCP. Instálalo con uno de los siguientes:

# Recomendado — se ejecuta a través de uvx (no necesita instalación global, se gestiona automáticamente)
# Solo agrégalo a la configuración de tu agente y funciona. uvx lo instala en la primera ejecución.

# Alternativa — instalación global con pip
pip install robinhood-mcp

Nota: uvx es proporcionado por el gestor de paquetes Python uv. Instálalo primero: curl -LsSf https://astral.sh/uv/install.sh | sh

3. Variables de Entorno

Establécelas en el archivo .env de tu agente o en el perfil del shell:

Variable	Requerida	Descripción
ROBINHOOD_USERNAME	Sí	Tu correo electrónico de Robinhood
ROBINHOOD_PASSWORD	Sí	Tu contraseña de Robinhood
ROBINHOOD_TOTP_SECRET	Solo si usas una aplicación de autenticación	El secreto TOTP de tu configuración de autenticación. No es necesario si usas verificación por SMS.

4. Configuración del Agente

Consulta el directorio templates/ para fragmentos de configuración listos para copiar y pegar para tu agente. Referencia rápida:

Hermes Agent (~/.hermes/config.yaml):

mcp_servers:
  robinhood:
    command: uvx
    args:
      - robinhood-mcp
    env:
      ROBINHOOD_USERNAME: "${ROBINHOOD_USERNAME}"
      ROBINHOOD_PASSWORD: "${ROBINHOOD_PASSWORD}"
      # ROBINHOOD_TOTP_SECRET: "${ROBINHOOD_TOTP_SECRET}"  # Descomenta para usar la aplicación de autenticación
    timeout: 60
    connect_timeout: 30

Otros agentes — consulta el directorio templates/ para Claude Desktop, Claude Code, Codex, OpenCode, Cline y Windsurf.

Después de agregar la configuración, reinicia tu agente. Verifica con: hermes mcp test robinhood (Hermes) o verifica el estado MCP de tu agente.

Herramientas MCP Disponibles

Estas herramientas se registran como mcp_robinhood_* en Hermes Agent (el prefijo varía según el agente):

Herramienta	Descripción
robinhood_get_portfolio	Valor de la cartera, patrimonio, poder de compra, cambio diario
robinhood_get_positions	Todas las tenencias con base de costo, valor actual, ganancias/pérdidas
robinhood_get_position	Tenencia única por ticker (más rápido para un símbolo)
robinhood_get_watchlist	Acciones en tus listas de seguimiento
robinhood_get_quote	Precio en tiempo real, oferta/demanda, volumen
robinhood_get_fundamentals	Ratio P/E, capitalización de mercado, rendimiento de dividendos, rango de 52 semanas
robinhood_get_historicals	Historial de precios OHLCV (5 min, 10 min, hora, día, semana)
robinhood_get_news	Artículos de noticias recientes para un símbolo
robinhood_get_earnings	Fechas de ganancias, estimaciones de EPS, resultados reales
robinhood_get_ratings	Calificaciones de analistas de compra/mantener/venta
robinhood_get_dividends	Historial de pagos de dividendos
robinhood_get_options_positions	Posiciones actuales de opciones
robinhood_search_symbols	Buscar acciones por nombre o ticker

Caché Local

Los datos de la cartera se almacenan en caché localmente en ~/.hermes/data/robinhood/portfolio_cache.json (Hermes) o ~/.robinhood-mcp/cache.json (otros agentes).

Estrategia de Caché Primero

Revisa siempre el caché primero. Solo llama a las herramientas MCP cuando:

1. El caché tiene más de 15 minutos Y el usuario necesita datos en vivo
2. El usuario solicita explícitamente una actualización (