Skip to content

README.md

Latest commit

 

History

History
66 lines (45 loc) · 2.97 KB

README.md

File metadata and controls

66 lines (45 loc) · 2.97 KB

MaudeViewTVCore

MaudeViewTVCore

Browser automation for TradingView via Chrome DevTools Protocol.

Exposes a REST API for TradingView chart control — symbol, resolution, studies, drawings, alerts, watchlists, notes, Pine editor, replay, snapshots, and layouts. Connects to a Chromium browser over CDP and evaluates JavaScript directly in TradingView pages. A separate researcher daemon passively captures network traffic for offline analysis.

Full Documentation — architecture, quickstart, all 185 endpoints, building agents, configuration, security.

WARNING — Security

The controller can execute arbitrary JavaScript in any browser tab it connects to. CDP and the REST API have no authentication. The managed browser uses a dedicated profile — only log into TradingView in this browser. Do not log into any other websites (email, banking, social media, etc.). Any site open in a matched tab is fully scriptable. Always bind to 127.0.0.1 (the default) and never expose the CDP port or API to untrusted networks. See the Security guide for hardening details.

Installation

Download pre-built binaries from the latest release:

# Example: linux amd64
curl -L https://github.com/Fomo-Driven-Development/MaudeViewTVCore/releases/latest/download/tv_controller_linux_amd64 -o tv_controller
chmod +x tv_controller

Or build from source (requires Go 1.24+):

go install github.com/dgnsrekt/MaudeViewTVCore/cmd/tv_controller@latest

Prerequisites

  • Go 1.24+
  • Chromium (or Chrome) with remote debugging enabled
  • just command runner

Quick Start

cp example.env .env            # configure CDP port, bind address, etc.
just run-tv-controller-with-browser  # launch browser + REST API server

Open http://127.0.0.1:8188/docs for interactive API documentation.

# List detected chart tabs
curl -s http://127.0.0.1:8188/api/v1/charts | jq

See the Quick Start guide for the full walkthrough including agent setup.

Running Tests

go test ./...                                          # unit tests
just test-integration                                  # integration tests (requires running browser + controller)

Documentation