FinViz スクリーナー

概要

自然言語の株式スクリーニングリクエストを FinViz スクリーナーのフィルターコードに変換し、URL を構築して Chrome で開きます。公開スクリーナーに API キーは不要。FINVIZ Elite は $FINVIZ_API_KEY から自動検出され、高度な機能が利用できます。

主な特徴:

• 自然言語 → フィルターコードマッピング（日本語・英語対応）
• ビュータイプとソート順の選択を含む URL 構築
• Elite/Public の自動検出（環境変数または明示的フラグ）
• Chrome 優先のブラウザー開き（OS に応じたフォールバック対応）
• URL インジェクション防止のための厳密なフィルター検証

---

このスキルを使用する時期

明示的なトリガー:

• 「高配当で成長している小型株を探したい」
• 「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%以上の銘柄を探して」

暗黙的なトリガー:

• ユーザーがファンダメンタルズまたはテクニカル用語を使用してスクリーニング条件を説明する
• ユーザーが FinViz スクリーナーまたは株式フィルタリングに言及する
• ユーザーが特定の財務特性にマッチする銘柄を探すよう求める

使用しないケース:

• 特定の銘柄の深いファンダメンタルズ分析（us-stock-analysis を使用）
• 保有銘柄を含むポートフォリオレビュー（portfolio-manager を使用）
• 画像のチャートパターン分析（technical-analyst を使用）
• 決算ベースのスクリーニング（earnings-trade-analyzer または pead-screener を使用）

---

ワークフロー

ステップ 1: フィルターリファレンスを読み込む

フィルターナレッジベースを読み込みます:

cat references/finviz_screener_filters.md

ステップ 2: ユーザーリクエストを解釈する

ユーザーの自然言語リクエストを FinViz フィルターコードにマッピングします。以下の一般的なコンセプトマッピングテーブルを使用して迅速に翻訳し、正確なコード選択については完全なフィルターリストを参照してください。

注: 範囲条件（例: 「配当3-8%」、「PER 10～20」）には、複数の _o および _u フィルターを組み合わせるのではなく、{from}to{to} 範囲構文を単一のフィルタートークンとして使用してください（例: fa_div_3to8、fa_pe_10to20）。

一般的なコンセプトマッピング:

ユーザーコンセプト (EN)	ユーザーコンセプト (JP)	フィルターコード
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

ステップ 3: フィルター選択を提示する

実行前に、ユーザー確認用にテーブルで選択したフィルターを提示します:

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

進む前にユーザーに確認または調整を求めます。

ステップ 4: スクリプトを実行する

スクリーナースクリプトを実行して URL を構築し Chrome を開きます:

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

# テーマのみのスクリーニング（--filters 不要）
python3 scripts/open_finviz_screener.py \
  --themes "artificialintelligence,cybersecurity" \
  --url-only

# テーマ + サブテーマ + フィルター組み合わせ
python3 scripts/open_finviz_screener.py \
  --themes "artificialintelligence" \
  --subthemes "aicloud,aicompute" \
  --filters "cap_midover" \
  --url-only

スクリプト引数:

• --filters (オプション): カンマ区切りのフィルターコード。注: theme_* と subtheme_* トークンはここでは許可されていません — --themes / --subthemes を使用してください。
• --themes (オプション): カンマ区切りのテーマスラッグ（例: artificialintelligence,cybersecurity）。裸のスラッグまたは theme_ プリフィックス値を受け入れます。
• --subthemes (オプション): カンマ区切りのサブテーマスラッグ（例: aicloud,aicompute）。裸のスラッグまたは subtheme_ プリフィックス値を受け入れます。
• --elite: Elite モードを強制（設定されていない場合は $FINVIZ_API_KEY から自動検出）
• --view: ビュータイプ — overview、valuation、financial、technical、ownership、performance、custom
• --order: ソート順（例: -marketcap、dividendyield、-change）
• --url-only: ブラウザーを開かずに URL を出力

--filters、--themes、--subthemes のうち少なくとも 1 つを指定する必要があります。

ステップ 5: 結果を報告する

スクリーナーを開いた後、以下を報告します:

1. 構築された URL
2. 使用した Elite または Public モード
3. 適用されたフィルターの概要
4. 次のステップの提案（例: 「配当利回りでソート」、「財務ビューに切り替えて詳細比率を確認」）

---

使用レシピ

反復使用から抽出した実世界のスクリーニングパターン。各レシピには、スターターフィルターセット、推奨ビュー、反復的な改善のヒントが含まれています。

レシピ 1: 高配当成長株（カンチ・スタイル）

ゴール: 高利回り + 増配 + 利益成長、配当トラップを除外。

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

フィルターコード	目的
fa_div_3to8	配当利回り 3-8%（高利回りトラップを制限）
fa_sales5years_pos	ポジティブな 5 年売上成長
fa_eps5years_pos	ポジティブな 5 年 EPS 成長
fa_divgrowth_5ypos	ポジティブな 5 年配当成長
fa_payoutratio_u60	配当性向 < 60%（持続可能性）
geo_usa	米国上場株

