Finviz Screener
Turn natural-language stock screen criteria into valid FinViz `f=` filter codes and screener URLs for research workflows.
Overview
Finviz-screener is an agent skill for the Idea phase that translates stock-screening intent into FinViz screener filter codes and URL parameters.
Install
npx skills add https://github.com/tradermonty/claude-trading-skills --skill finviz-screenerWhat is this skill?
- Maps FinViz filter codes to meanings and English/Japanese keywords for agent translation
- Documents public and Elite URL patterns with `v`, `f`, `o`, `s`, and optional `t` tickers
- Explains `{from}to{to}` range filter syntax for precise yield, P/E, and beta bands in URLs
- Covers signal filters (`s=`) and view types for composing screener links
- Notes finviz Python library gaps where range codes must be passed directly in `f=`
Adoption & trust: 568 installs on skills.sh; 1.8k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You know the kinds of stocks you want to find, but FinViz filter codes and range syntax are easy to get wrong in generated URLs.
Who is it for?
Indie builders researching equities, dividends, or technical signals who want agents to emit FinViz URLs without hand-editing filter strings.
Skip if: Non-trading product work, fundamental portfolio management inside a broker, or compliance-grade investment advice workflows.
When should I use this skill?
User asks to screen stocks on FinViz or needs filter codes translated from described investment or technical criteria.
What do I get? / Deliverables
You get valid `finviz.com` or `elite.finviz.com` screener links with correctly composed `f`, `o`, `s`, and view parameters from natural-language criteria.
- Composed FinViz screener URLs
- Comma-separated `f=` filter token lists
- Documented sort and signal parameters
Recommended Skills
Journey fit
Stock screening and filter mapping support early market and ticker research before you commit capital or build automation around a watchlist. FinViz screener references are research artifacts—translating intent into filter tokens—not shipping or growth analytics for an app.
How it compares
A FinViz filter lexicon for agents—not a market data API integration or automated execution skill.
Common Questions / FAQ
Who is finviz-screener for?
Solo developers and traders using AI agents to compose FinViz stock screeners from described criteria, including bilingual keyword mapping.
When should I use finviz-screener?
During Idea research when screening tickers by cap, fundamentals, technicals, or signals, or when building CLI or content tools that deep-link to FinViz.
Is finviz-screener safe to install?
The skill is documentation for public screener URLs; check the Security Audits panel on this page and avoid piping live credentials into generated links.
SKILL.md
READMESKILL.md - Finviz Screener
# FinViz Screener Filter Reference This reference maps FinViz screener filter codes to their meanings and natural-language keywords (English + Japanese). Claude uses this document to translate user intent into valid FinViz filter codes. --- ## URL Format **Public (free):** ``` https://finviz.com/screener.ashx?v={view}&f={filters}&o={order}&s={signal} ``` **Elite (paid subscription):** ``` https://elite.finviz.com/screener.ashx?v={view}&f={filters}&o={order}&s={signal} ``` **Parameters:** - `v` — View type code (see View Types below) - `f` — Comma-separated filter codes (e.g., `cap_small,fa_div_o3,fa_pe_u20`) - `o` — Sort order (optional; prefix `-` for descending, e.g., `-marketcap`) **Range Filter Pattern `{from}to{to}`:** Many filters support a range syntax: `{prefix}_{from}to{to}`. This creates a single filter that means "between {from} and {to}". - Example: `fa_div_3to8` = Dividend Yield 3% to 8% - Example: `fa_pe_10to20` = P/E 10 to 20 - Example: `ta_beta_0.5to1.5` = Beta 0.5 to 1.5 This range syntax is supported on the FinViz website but is **not registered in the finviz Python library**. Use range codes directly in the URL `f=` parameter. Range filters are more precise than combining two separate `_o` / `_u` filters, and they work as a single filter token. - `t` — Ticker symbols (optional; comma-separated, e.g., `AAPL,MSFT`) - `s` — Signal filter (optional; see Signal Filters below) --- ## Signal Filters (`s=` parameter) Signals are passed via the `s=` URL parameter (not in the `f=` filter string). Common signals: | Code | Meaning | Natural Language Keywords | |------|---------|---------------------------| | `ta_topgainers` | Top Gainers | gainers, 値上がり上位 | | `ta_toplosers` | Top Losers | losers, 値下がり上位 | | `ta_newhigh` | New High | new high, 新高値 | | `ta_newlow` | New Low | new low, 新安値 | | `ta_mostvolatile` | Most Volatile | volatile, 高ボラ | | `ta_mostactive` | Most Active | active, 活発 | | `ta_unusualvolume` | Unusual Volume | unusual volume, 異常出来高 | | `ta_overbought` | Overbought | overbought, 買われすぎ | | `ta_oversold` | Oversold | oversold, 売られすぎ | | `ta_downgrades` | Downgrades | downgrade, 格下げ | | `ta_upgrades` | Upgrades | upgrade, 格上げ | | `ta_earnbefore` | Earnings Before | earnings before market | | `ta_earnafter` | Earnings After | earnings after market | | `n_majornews` | Major News | major news, 重大ニュース | | `ta_p_wedgeup` | Wedge Up | | | `ta_p_wedgedown` | Wedge Down | | | `ta_p_tri_ascending` | Triangle Ascending | | | `ta_p_tri_descending` | Triangle Descending | | | `ta_p_channelup` | Channel Up | | | `ta_p_channeldown` | Channel Down | | | `ta_p_channel` | Channel | | | `ta_p_doubletop` | Double Top | | | `ta_p_doublebottom` | Double Bottom | | | `ta_p_headandshoulders` | Head and Shoulders | | | `ta_p_headandshouldersinv` | Head and Shoulders Inverse | | --- ## View Types | Code | Meaning | Natural Language Keywords | |------|---------|---------------------------| | `111` | Overview — ticker, company, sector, industry, country, market cap, P/E, price, change, volume | overview, 概要, 一覧 | | `121` | Valuation — market cap, P/E, Forward P/E, PEG, P/S, P/B, P/Cash, P/FCF, EPS, dividend yield | valuation, バリュエーション, 割安度 | | `131` | Ownership — market cap, outstanding shares, float, insider/institutional ownership, short float | ownership, 所有, 株主構成 | | `141` | Performance — performance periods (day to 10Y), volatility, RSI, SMA | performance, パフォーマンス, 騰落率 | | `152` | Custom — user-defined columns | custom, カスタム | | `161` | Financial — market cap, dividend yield, ROA, ROE, ROI, ratios, margins | financial, 財務, ファイナンシャル | | `171` | Technical — RSI, SMA20/50/200, 52W High/Low, pattern, candlestick, beta, ATR | technical, テクニカル, チャート指標 | --- ## Sort Order Codes | Code | Meaning | Natural Language Keywords | |------|---------|---------------------------| | `ticker` | Ticker A→Z | ticker, ティッカー | | `-ticker` | Ticker Z→A | | | `company` | Company name A→Z | compan