finviz-screener

1# FinViz Screener
2 
3## Overview
4 
5Translate 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.
6 
7**Key Features:**
8- Natural language → filter code mapping (Japanese + English)
9- URL construction with view type and sort order selection
10- Elite/Public auto-detection (environment variable or explicit flag)
11- Chrome-first browser opening with OS-appropriate fallbacks
12- Strict filter validation to prevent URL injection
13 
14---
15 
16## When to Use This Skill
17 
18**Explicit Triggers:**
19- "高配当で成長している小型株を探したい"
20- "Find oversold large caps near 52-week lows"
21- "テクノロジーセクターの割安株をスクリーニングしたい"
22- "Screen for stocks with insider buying"
23- "FinVizでブレイクアウト候補を表示して"
24- "Show me high-growth small caps on FinViz"
25- "配当利回り5%以上でROE15%以上の銘柄を探して"
26 
27**Implicit Triggers:**
28- User describes stock screening criteria using fundamental or technical terms
29- User mentions FinViz screener or stock filtering
30- User asks to find stocks matching specific financial characteristics
31 
32**When NOT to Use:**
33- Deep fundamental analysis of a specific stock (use us-stock-analysis)
34- Portfolio review with holdings (use portfolio-manager)
35- Chart pattern analysis on images (use technical-analyst)
36- Earnings-based screening (use earnings-trade-analyzer or pead-screener)
37 
38---
39 
40## Workflow
41 
42### Step 1: Load Filter Reference
43 
44Read the filter knowledge base:
45…