stock-analyzer

# Stock Deep Analyzer

One-stop comprehensive stock analysis tool that generates professional-grade investment reports.

## Features

- **Real-time Market Data** — Current price, volume, market cap, beta
- **Value Investing Metrics** — P/E, P/B, ROE, ROA, dividend yield, payout ratio
- **Technical Indicators** — MA5/20/60, RSI, MACD, Bollinger Bands, VWAP
- **Growth Analysis** — Revenue growth, earnings growth, profit margins
- **Financial Health** — Asset/liability ratio, liquidity ratio
- **Investment Rating** — Multi-dimensional scoring (value 35% / technical 25% / growth 25% / financial 15%)
- **Trading Strategies** — Long-term hold, swing trade, short-term speculation
- **Risk Assessment** — Key risks and price levels

## Dependencies

Python packages (install once):

```bash
pip install yfinance pandas numpy
```

## Usage

**IMPORTANT:** Always use the `$SKILLS_ROOT` environment variable to locate scripts.

### Basic Analysis

```bash
export PYTHONIOENCODING=utf-8
python "$SKILLS_ROOT/stock-analyzer/scripts/analyze.py" 601288.SS
```

### Specify Analysis Period

```bash
export PYTHONIOENCODING=utf-8
python "$SKILLS_ROOT/stock-analyzer/scripts/analyze.py" 000001.SZ --period 1y
```

### US Stocks

```bash
export PYTHONIOENCODING=utf-8
python "$SKILLS_ROOT/stock-analyzer/scripts/analyze.py" AAPL
```

### Parameters

| Parameter | Description | Example | Default |
|-----------|-------------|---------|---------|
| `ticker` | Stock ticker symbol (required) | 601288.SS, AAPL | - |
| `--period` | Analysis period | 1mo, 3mo, 6mo, 1y, 2y | 6mo |
| `--output` | Output format | text, json | text |

## Stock Ticker Formats

- **A-share (Shanghai)**: `600519.SS`, `601288.SS`
- **A-share (Shenzhen)**: `000001.SZ`, `002594.SZ`
- **US stocks**: `AAPL`, `TSLA`, `NVDA`
- **HK stocks**: `0700.HK`, `9988.HK`

## Output Structure

The analysis report includes 8 sections:

1. Real-time Market Overview
2. Value Investing Indicators (Score /10)
3. Technical Analysis (Score /10)
4. Growth Indicators (Score /10)
5. Financial Health (Score /10)
6. Comprehensive Investment Rating (Overall /10)
7. Recommended Trading Strategies
8. Key Risk Warnings

## Workflow

When user requests stock analysis:

1. **Identify ticker symbol**
   - User may provide company name → use web-search to find ticker
   - A-share: Shanghai = `.SS`, Shenzhen = `.SZ`

2. **Execute analysis**
   ```bash
   export PYTHONIOENCODING=utf-8
   python "$SKILLS_ROOT/stock-analyzer/scripts/analyze.py" <ticker>
   ```

3. **Interpret results**
   - Extract overall rating and key findings
   - Highlight investment recommendation
   - Emphasize risk warnings
   - Provide actionable price levels

## Limitations

- Yahoo Finance data quality varies by market
- Some metrics may be N/A for loss-making companies
- Historical data limited for newly listed stocks
- Real-time quotes may have 15-min delay

## When to Use This Skill

- User requests "深度分析", "complete analysis", "comprehensive report"
- User wants multi-dimensional evaluation (value + growth + technical)
- User needs actionable trading strategies
- User asks for investment recommendations with risk assessment