finviz-screener

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

FinViz Screener

FinViz筛选器

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

将自然语言的股票筛选请求转换为FinViz筛选器过滤代码，构建URL并在Chrome中打开。公开筛选器无需API密钥；系统会通过

$FINVIZ_API_KEY

自动检测FINVIZ Elite以启用增强功能。

核心功能：

自然语言→过滤代码映射（日语+英语）
支持选择视图类型和排序顺序的URL构建
自动检测Elite/公开版本（通过环境变量或显式标志）
优先使用Chrome打开浏览器，适配不同操作系统的备选方案
严格的过滤验证，防止URL注入

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)

明确触发场景：

"想要寻找高分红的成长型小盘股"
"寻找接近52周低点的超卖大盘股"
"想要筛选科技板块的低估股票"
"筛选有内部人士买入的股票"
"在FinViz中显示突破候选股"
"在FinViz上为我展示高成长小盘股"
"寻找股息率5%以上且ROE15%以上的股票"

隐含触发场景：

用户使用基本面或技术面术语描述股票筛选标准
用户提及FinViz筛选器或股票过滤
用户要求寻找符合特定财务特征的股票

何时不使用：

对特定股票进行深度基本面分析（使用us-stock-analysis）
持仓组合回顾（使用portfolio-manager）
基于图片的技术形态分析（使用technical-analyst）
基于财报的筛选（使用earnings-trade-analyzer或pead-screener）

Workflow

工作流程

Step 1: Load Filter Reference

步骤1：加载过滤参考信息

Read the filter knowledge base:

bash

cat references/finviz_screener_filters.md

读取过滤知识库：

bash

cat references/finviz_screener_filters.md

Step 2: Interpret User Request

步骤2：解析用户请求

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テーマ	`theme_artificialintelligence`
Cybersecurity theme	サイバーセキュリティ	`theme_cybersecurity`
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`

将用户的自然语言请求映射为FinViz过滤代码。使用下方的通用概念映射表快速转换，并参考完整过滤列表选择精确代码。

注意： 对于范围条件（例如“股息3-8%”、“市盈率在10到20之间”），使用

{from}to{to}

范围语法作为单个过滤标记（例如

fa_div_3to8

、

fa_pe_10to20

），而非组合单独的

_o

和

_u

过滤条件。

通用概念映射表：

用户概念（英文）	用户概念（中文）	过滤代码
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主题	`theme_artificialintelligence`
Cybersecurity theme	网络安全	`theme_cybersecurity`
Yield 3-8% (trap excluded)	股息3-8%（排除陷阱）	`fa_div_3to8`
Mid-range P/E	合理市盈率区间	`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

步骤3：展示筛选条件选择

Before executing, present the selected filters in a table for user confirmation:

markdown

| Filter Code | Meaning |
|---|---|
| cap_small | Small Cap ($300M–$2B) |
| fa_div_o3 | Dividend Yield > 3% |
| fa_pe_u20 | P/E < 20 |
| geo_usa | USA |

View: Overview (v=111)
Mode: Public / Elite (auto-detected)

Ask the user to confirm or adjust before proceeding.

在执行前，以表格形式展示所选筛选条件供用户确认：

markdown

| 过滤代码 | 说明 |
|---|---|
| cap_small | 小盘股（3亿-20亿美元） |
| fa_div_o3 | 股息率>3% |
| fa_pe_u20 | 市盈率<20 |
| geo_usa | 美股 |

视图：概览 (v=111)
模式：公开版/Elite版（自动检测）

请用户在继续前确认或调整。

Step 4: Execute Script

步骤4：执行脚本

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

bash

python3 scripts/open_finviz_screener.py \
  --filters "cap_small,fa_div_o3,fa_pe_u20,geo_usa" \
  --view overview

Script arguments:

```
--filters
```
(required): Comma-separated filter codes
```
--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

运行筛选器脚本以构建URL并打开Chrome：

bash

python3 scripts/open_finviz_screener.py \
  --filters "cap_small,fa_div_o3,fa_pe_u20,geo_usa" \
  --view overview

脚本参数：

```
--filters
```
（必填）：逗号分隔的过滤代码
```
--elite
```
：强制使用Elite模式（如果未设置，将通过
```
$FINVIZ_API_KEY
```
自动检测）
```
--view
```
：视图类型——overview（概览）、valuation（估值）、financial（财务）、technical（技术面）、ownership（持仓）、performance（表现）、custom（自定义）
```
--order
```
：排序顺序（例如
```
-marketcap
```
、
```
dividendyield
```
、
```
-change
```
）
```
--url-only
```
：仅打印URL，不打开浏览器

Step 5: Report Results

步骤5：报告结果

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

打开筛选器后，报告以下内容：

构建完成的URL
使用的是Elite还是公开版本
已应用筛选条件的摘要
建议的后续操作（例如“按股息率排序”、“切换到财务视图查看详细比率”）

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

```
references/finviz_screener_filters.md
```
— 完整的过滤代码参考，包含自然语言关键词（包含行业代码示例；完整的142个代码列表在行业代码部分）
```
scripts/open_finviz_screener.py
```
— URL构建工具和Chrome打开脚本