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