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.
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
# 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.
1---2name: scanner-bullish3description: Scan stocks for bullish trends using technical indicators (SMA, RSI, MACD, ADX). Use when user asks to scan for bullish stocks, find trending stocks, or rank symbols by momentum.4dependencies: ["trading-skills"]5metadata:6 source: https://skillmd.com/skills/staskh/scanner-bullish7---89# Bullish Scanner1011Scans symbols for bullish trends and ranks them by composite score.1213## Instructions1415> **Note:** If `uv` is not installed or `pyproject.toml` is not found, replace `uv run python` with `python` in all commands below.1617```bash18uv run python scripts/scan.py SYMBOLS [--top N] [--period PERIOD]19```2021## Arguments2223- `SYMBOLS` - Comma-separated ticker symbols (e.g., `AAPL,MSFT,GOOGL,NVDA`)24- `--top` - Number of top results to return (default: 30)25- `--period` - Historical period for analysis: 1mo, 3mo, 6mo (default: 3mo)2627## Scoring System (max ~9.5 points)2829| Indicator | Condition | Points |30|-----------|-----------|--------|31| SMA20 | Price > SMA20 | +1.0 |32| SMA50 | Price > SMA50 | +1.0 |33| RSI | 50-70 (bullish) | +1.0 |34| | 30-50 (neutral) | +0.5 |35| | <30 (oversold) | +0.25 |36| MACD | MACD > Signal | +1.0 |37| | Histogram rising | +0.5 |38| EMA9/21 | EMA9 > EMA21 (golden cross) | +0.5 |39| | EMA9 < EMA21 (death cross) | -0.25 |40| Dual crossover | Both up, both ≤10 days | +1.0 |41| | Both up, any age | +0.5 |42| | Both down, both ≤10 days | -1.0 |43| | Both down, any age | -0.5 |44| | Directions conflict | -0.5 |45| ADX | >25 with +DI > -DI | +1.5 |46| | +DI > -DI only | +0.5 |47| Momentum | period return / 20 | -1 to +2 |4849## Output5051Returns JSON with:52- `scan_date` - Timestamp of scan53- `symbols_scanned` - Total symbols analyzed54- `results` - Array sorted by score (highest first):55 - `symbol`, `score`, `price`56 - `next_earnings`, `earnings_timing` (BMO/AMC)57 - `period_return_pct`, `pct_from_sma20`, `pct_from_sma50`58 - `rsi`, `macd`, `macd_signal`, `macd_hist`, `adx`, `dmp`, `dmn`59 - `ema9`, `ema21` — current EMA9 and EMA21 values60 - `ema_crossover` - Most recent EMA9/EMA21 crossover (or `null` if none found):61 - `direction` - `"up"` (EMA9 crossed above EMA21 = bullish) or `"down"` (crossed below = bearish)62 - `days_ago` - Trading days since the crossover bar (0 = happened in the most recent bar)63 - `macd_crossover` - Most recent MACD crossover (or `null` if none found):64 - `direction` - `"up"` (MACD crossed above signal = bullish) or `"down"` (crossed below = bearish)65 - `days_ago` - Trading days since the crossover bar (0 = happened in the most recent bar)66 - `signals` - List of triggered conditions6768## EMA Crossover Interpretation6970- EMA9 > EMA21 with small `days_ago` (0-5): fresh golden cross — short-term momentum confirmed71- EMA9 just crossed below EMA21: death cross — short-term momentum turning negative72- EMA9 crossover lagging MACD crossover by days: normal — MACD leads, EMA confirms73- `null`: EMA9/21 relationship unchanged throughout the period7475## MACD Crossover Interpretation7677- `direction: "up"` with small `days_ago` (0-5): fresh bullish crossover — early entry signal78- `direction: "up"` from a deeply negative signal: recovery from correction79- `direction: "down"`: momentum has turned bearish regardless of score80- `null`: no sign change found in the period — trend has been consistently one-directional8182## Examples8384```bash85# Scan a few symbols86uv run python scripts/scan.py AAPL,MSFT,GOOGL,NVDA,TSLA8788# Get top 10 from larger list89uv run python scripts/scan.py AAPL,MSFT,GOOGL,NVDA,TSLA,AMD,AMZN,META --top 109091# Use 6-month lookback92uv run python scripts/scan.py AAPL,MSFT,GOOGL --period 6mo93```9495## Interpretation9697- Score > 6: Strong bullish trend98- Score 4-6: Moderate bullish99- Score 2-4: Neutral/weak100- Score < 2: Bearish or no trend101102## Dependencies103104- `pandas`105- `pandas-ta`106- `yfinance`107108109## Timezone110111All 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.