TradingView OpenCode Agent 🤖

Conecta tu TradingView Desktop con opencode.ai para análisis de charts con IA.

Este proyecto está INSPIRADO en tradingview-mcp de tradesdontlie. No es un fork directo — es una reimplementación con código 100% original y documentación en español/inglés.

✨ Características

Característica	Descripción
📊 Análisis de Chart	Lee indicadores, niveles, tablas de Pine, y estado del gráfico
📈 Indicadores	SMC, ICT, RSI, MACD, Bollinger Bands, VWAP, EMA, SMA, Stochastic, y más...
🎯 Niveles SMC	Detecta CHoCH, BOS, SFP, Fair Price Zones, zonas de liquidez
⏪ Replay Mode	Practica trading en datos históricos con control de barras
📋 Reports	Genera reportes de estrategia con métricas de rendimiento
🔍 Multi-Symbol	Escanea múltiples instrumentos en batch
📸 Screenshots	Captura charts automáticamente para análisis
🔔 Alertas	Crea y gestiona alertas de precio

🚀 Instalación Rápida

# 1. Clonar el repo
git clone https://github.com/jadatorin/tradingview-opencode-agent.git
cd tradingview-opencode-agent

# 2. Instalar dependencias
npm install

# 3. Configurar opencode.ai
# Agregar a tu ~/.config/opencode/mcp.json:
{
  "mcp": {
    "tradingview": {
      "command": ["node", "C:/Users/TU_USUARIO/proyects/tradingview-opencode-agent/src/index.js"],
      "type": "local"
    }
  }
}

# 4. Iniciar TradingView con debug port
.\launchers\launch_tv.ps1

# 5. Verificar conexión
npm run test

📋 Requisitos

Requisito	Versión Mínima
Node.js	18+
TradingView Desktop	Windows/Mac/Linux (cualquiera)
opencode.ai	Cliente MCP-compatible
Suscripción TradingView	Para datos en tiempo real (opcional)

🎯 Uso Rápido

Análisis de Chart

"Analiza mi chart de ES1! en 15 minutos"
"Qué indicadores tengo activos?"
"Cuáles son los niveles de soporte y resistencia?"
"Dame un screenshot del gráfico actual"

Pine Script

"Escribe un indicador de VWAP con bandas"
"Compila mi script de estrategia"
"Hay errores de compilación? cuales?"
"Agrega un oscilador estocástico"

Replay Trading

"Inicia replay en SPY desde marzo 2025"
"Avanza 5 velas hacia adelante"
"Toma una posición larga en el último swing"
"Cierra la posición y muéstrame el P&L"

Multi-Symbol Scan

"Escanea ES, NQ, YM para oportunidades alcistas"
"Compara RSI en BTC, ETH y SOL"
"Múltiples screenshots de mi watchlist"

📁 Estructura del Proyecto

tradingview-opencode-agent/
├── src/                          # Servidor MCP
│   ├── index.js                  # Entry point
│   ├── server.js                 # Implementación del servidor
│   ├── config.js                 # Configuración centralizada
│   └── utils/
│       ├── cdp-client.js         # Cliente Chrome DevTools Protocol
│       └── trading-helpers.js    # Helpers de TradingView
│
├── opencode-skills/              # Skills para opencode.ai
│   ├── SKILL.md                  # Dispatcher principal
│   ├── chart-analysis/           # Análisis técnico
│   ├── pine-develop/             # Desarrollo Pine Script
│   ├── replay-practice/          # Modo replay
│   ├── multi-symbol-scan/        # Escaneo multi-símbolo
│   ├── strategy-report/          # Reportes de estrategia
│   └── docs/                     # Docs de referencia
│
├── launchers/                    # Scripts de lanzamiento
│   ├── launch_tv.ps1             # Windows universal
│   ├── launch_tv.sh              # Linux/macOS
│   ├── launch_tv_desktop.ps1     # Desktop installer
│   └── launch_tv_msix.ps1         # Microsoft Store
│
├── docs/                         # Documentación principal
└── package.json                  # Dependencias Node.js

🔧 Configuración

Variables de Entorno (opcional)

# Puerto de debug de Chrome (default: 9222)
CDP_PORT=9222

# Host de Chrome (default: localhost)
CDP_HOST=localhost

# Directorio para screenshots (default: ./screenshots)
SCREENSHOT_DIR=./screenshots

# Timeout de operaciones (default: 30000ms)
TIMEOUT_MS=30000

Configuración de MCP

OpenCode (formato correcto)

{
  "mcp": {
    "tradingview": {
      "command": ["node", "C:/Users/TU_USUARIO/proyects/tradingview-opencode-agent/src/index.js"],
      "type": "local"
    }
  }
}

Claude Desktop / Cursor

{
  "mcpServers": {
    "tradingview": {
      "command": "node",
      "args": ["C:/Users/TU_USUARIO/proyects/tradingview-opencode-agent/src/index.js"]
    }
  }
}

Tip: Para rutas relativas usa ./src/index.js si el config está en la raíz del proyecto.

🛡️ Seguridad

Aspecto	Estado
✅ Código 100% original	Auditado, sin dependencias externas
✅ Sin conexiones a servidores	Todo corre localmente
✅ Sin recopilación de datos	No hay telemetry ni tracking
✅ Chrome DevTools Protocol	Conexión local a tu app

📚 Documentación Detallada

Documento	Descripción
INSTALL	Guía paso a paso de instalación
MCP	Configuración detallada de MCP
ARCHITECTURE	Arquitectura técnica del proyecto
TROUBLESHOOTING	Problemas comunes y soluciones
../launchers/README.md	Scripts de lanzamiento
../opencode-skills/SKILL.md	Skills de opencode.ai

🤝 Contribuir

# 1. Fork el repo
# 2. Crea una rama
git checkout -b feature/nueva-feature

# 3. Commit con convencionales
git commit -m 'feat: nueva feature awesome'

# 4. Push
git push origin feature/nueva-feature

# 5. Abre un Pull Request

📜 Licencia

MIT License — ver LICENSE

👥 Autores

jadatorin (aka bitorin)

• GitHub: @jadatorin
• TradingView: bitorin

Inspirado por: tradesdontlie/tradingview-mcp

---

⭐ Si te resultó útil, dale una estrella al repo!