PKScreener
A Python-based stock screener for NSE, India. PKScreener is an advanced free stock screener to find potential breakout stocks from NSE and show its possible breakout values. It also helps to find the stocks which are consolidating and may breakout, or the particular chart patterns that you're looking specifically to make your decisions.
Install / Use
npx skills add pkjmesra/PKScreenerInstalls into whichever agent you are using.
README

PKScreener (# 1 Stock screener/scanner for NSE India)
| [![MADE-IN-INDIA][MADE-IN-INDIA-badge]][MADE-IN-INDIA] | [![GitHub release (latest by date)][GitHub release (latest by date)-badge]][GitHub release (latest by date)] | [![Downloads][Downloads-badge]][Downloads] | ![latest download][Latest-Downloads-badge] | [![Docker Pulls][Docker Pulls-badge]][Docker Status] |
| :-------------: | :-----------------: | :-----------------: | :-----------------: | :-----------------: |
| Platforms | [![Windows][Windows-badge]][Windows] | [![Linux(x64)][Linux-badge_x64]][Linux_x64] [![Linux(arm64)][Linux-badge_arm64]][Linux_arm64] | [![Mac OS(x64)][Mac OS-badge_x64]][Mac OS_x64] [![Mac OS(arm64)][Mac OS-badge_arm64]][Mac OS_arm64] | [![Docker Status][Docker Status-badge]][Docker Status] |
| Package / Docs | [![Documentation][Documentation-badge]][Documentation] [![OpenSSF Best Practices][OpenSSF-Badge]][OpenSSF-pkscreener] | [![PyPI][pypi-badge]][pypi] | [![is wheel][wheel-badge]][pypi] | ![github license][github-license] |
| Tests/Code-Quality | [![CodeFactor][Codefactor-badge]][Codefactor] | | [![codecov][codecov-badge]][codecov] | [![After Market][After Market-badge]][After Market] |
🚀 What is PKScreener?
PKScreener is India's #1 open-source stock screening and analysis platform for NSE traders and investors.
✨ Key Features at a Glance
| 🎯 Smart Scanning | 📊 Technical Analysis | 🤖 AI-Powered | 📱 Telegram Integration | |:------------------:|:---------------------:|:---------------:|:------------------------:| | 40+ built-in scanners | RSI, MACD, CCI, ATR | Nifty prediction | Real-time alerts | | VCP (Mark Minervini) | Chart pattern detection | ML-based signals | On-demand bot | | Custom piped scanners | Volume analysis | Trend forecasting | Scheduled scans |
💹 Trading Signals & Analysis
| Buy Signals | Sell Signals | Momentum | Patterns | |:---------------:|:----------------:|:------------:|:------------:| | Bullish crossovers | Bearish divergence | High RSI/MFI/CCI | Head & Shoulders | | Breakout detection | Death crossover | Volume breakouts | Double Top/Bottom | | Support bounces | 52-week lows | Momentum gainers | Cup & Handle | | Golden cross | Trend reversal | ATR expansion | Inside Bar |
📈 Comprehensive Market Coverage
| Telegram Alerts | Nifty AI Prediction | Scheduling Cron Jobs | On-Demand Telegram Bot | Backtesting / Growth of 10k| | :-------------: | :-----------------: | :------------------: | :--------------------: | :-----------: | | Nifty screening | Volume scanners | Breakout detection | Consolidating stocks | Reversal Signals | | Chart Patterns | CCI scanners | 2% scanners | Short-term bulls | NR4 / NR7 | Daily Releases | | Fair Value | Mutual funds, FII data | TTM Squeeze | Golden Crossover | Death Crossover| | RSI screening | MACD scanners | IPO Stocks | Momentum Gainers | Watchlist screening | | Stock Performance | 52Wk-H/L Breakouts | 10 days low breakouts | Aroon Crossover | Next Day Bullish Stocks| | Today's Breakouts | Breaking out now | Popular stocks by Mutual Funds / FIIs | Higher Highs | Lower Lows| | F&O Stocks screening | Live 5-EMA Index Scan | Logging | Telegram Channel | Early Breakouts | | ATR Cross | ATR Trailing Stops | Intraday Bid/Ask Build-up | Quick Backtest | Morning vs Day-close profit analysis | | Multiple period/duration support | Daily OHLCV | Intraday OHLCV | Auomated Software Updates| NASDAQ Index Support | | Nifty 50 | Nifty Next 50 | Nifty 100 | Nifty 200| Nifty 500 | | Nifty Smallcap 50 | Nifty Smallcap 250 | Nifty Midcap 50 | Nifty Midcap 100| Nifty Midcap 150 | | Nifty All 2000 | Nifty Newly Listed (IPOs in last 2 Year) | Nifty F&O Stocks | View Stock Performance| High Momentum(RSI,MFI,CCI) | | Intraday Monitor | Scanner pinning | Stock list Pinning | VCP (Volatility Contraction Pattern)| VCP (Mark Minervini) | | Moving Average Signals | Candle-stick Patterns | Trendline Support Stocks | Bullish/Bearish Inside Bar | Volume Spread Analysis | | Narrow Range (NRx) Reversal | Lorentzian Classifier | PSAR and RSI reversal | Rising RSI | RSI MA Reversal | | Upcoming CA stocks | High Dividend Stocks | Fair Value Buy Opportunities | Shareholding by number of Mutual Funds/FIIs | Bullish for next day |
🏆 Why Choose PKScreener?
- 🆓 100% Free & Open Source - No subscription fees for free tier, no hidden costs. High value in subscription tiers and real-time alerts for strong buy-sell signals.
- 🇮🇳 Made in India - Specifically designed for NSE/BSE markets
- ⚡ Real-time Analysis - Get live market data and instant alerts
- 📱 Multi-platform - Works on Windows, macOS, Linux, and Docker
- 🤖 Telegram Bot - Get alerts on your phone anytime, anywhere
- 📈 Backtesting - Validate strategies with historical data
- 🔧 Highly Customizable - Configure everything to match your trading style
A Python-based stock screener for NSE, India.
pkscreener is an advanced stock screener to find potential breakout stocks from NSE and tell it's possible breakout values. It also helps to find the stocks which are consolidating and may breakout, or the particular chart patterns that you're looking specifically to make your decisions. pkscreener is totally customizable and it can screen stocks with the settings that you have provided.
You can get daily scan results/alerts at scheduled times by subscribing to the following Telegram channel: | Purpose | Description/link | QR Code | | :------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------ | | Alerts Channel | https://t.me/PKScreener > You wil receive all the major alerts on this telegram channel. These alerts are sent for all major strategy scans daily around 9:30am-10:15am and then around 4pm. You will also receive the next day's market predictions. | <img src="https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/Telegram_Channel_Prod.jpg" alt="Telegram Channel" width="500"/> | | Discussion Channel | https://t.me/PKScreeners > You can discuss with other traders and community members. | <img src="https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/PKScreeners_Group.jpg" alt="Telegram Discussion Channel" width="500"/> |

Receiving Scheduled Scan results
If you would like to receive the scan results, please join the telegram channel and group above. You may receive the following scan results:
-
For all Nifty stocks at/by 9:45-10:15am and by 4pm IST, Monday - Friday
- Certain selected but configurable alerts for specific scan types
Receiving On-Demand Scan results
You can now run the pkscreenerbot on your local machine or if it's running on the GitHub server under a GitHub Actions workflow, you can use the pkscreener Bot(@nse_pkscreener_bot on Telegram) to get on-demand scan results.

Scanners
Screening options to choose from:
X > Scanners
M > Monitor Intraday
S > Strategies
B > Backtests
G > Growth of 10k
C > Analyse morning vs close outcomes
P > Piped Scanners
T > Toggle between long-term (Default) [Current (1y, 1d)] and Intraday user configuration
D > Download Daily OHLC Data for the Past Year
I > Download Intraday OHLC Data for the Last Trading Day
E > Edit user configuration
Y > View your user configuration
U > Check for software update
L > Collect Logs for Debugging
H > Help / About Developer
Multiple Indices to choose from:
W > Screen stocks from my own Watchlist
N > Nifty Prediction using Artifical Intelligence (Use for Gap-Up/Gap-Down/BTST/STBT)
E > Live Index Scan : 5 EMA for Intraday
S > Sectoral Indices
0 > Screen stocks by the stock names
1 > Nifty 50 2 > Nifty Next 50 3 > Nifty 100
4 > Nifty 200 5 > Nifty 500 6 > Nifty Smallcap 50
7 > Nifty Smallcap 100 8 > Nifty Smallcap 250 9 > Nifty Midcap 50
10 > Nifty Midcap 100 11 > Nifty Midcap 150 12 > Nifty (All Stocks)
13 > Newly Listed (IPOs in last 2 Year) 14 > F&O Stocks Only
15 > NASDAQ
Followin scanners are already implemented.
0 > Full Screening (Shows Technical Parameters without any criterion)
1 > Probable Breakouts/Breakdowns 2 > Today's Breakouts/Breakdowns
3 > Consolidating stocks 4 > Lowest Volume in last N-days (Early Breakout Detection)
5 > RSI screening 6 > Reversal Signals
7 > Stocks making Chart Patterns 8 > CCI outside of the given range
Related Skills
node-connect
385.5kDiagnose OpenClaw Android, iOS, or macOS node pairing, QR/setup code, route, auth, and connection failures.
blender-python-addon
40.5kBlender Python add-on rules for operators, panels, properties, registration, testing, and API-safe scripting
flutter-development-guidelines-cursorrules-prompt-file
40.5kCursor rules for Flutter development with MVVM architecture, Riverpod state management, Material widgets, and Dart style guidelines.
commit-push-pr
140.6kCommit, push, and open a PR
