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:

cat references/finviz_screener_filters.md

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:

| Type | Value | Meaning |

|---|---|---|

| Theme | artificialintelligence | Artificial Intelligence |

| Sub-theme | aicloud | AI - Cloud & Infrastructure |

| Filter | cap_small | Small Cap ($300M–$2B) |

| Filter | fa_div_o3 | Dividend Yield > 3% |

| Filter | fa_pe_u20 | P/E < 20 |

| Filter | geo_usa | USA |

View: Overview (v=111)

Mode: Public / Elite (auto-detected)

Ask the user to confirm or adjust before proceeding.

Step 4: Execute Script

Run the screener script to build the URL and open Chrome:

python3 scripts/open_finviz_screener.py \

  --filters "cap_small,fa_div_o3,fa_pe_u20,geo_usa" \

  --view overview

# Theme-only screening (no --filters required)

python3 scripts/open_finviz_screener.py \

  --themes "artificialintelligence,cybersecurity" \

  --url-only

# Theme + sub-theme + filters combined

python3 scripts/open_finviz_screener.py \

  --themes "artificialintelligence" \

  --subthemes "aicloud,aicompute" \

  --filters "cap_midover" \

  --url-only

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:

• The constructed URL

• Elite or Public mode used

• Summary of applied filters

• 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.

--filters "fa_div_3to8,fa_sales5years_pos,fa_eps5years_pos,fa_divgrowth_5ypos,fa_payoutratio_u60,geo_usa"

--view financial

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).

--filters "ta_sma50_pa,ta_sma200_pa,ta_sma200_sb50,ta_highlow52w_0to25-bhx,ta_perf_26wup,sh_avgvol_o300,cap_midover"

--view technical

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.

--filters "fa_sales5years_o5,fa_eps5years_o10,fa_roe_o15,fa_salesqoq_pos,fa_epsqoq_pos,ta_perf_13wdown,ta_highlow52w_10to30-bhx,cap_large,sh_avgvol_o200"

--view overview

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.

--filters "fa_eps5years_neg,fa_epsqoq_pos,fa_salesqoq_pos,ta_highlow52w_b30h,ta_perf_13wup,cap_smallover,sh_avgvol_o200"

--view performance

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.

--filters "ta_sma50_pa,ta_sma200_pa,ta_highlow52w_b0to3h,ta_perf_4wup,sh_relvol_o1.5,sh_avgvol_o1000,cap_midover"

--view technical

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.

--themes "artificialintelligence"

--subthemes "aicloud,aicompute"

--filters "cap_midover"

--view overview

Type

Value

Purpose

Theme

artificialintelligence

AI theme universe

Sub-theme

aicloud

Cloud &#x26; Infrastructure vertical

Sub-theme

aicompute

Compute &#x26; 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:

• Start broad — use 3-4 core filters to get an initial result set

• Review count — if too many results (>100), add tightening filters; if too few (<5), relax constraints

• Switch views — start with overview for a quick scan, then switch to financial or valuation for deeper inspection

• Layer in technicals — after confirming fundamental quality, add ta_ filters to time entries

• 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