反復的な改善: 広くスタート fa_div_o3 → 結果を確認 → fa_div_3to8 で利回りを上限設定 → fa_payoutratio_u60 でトラップを除外 → financial ビューに切り替えて配当性向と成長列を確認。

レシピ 2: Minervini トレンドテンプレート + VCP

ゴール: ステージ 2 アップトレンドでボラティリティ縮小（VCP セットアップ）の銘柄。

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

フィルターコード	目的
ta_sma50_pa	50 日 SMA 上
ta_sma200_pa	200 日 SMA 上
ta_sma200_sb50	200 SMA が 50 SMA 下（アップトレンド）
ta_highlow52w_0to25-bhx	52 週高値の 25% 以内
ta_perf_26wup	ポジティブな 26 週パフォーマンス
sh_avgvol_o300	平均ボリューム > 300K
cap_midover	中型株以上

VCP 縮小フィルター（追加で絞り込む）: ta_volatility_wo3,ta_highlow20d_b0to5h,sh_relvol_u1 — 週次ボラティリティ低、20 日高値付近、相対ボリューム以下（縮小シグナル）。

レシピ 3: 不当に売られた成長株

ゴール: ファンダメンタルズが強い企業で最近の急落 — 平均回帰の候補。

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

フィルターコード	目的
fa_sales5years_o5	5 年売上成長 > 5%
fa_eps5years_o10	5 年 EPS 成長 > 10%
fa_roe_o15	ROE > 15%
fa_salesqoq_pos	ポジティブな四半期売上成長
fa_epsqoq_pos	ポジティブな四半期 EPS 成長
ta_perf_13wdown	ネガティブな 13 週パフォーマンス
ta_highlow52w_10to30-bhx	52 週高値の 10-30% 下
cap_large	大型株
sh_avgvol_o200	平均ボリューム > 200K

レビュー後: valuation ビューに切り替えて PER と P/S をチェック。

レシピ 4: ターンアラウンド株

ゴール: 以前は利益が減少していたが今回復を示す企業 — ファンダメンタルズ確認での底値拾い。

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

フィルターコード	目的
fa_eps5years_neg	ネガティブな 5 年 EPS 成長（前回の低下）
fa_epsqoq_pos	ポジティブな四半期 EPS 成長（回復）
fa_salesqoq_pos	ポジティブな四半期売上成長（回復）
ta_highlow52w_b30h	52 週高値の 30% 以内（ボトムではない）
ta_perf_13wup	ポジティブな 13 週パフォーマンス
cap_smallover	小型株以上
sh_avgvol_o200	平均ボリューム > 200K

レシピ 5: モメンタムトレード候補

ゴール: 52 週高値付近で短期モメンタムリーダー、ボリューム増加。

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

フィルターコード	目的
ta_sma50_pa	50 日 SMA 上
ta_sma200_pa	200 日 SMA 上
ta_highlow52w_b0to3h	52 週高値の 3% 以内
ta_perf_4wup	ポジティブな 4 週パフォーマンス
sh_relvol_o1.5	相対ボリューム > 1.5 倍
sh_avgvol_o1000	平均ボリューム > 1M
cap_midover	中型株以上

レシピ 6: テーマスクリーニング（AI + サブテーマドリルダウン）

ゴール: クラウドインフラと計算加速に焦点を当てた中型株以上の AI 株を検索。

--themes "artificialintelligence"
--subthemes "aicloud,aicompute"
--filters "cap_midover"
--view overview

Type	Value	目的
Theme	artificialintelligence	AI テーマユニバース
Sub-theme	aicloud	クラウド & インフラストラクチャー垂直
Sub-theme	aicompute	コンピュート & アクセラレーション垂直
Filter	cap_midover	中型株以上

マルチテーマ例: --themes "artificialintelligence,cybersecurity" — どちらかのテーマでタグ付けされた株を選択（| グループ化経由の OR ロジック）。

ヒント: 反復的改善パターン

スクリーニングは一度の照会ではなく対話として最も効果的です:

1. 広くスタート — 3-4 個のコアフィルターを使用して初期結果セットを取得
2. 数をレビュー — 結果が多すぎる場合（> 100）は絞り込みフィルターを追加、少なすぎる場合（< 5）は制約を緩和
3. ビューを切り替え — overview で素早くスキャンしてから、より詳しく検査するために financial または valuation に切り替え
4. テクニカルをレイヤー — ファンダメンタルズの品質を確認した後、ta_ フィルターを追加してエントリーをタイミング
5. 保存して反復 — URL をブックマーク、その後 1 回に 1 つのフィルターを調整してその影響を理解

---

リソース

• references/finviz_screener_filters.md — 自然言語キーワード付き完全なフィルターコードリファレンス（業界コード例を含む、完全な 142 コードリストは業界コードセクションにあります）
• scripts/open_finviz_screener.py — URL ビルダーと Chrome オープナー