finviz-screener
Build and open FinViz screener URLs from natural language requests. Use when user wants to screen stocks, find stocks matching criteria, filter by fundamentals or technicals, or asks to open FinViz with specific conditions. Supports both Japanese and English input (e.g., "高配当で成長している小型株を探したい", "Find
By tradermonty · 2,206 installs
npx skills add tradermonty/claude-trading-skills --skill finviz-screener
Source repository · Upstream listing
FinViz Screener
Overview
Translate natural language stock screening requests into FinViz screener filter codes, build the URL, and open it in Chrome. No API key required for public screener; FINVIZ Elite is auto detected from $FINVIZ API KEY for enhanced functionality.
Key Features:
Natural language → filter code mapping (Japanese + English)
URL construction with view type and sort order selection
Elite/Public auto detection (environment variable or explicit flag)
Chrome first browser opening with OS appropriate fallbacks
Strict filter validation to prevent URL injection
When to Use This Skill
Explicit Triggers:
"高配当で成長している小型株を探したい"
"Find oversold large caps near 52 week lows"
"テクノロジーセクターの割安株をスクリーニングしたい"
"Screen for stocks with insider buying"
"FinVizでブレイクアウト候補を表示して"
"Show me high growth small caps on FinViz"
"配当利回り5%以上でROE15%以上の銘柄を探して"
Implicit Triggers:
User describes stock screening criteria using fundamental or technical terms
User mentions FinViz screener or stock filtering
User asks to find stocks matching specific financial characteristics
When NOT to Use:
Deep fundamental analysis of a specific stock (use us stock analysis)
Portfolio review with holdings (use portfolio manager)
Chart pattern analysis on images (use technical analyst)
Earnings based screening (use earnings trade analyzer or pead screener)
Workflow
Step 1: Load Filter Reference
Read the filter knowledge base:
Step 2: Interpret User Request
Map the user's natural language request to FinViz filter codes. Use the Common Concept Mapping table below for quick translation, and reference the full filter list for precise code selection.
Note: For range criteria (e.g., "dividend 3 8%", "P/E between 10 and 20"), use the {from}to{to} range syntax as a single filter token (e.g., fa div 3to8 , fa pe 10to20 ) instead of combining separate o and u filters.
Common Concept Mapping:
User Concept (EN) User Concept (JP) Filter Codes
High dividend 高配当 fa div o3 or fa div o5
Small cap 小型株 cap small
Mid cap 中型株 cap mid
Large cap 大型株 cap large
Mega cap 超大型株 cap mega
Value / cheap 割安 fa pe u20,fa pb u2
Growth stock 成長株 fa epsqoq o25,fa salesqoq o15
Oversold 売られすぎ ta rsi os30
Overbought 買われすぎ ta rsi ob70
Near 52W high 52週高値付近 ta highlow52w b0to5h
Near 52W low 52週安値付近 ta highlow52w a0to5l
Breakout ブレイクアウト ta highlow52w b0to5h,sh relvol o1.5
Technology テクノロジー sec technology
Healthcare ヘルスケア sec healthcare
Energy エネルギー sec energy
Financial 金融 sec financial
Semiconductors 半導体 ind semiconductors
Biotechnology バイオテク ind biotechnology
US stocks 米国株 geo usa
Profitable 黒字 fa pe profitable
High ROE 高ROE fa roe o15 or fa roe o20
Low debt 低負債 fa debteq u0.5
Insider buying インサイダー買い sh insidertrans verypos
Short squeeze ショートスクイーズ sh short o20,sh relvol o2
Dividend growth 増配 fa divgrowth 3yo10
Deep value ディープバリュー fa pb u1,fa pe u10
Momentum モメンタム ta perf 13wup,ta sma50 pa,ta sma200 pa
Defensive ディフェンシブ ta beta u0.5 or sec utilities,sec consumerdefensive
Liquid / high volume 高出来高 sh avgvol o500 or sh avgvol o1000
Pullback from high 高値からの押し目 ta highlow52w 10to30 bhx
Near 52W low reversal 安値圏リバーサル ta highlow52w 10to30 alx
Fallen angel 急落後反発 ta highlow52w b20to30h,ta rsi os40
AI theme AIテーマ themes "artificialintelligence"
Cybersecurity theme サイバーセキュリティ themes "cybersecurity"
AI + Cybersecurity AI&サイバーセキュリティ themes "artificialintelligence,cybersecurity"
AI Cloud sub theme AIクラウド subthemes "aicloud"
AI Compute sub theme AI半導体 subthemes "aicompute"
Yield 3 8% (trap excluded) 配当3 8%(トラップ除外) fa div 3to8
Mid range P/E 適正PER帯 fa pe 10to20
EV undervalued EV割安 fa evebitda u10
Earnings next week 来週決算 earningsdate nextweek
IPO recent 直近IPO ipodate thismonth
Target price above 目標株価以上 targetprice a20
Recent news 最新ニュースあり news date today
High institutional 機関保有率高 sh instown o60
Low float 浮動株少 sh float u20
Near all time high 史上最高値付近 ta alltime b0to5h
High ATR 高ボラティリティ ta averagetruerange o1.5
Step 3: Present Filter Selection
Before executing, present the selected filters in a table for user confirmation:
Ask the user to confirm or adjust before proceeding.
Step 4: Execute Script
Run the screener script to build the URL and open Chrome:
Script arguments:
filters (optional): Comma separated filter codes. Note: theme and subtheme tokens are not allowed here — use themes / subthemes instead.
themes (optional): Comma separated theme slugs (e.g., artificialintelligence,cybersecurity ). Accepts bare slugs or theme prefixed values.
subthemes (optional): Comma separated sub theme slugs (e.g., aicloud,aicompute ). Accepts bare slugs or subtheme prefixed values.
elite : Force Elite mode (auto detected from $FINVIZ API KEY if not set)
view : View type — overview, valuation, financial, technical, ownership, performance, custom
order : Sort order (e.g., marketcap , dividendyield , change )
url only : Print URL without opening browser
At least one of filters , themes , or subthemes must be provided.
Step 5: Report Results
After opening the screener, report:
1. The constructed URL
2. Elite or Public mode used
3. Summary of applied filters
4. Suggested next steps (e.g., "Sort by dividend yield", "Switch to Financial view for detailed ratios")
Usage Recipes
Real world screening patterns distilled from repeated use. Each recipe includes a starter filter set, recommended view, and tips for iterative refinement.
Recipe 1: High Dividend Growth Stocks (Kanchi Style)
Goal: High yield + dividend growth + earnings growth, excluding yield traps.
Filter Code Purpose
fa div 3to8 Yield 3 8% (caps high yield traps)
fa sales5years pos Positive 5Y revenue growth
fa eps5years pos Positive 5Y EPS growth
fa divgrowth 5ypos Positive 5Y dividend growth
fa payoutratio u60 Payout ratio < 60% (sustainability)
geo usa US listed stocks
Iterative refinement: Start broad with fa div o3 → review results → add fa div 3to8 to cap yield → add fa payoutratio u60 to exclude traps → switch to financial view for payout and growth columns.
Recipe 2: Minervini Trend Template + VCP
Goal: Stocks in a Stage 2 uptrend with volatility contraction (VCP setup).
Filter Code Purpose
ta sma50 pa Price above 50 day SMA
ta sma200 pa Price above 200 day SMA
ta sma200 sb50 200 SMA below 50 SMA (uptrend)
ta highlow52w 0to25 bhx Within 25% of 52W high
ta perf 26wup Positive 26 week performance
sh avgvol o300 Avg volume 300K
cap midover Mid cap and above
VCP tightening filters (add to narrow): ta volatility wo3,ta highlow20d b0to5h,sh relvol u1 — low weekly volatility, near 20 day high, below average relative volume (contraction signal).
Recipe 3: Unfairly Sold Off Growth Stocks
Goal: Fundamentally strong companies with recent sharp declines — potential mean reversion candidates.
Filter Code Purpose
fa sales5years o5 5Y sales growth 5%
fa eps5years o10 5Y EPS growth 10%
fa roe o15 ROE 15%
fa salesqoq pos Positive QoQ sales growth
fa epsqoq pos Positive QoQ EPS growth
ta perf 13wdown Negative 13 week performance
ta highlow52w 10to30 bhx 10 30% below 52W high
cap large Large cap
sh avgvol o200 Avg volume 200K
After review: Switch to valuation view to check P/E and P/S for entry attractiveness.
Recipe 4: Turnaround Stocks
Goal: Companies with previously declining earnings now showing recovery — bottom fishing with fundamental confirmation.
Filter Code Purpose
fa eps5years neg Negative 5Y EPS growth (prior decline)
fa epsqoq pos Positive QoQ EPS growth (recovery)
fa salesqoq pos Positive QoQ sales growth (recovery)
ta highlow52w b30h Within 30% of 52W high (not at bottom)
ta perf 13wup Positive 13 week performance
cap smallover Small cap and above
sh avgvol o200 Avg volume 200K
Recipe 5: Momentum Trade Candidates
Goal: Short term momentum leaders near 52W highs with increasing volume.
Filter Code Purpose
ta sma50 pa Price above 50 day SMA
ta sma200 pa Price above 200 day SMA
ta highlow52w b0to3h Within 3% of 52W high
ta perf 4wup Positive 4 week performance
sh relvol o1.5 Relative volume 1.5x
sh avgvol o1000 Avg volume 1M
cap midover Mid cap and above
Recipe 6: Theme Screening (AI + Sub theme Drill Down)
Goal: Find mid cap+ AI stocks focused on cloud infrastructure and compute acceleration.
Type Value Purpose
Theme artificialintelligence AI theme universe
Sub theme aicloud Cloud & Infrastructure vertical
Sub theme aicompute Compute & Acceleration vertical
Filter cap midover Mid cap and above
Multi theme example: themes "artificialintelligence,cybersecurity" selects stocks tagged with either theme (OR logic via grouping).
Tips: Iterative Refinement Pattern
Screening works best as a dialogue, not a one shot query:
1. Start broad — use 3 4 core filters to get an initial result set
2. Review count — if too many results ( 100), add tightening filters; if too few (<5), relax constraints
3. Switch views — start with overview for a quick scan, then switch to financial or valuation for deeper inspection
4. Layer in technicals — after confirming fundamental quality, add ta filters to time entries
5. Save and iterate — bookmark the URL, then adjust one filter at a time to understand its impact
Resources
references/finviz screener filters.md — Complete filter code reference with natural language keywords (includes industry code examples; full 142 code list is in the Industry Codes section)
scripts/open finviz screener.py — URL builder and Chrome opener