vcp-screener

Screen S&P 500 stocks for Minervini VCP patterns and generate JSON/Markdown reports.

Updated Aug 23, 2026

Search Tags:#screener #stock-analysis #vcp #minervini #trend-template #relative-strength

Ready to run

npx skills add https://github.com/PNWSkyHippy/Trading_Bot_V2 --skill vcp-screener-pnwskyhippy

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: vcp-screener
Source: https://github.com/PNWSkyHippy/Trading_Bot_V2/tree/main/claud-skills/skills/vcp-screener
Command: npx skills add https://github.com/PNWSkyHippy/Trading_Bot_V2 --skill vcp-screener-pnwskyhippy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Screen S&P 500 stocks for Mark Minervini's Volatility Contraction Pattern (VCP) to identify Stage 2 uptrends forming tight bases before breakouts, enabling disciplined entry decisions.

Core Features & Use Cases

End-to-end VCP screening pipeline: Phase 1 pre-filter, Phase 2 trend-template gate, Phase 3 VCP detection and scoring, with RS integration and pivot proximity.
Automated reporting: generates JSON results and Markdown reports including sector distribution and top candidates, ready for review.
Flexible workflow: customize universe (S&P 500 or user list), thresholds (trend score, lookback, look for breakouts), and output location.

Quick Start

Run the VCP screener with default settings to generate the top candidates and reports.

Frequently Asked Questions about vcp-screener

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I screen stocks for Minervini Volatility Contraction Pattern setups?▼

Screen S&P 500 stocks for Minervini Volatility Contraction Pattern setups by running a three-phase pipeline: pre-filtering, trend-template gating, and VCP scoring with RS integration to identify Stage 2 uptrends forming tight bases. Outputs include JSON and Markdown reports.

What is a VCP screener and how does it rank tight base patterns?▼

A VCP screener identifies Volatility Contraction Patterns by applying a trend-template gate to verify Stage 2 uptrends, then scoring contraction metrics and relative strength data. It ranks candidates by pivot proximity to highlight stocks forming tight bases before potential breakouts.

How do I find Stage 2 uptrends using a trend template?▼

Find Stage 2 uptrends by applying a trend-template gate as the second phase of the VCP screening pipeline. This filters pre-screened S&P 500 stocks against Minervini trend criteria, ensuring only stocks in confirmed uptrends forming tight bases pass through to VCP scoring.

Can I customize the stock universe and thresholds when screening for VCP setups?▼

Customize the VCP screener with a user-provided stock list instead of the default S&P 500 universe. Adjust thresholds for trend score, lookback periods, and breakout scanning to refine tight base detection, generating tailored JSON and Markdown reports.

Does the VCP screener require an FMP API key to run?▼

The VCP screener requires the FMP API to fetch historical price data for S&P 500 stocks. You need a valid FMP API key configured in your environment to execute the pre-filter, trend-template gate, and VCP scoring phases.

What reports are generated after running a Volatility Contraction Pattern scan?▼

The Volatility Contraction Pattern scan generates detailed JSON results and Markdown reports. These outputs include ranked top VCP candidates, specific VCP metrics, relative strength data, and sector distribution analysis for review.