trading-analyzer

# Trading Analyzer Skill

Multi-source market analysis combining cryptocurrency and stock data with AI-powered insights.

## Quick Start

### Analyze Cryptocurrency

```bash
# List available TradingView tools
mcporter list tradingview-mcp

# Analyze a specific coin
mcporter call tradingview-mcp.coin_analysis symbol=BTCUSDT exchange=BINANCE timeframe=15m

# Find bullish coins
mcporter call tradingview-mcp.top_gainers exchange=BINANCE timeframe=4h limit=25

# Detect volume breakouts
mcporter call tradingview-mcp.volume_breakout_scanner exchange=KUCOIN timeframe=15m volume_multiplier=2.0
```

### Analyze Stock

```bash
# List available Alpha Vantage and Yahoo Finance tools
mcporter list alphavantage
mcporter list yahoo-finance-server

# Get company fundamentals
mcporter call alphavantage.get_ticker_info symbol=AAPL

# Fetch latest news
mcporter call yahoo-finance-server.get_ticker_news symbol=AAPL count=10

# Get stock price history
mcporter call alphavantage.get_price_history symbol=AAPL period=1y interval=1d

# Get earnings data
mcporter call alphavantage.ticker_earning symbol=AAPL period=quarterly
```

## Common Use Cases

### 1. Quick Crypto Analysis

```bash
# 1. Get immediate technical overview
mcporter call tradingview-mcp.coin_analysis symbol=BTCUSDT

# 2. Identify breakout opportunities
mcporter call tradingview-mcp.smart_volume_scanner \
  exchange=BINANCE min_volume_ratio=2.0 min_price_change=2.0

# 3. Find bullish signals
mcporter call tradingview-mcp.top_gainers exchange=BINANCE timeframe=4h
```

### 2. Fundamental Stock Research

```bash
# 1. Get company metrics
mcporter call alphavantage.get_ticker_info symbol=TSLA

# 2. Get sentiment from latest news
mcporter call yahoo-finance-server.get_ticker_news symbol=TSLA count=5

# 3. Confirm trend with historical data
mcporter call alphavantage.get_price_history symbol=TSLA period=1y interval=1d
```

### 3. Market Screening

Use crypto screeners to identify opportunities:

```bash
# Top performers
mcporter call...

# Trading Analyzer Skill

A comprehensive multi-source trading analysis tool that combines cryptocurrency, stock, and market intelligence data into unified analysis reports with price trends, technical indicators, and sentiment analysis.

## Features

- **Cryptocurrency Analysis**: Real-time TradingView data with technical indicators
- **Stock Analysis**: Fundamental metrics, earnings data, and news sentiment from Yahoo Finance & Alpha Vantage
- **Market Screening**: Identify opportunities through volume, momentum, and pattern analysis
- **Unified Reports**: Consolidated analysis combining multiple data sources
- **Sentiment Analysis**: Latest news and market sentiment tracking

## Prerequisites

- **Node.js** 14+ or higher
- **Python 3.7+**
- **mcporter** - MCP (Model Context Protocol) tool manager

## Installation

MCPorter is a TypeScript runtime and CLI toolkit that auto-discovers MCP servers already configured in your AI editors (Cursor, Claude Desktop, Codex, Windsurf, VS Code, etc.). You have multiple installation options:

### Option 1: Run Instantly (No Installation Required)

Use `npx` to run mcporter immediately without installing globally:

```bash
# List available MCP servers
npx mcporter list

# Call a specific MCP tool
npx mcporter call tradingview-m.coin_analysis symbol=BTCUSDT exchange=BINANCE timeframe=15m
```

**Best for**: Quick testing and one-off commands

### Option 2: Install Globally (Recommended for Regular Use)

Install via your preferred package manager:

**npm:**

```bash
npm install -g mcporter
```

**pnpm:**

```bash
pnpm add -g mcporter
```

**Homebrew (macOS/Linux):**

```bash
brew tap steipete/tap
brew install steipete/tap/mcporter
```

Verify installation:

```bash
mcporter --version
mcporter list
```

### Option 3: Add to Your Project

For Node.js projects, add mcporter as a dev dependency:

```bash
pnpm add -D mcporter
# or
npm install --save-dev mcporter
```

Then use via `pnpm mcporter` or `npm exec mcporter`.

### Step 2: Conf...