Labsco
ertugrul59 logo

TradingView Chart Image Scraper

★ 97

from ertugrul59

Fetches TradingView chart images for a given ticker and interval.

🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#scraping#browser#git#finance#monitoring

MCP Server - TradingView Chart Image Scraper

<a href="https://mseep.ai/app/ertugrul59-tradingview-chart-mcp"><img src="https://mseep.net/pr/ertugrul59-tradingview-chart-mcp-badge.png" alt="MseeP.ai Security Assessment" width="200"></a>

🚀 Now with Browser Pooling Optimization for 70-80% Better Concurrent Performance!

This MCP server provides tools to fetch TradingView chart images based on ticker and interval with advanced browser pooling for maximum concurrent performance.

Demo — AI analyzing a BTCUSDT daily chart via MCP

🔥 Performance Optimizations

Browser Pooling Technology

  • Production Version: Uses main_optimized.py with browser pooling for maximum concurrent performance
  • Performance Improvement: 70-80% faster for concurrent requests
  • Concurrent Handling: Supports up to 4 simultaneous requests with pre-initialized browser instances
  • Expected Performance:
    • 1 request: ~6-8s (baseline)
    • 2 concurrent: ~3-4s each (60-70% faster)
    • 3 concurrent: ~2.5-3.5s each (70-80% faster)

Version Comparison

  • main_optimized.py (Production): Browser pooling, concurrent optimization, performance tracking
  • main.py (Legacy): Simple single-browser approach, kept for debugging/fallback

Features

  • 🚀 Optimized Chart Image Tool: Fetches direct chart images with browser pooling for maximum concurrent performance
  • 📊 Performance Statistics: Built-in performance monitoring and statistics
  • 🔄 Browser Pool Management: Pre-initialized browser instances for zero-overhead concurrent requests
  • 🎯 Natural Language Prompts: Easy chart requests with interval mapping
  • ⚙️ Environment Configuration: Fully configurable via environment variables
  • 🔐 TradingView Authentication: Secure session-based authentication
  • 💾 Clipboard Capture: Direct base64 image capture for faster performance

Tools

get_tradingview_chart_image

Description: Fetches the direct image URL for a TradingView chart snapshot with optimized concurrent performance.

Performance: This optimized version achieves 70-80% better performance for concurrent requests using browser pooling technology.

Arguments:

  • ticker (str): The TradingView ticker symbol (e.g., "BYBIT:BTCUSDT.P", "NASDAQ:AAPL"). Required.
  • interval (str): The chart time interval (e.g., '1', '5', '15', '60', '240', 'D', 'W'). Required.

