---
id: staskh/trading_skills/scanner-bullish
version: "7be0f656"
license: MIT
install: manual
updated: 2026-07-20
---

# scanner-bullish — This skill analyzes multiple stock symbols against technical indicators—moving averages, RSI, MACD, and ADX—to identify bullish trends and rank results by composite score. Customize your scan with adjustable lookback periods and result limits. Output includes detailed indicator values, crossover timing, and earnings dates to support trading decisions.

Publisher: staskh · Stars: 299 · Updated: 2026-07-20

Install (manual): `git clone https://github.com/staskh/trading_skills`

## SKILL.md

# Bullish Scanner

Scans symbols for bullish trends and ranks them by composite score.

## Instructions

> **Note:** If `uv` is not installed or `pyproject.toml` is not found, replace `uv run python` with `python` in all commands below.

```bash
uv run python scripts/scan.py SYMBOLS [--top N] [--period PERIOD]
```

## Arguments

- `SYMBOLS` - Comma-separated ticker symbols (e.g., `AAPL,MSFT,GOOGL,NVDA`)
- `--top` - Number of top results to return (default: 30)
- `--period` - Historical period for analysis: 1mo, 3mo, 6mo (default: 3mo)

## Scoring System (max ~9.5 points)

| Indicator | Condition | Points |
|-----------|-----------|--------|
| SMA20 | Price > SMA20 | +1.0 |
| SMA50 | Price > SMA50 | +1.0 |
| RSI | 50-70 (bullish) | +1.0 |
| | 30-50 (neutral) | +0.5 |
| | <30 (oversold) | +0.25 |
| MACD | MACD > Signal | +1.0 |
| | Histogram rising | +0.5 |
| EMA9/21 | EMA9 > EMA21 (golden cross) | +0.5 |
| | EMA9 < EMA21 (death cross) | -0.25 |
| Dual crossover | Both up, both ≤10 days | +1.0 |
| | Both up, any age | +0.5 |
| | Both down, both ≤10 days | -1.0 |
| | Both down, any age | -0.5 |
| | Directions conflict | -0.5 |
| ADX | >25 with +DI > -DI | +1.5 |
| | +DI > -DI only | +0.5 |
| Momentum | period return / 20 | -1 to +2 |

## Output

Returns JSON with:
- `scan_date` - Timestamp of scan
- `symbols_scanned` - Total symbols analyzed
- `results` - Array sorted by score (highest first):
  - `symbol`, `score`, `price`
  - `next_earnings`, `earnings_timing` (BMO/AMC)
  - `period_return_pct`, `pct_from_sma20`, `pct_from_sma50`
  - `rsi`, `macd`, `macd_signal`, `macd_hist`, `adx`, `dmp`, `dmn`
  - `ema9`, `ema21` — current EMA9 and EMA21 values
  - `ema_crossover` - Most recent EMA9/EMA21 crossover (or `null` if none found):
    - `direction` - `"up"` (EMA9 crossed above EMA21 = bullish) or `"down"` (crossed below = bearish)
    - `days_ago` - Trading days since the crossover bar (0 = happened in the most recent bar)
  - `macd_crossover` - Most recent MACD crossover (or `null` if none found):
    - `direction` - `"up"` (MACD crossed above signal = bullish) or `"down"` (crossed below = bearish)
    - `days_ago` - Trading days since the crossover bar (0 = happened in the most recent bar)
  - `signals` - List of triggered conditions

## EMA Crossover Interpretation

- EMA9 > EMA21 with small `days_ago` (0-5): fresh golden cross — short-term momentum confirmed
- EMA9 just crossed below EMA21: death cross — short-term momentum turning negative
- EMA9 crossover lagging MACD crossover by days: normal — MACD leads, EMA confirms
- `null`: EMA9/21 relationship unchanged throughout the period

## MACD Crossover Interpretation

- `direction: "up"` with small `days_ago` (0-5): fresh bullish crossover — early entry signal
- `direction: "up"` from a deeply negative signal: recovery from correction
- `direction: "down"`: momentum has turned bearish regardless of score
- `null`: no sign change found in the period — trend has been consistently one-directional

## Examples

```bash
# Scan a few symbols
uv run python scripts/scan.py AAPL,MSFT,GOOGL,NVDA,TSLA

# Get top 10 from larger list
uv run python scripts/scan.py AAPL,MSFT,GOOGL,NVDA,TSLA,AMD,AMZN,META --top 10

# Use 6-month lookback
uv run python scripts/scan.py AAPL,MSFT,GOOGL --period 6mo
```

## Interpretation

- Score > 6: Strong bullish trend
- Score 4-6: Moderate bullish
- Score 2-4: Neutral/weak
- Score < 2: Bearish or no trend

## Dependencies

- `pandas`
- `pandas-ta`
- `yfinance`


## Timezone

All timestamps and time-based calculations must use the `America/New_York` timezone. All JSON output must include `generated_at` (NY time string) and `data_delay` fields.

[View on SkillFed](https://skillfed.io/staskh/trading_skills/scanner-bullish) · [View on GitHub](https://github.com/staskh/trading_skills)