Returns:

  • (str): The direct TradingView snapshot image URL (e.g., data:image/png;base64,... or https://s3.tradingview.com/snapshots/...).

Raises:

  • Error (MCP type): If the scraper encounters an error. Error codes:
    • 400: Input error (invalid ticker/interval format)
    • 503: Scraper error (failure during the scraping process)
    • 500: Unexpected internal server error

get_performance_stats

Description: Get performance statistics for the optimized TradingView MCP server.

Returns:

  • Detailed metrics about request performance, improvement over baseline, and browser pool status

Example Output:

Copy & paste — that's it
🚀 OPTIMIZED TRADINGVIEW MCP SERVER PERFORMANCE STATS
• Total Requests: 12
• Average Time: 3.30s
• Performance Improvement: 70.8%
• Browsers in Pool: 4
• Max Concurrent: 4

Prompts

  • Get the {interval} chart for {ticker}
    • Maps common timeframe names (e.g., "1 minute", "5 minute", "1 hour", "daily") to TradingView codes
  • Show me the daily TradingView chart for {ticker}
    • Specifically requests the daily ('D') chart
  • Fetch TradingView chart image for {ticker} on the {interval} timeframe
    • Comprehensive prompt with timeframe mapping

🧪 Performance Testing

Agent-Style Testing

Test the server using the same approach as the production agent:

Copy & paste — that's it
cd tests/

# Sequential performance test
python test_mcp_agent_style.py --runs 5 --ticker BYBIT:BTCUSDT.P --interval 240

# Concurrent performance test
python test_mcp_agent_style.py --concurrent 3 --ticker BYBIT:BTCUSDT.P --interval 240

# Test different symbols and timeframes
python test_mcp_agent_style.py --concurrent 4 --ticker NASDAQ:AAPL --interval 15
python test_mcp_agent_style.py --concurrent 2 --ticker BYBIT:ETHUSDT.P --interval D

Expected Results

  • Sequential: ~6-8s per request (baseline)
  • Concurrent (3x): ~2.5-3.5s per request (70-80% improvement)
  • Success Rate: 100% reliability under load
  • Throughput: Up to 4 concurrent requests efficiently handled

🔧 Technical Details

Browser Pooling Architecture

  • Pre-initialized Browsers: 4 browser instances ready for immediate use
  • Thread-Safe Pool: Concurrent access with proper locking
  • Async Semaphore: Optimal request limiting
  • Performance Tracking: Real-time statistics and monitoring
  • Graceful Cleanup: Proper browser lifecycle management

Save Shortcut Feature

The MCP_SCRAPER_USE_SAVE_SHORTCUT feature allows you to capture chart images directly to the clipboard as base64 data URLs:

Benefits:

  • Faster Performance: No HTTP requests needed
  • More Reliable: No dependency on TradingView's CDN
  • Offline Capability: Works once chart is loaded
  • Direct Integration: Base64 data URLs for immediate use

Configuration:

Copy & paste — that's it
# Enable clipboard image capture (DEFAULT)
MCP_SCRAPER_USE_SAVE_SHORTCUT=True

# Disable and use traditional screenshot links
MCP_SCRAPER_USE_SAVE_SHORTCUT=False

Deactivating the Virtual Environment

When finished:

Copy & paste — that's it
deactivate

🔄 Fallback Options

If you encounter issues with the optimized version:

  1. Disable Browser Pooling:

    Copy & paste — that's it
    python main_optimized.py --disable-pooling

  2. Use Legacy Version:

    Copy & paste — that's it
    python main.py

  3. Debug Mode:

    Copy & paste — that's it
    python main_optimized.py --log-level DEBUG

📊 Performance Monitoring

The optimized server includes built-in performance monitoring:

  • Request success rates
  • Average response times
  • Performance improvement metrics
  • Browser pool utilization
  • Concurrent request handling statistics

Access these metrics via the get_performance_stats tool or through the server logs.

🔌 Using with MCP Clients (Claude Desktop / Cursor)

This server supports two ways of providing configuration:

  1. Via .env file (for local testing): When running python main.py directly, the server will load credentials and settings from a .env file in the project directory.
  2. Via Client Environment Variables (Recommended for Integration): When run by an MCP client (like Claude/Cursor), you should configure the client to inject the required environment variables directly. These will override any values found in a .env file.

Claude Desktop

  1. Open your Claude Desktop configuration file:

    • Windows: %APPDATA%\\Claude\\claude_desktop_config.json
    • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  2. Add or merge the following within the mcpServers object. Provide your credentials in the env block:

    Copy & paste — that's it
    {
  "mcpServers": {
    "tradingview-chart-mcp": {
      "command": "/absolute/path/to/your/tradingview-chart-mcp/.venv/bin/python3",
      "args": ["/absolute/path/to/your/tradingview-chart-mcp/main.py"],
      "env": {
        "TRADINGVIEW_SESSION_ID": "YOUR_SESSION_ID_HERE",
        "TRADINGVIEW_SESSION_ID_SIGN": "YOUR_SESSION_ID_SIGN_HERE"
        // Optional: Add MCP_SCRAPER_* variables here too if needed
        // "MCP_SCRAPER_HEADLESS": "False"
      }
    }
    // ... other servers if any ...
  }
}

  3. Replace the placeholder paths (command, args) with your actual absolute paths.

  4. Replace YOUR_SESSION_ID_HERE and YOUR_SESSION_ID_SIGN_HERE with your actual TradingView credentials.

  5. Restart Claude Desktop.

Cursor

  1. Go to: Settings -> Cursor Settings -> MCP -> Edit User MCP Config (~/.cursor/mcp.json).

  2. Add or merge the following within the mcpServers object. Provide your credentials in the env block:

    Copy & paste — that's it
    {
  "mcpServers": {
    "tradingview-chart-mcp": {
      "command": "/absolute/path/to/your/tradingview-chart-mcp/.venv/bin/python3",
      "args": ["/absolute/path/to/your/tradingview-chart-mcp/main.py"],
      "env": {
        "TRADINGVIEW_SESSION_ID": "YOUR_SESSION_ID_HERE",
        "TRADINGVIEW_SESSION_ID_SIGN": "YOUR_SESSION_ID_SIGN_HERE"
        // Optional: Add MCP_SCRAPER_* variables here too if needed
        // "MCP_SCRAPER_HEADLESS": "False"
      }
    }
    // ... other servers if any ...
  }
}

  3. Replace the placeholder paths (command, args) with your actual absolute paths.

  4. Replace YOUR_SESSION_ID_HERE and YOUR_SESSION_ID_SIGN_HERE with your actual TradingView credentials.

  5. Restart Cursor.

Installing via Smithery

To install TradingView Chart Image Scraper for Claude Desktop automatically via Smithery:

Copy & paste — that's it
npx -y @smithery/cli install @ertugrul59/tradingview-chart-mcp --client claude