mcpField
D
dividend-growth-pullback-screener

dividend-growth-pullback-screener

github.com/nicepkgデータ・データベース28890 回インストール41 週間前に更新
リポジトリ

dividend-growth-pullback-screener について

長期の増配投資家向けに、堅調なファンダメンタルズと RSI の押し目条件を満たす銘柄を探すスキルです。FMP と任意の FINVIZ による事前選別を使い、順位付きの結果とレポートを作成します。

主な機能

  1. 01増配率と継続性のフィルタリング
  2. 02RSI の押し目スクリーニング
  3. 03財務健全性の分析
  4. 04総合スコアによる順位付け
  5. 05JSON と Markdown のレポート

活用シーン

  1. 01押し目局面の増配株を探す
  2. 02候補銘柄の配当持続性を比較する
  3. 03RSI とファンダメンタルズの結果を確認する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nicepkg/ai-workflow --skill dividend-growth-pullback-screener

インストール後、Claude Code で/dividend-growth-pullback-screenerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
dividend_growth_compounding.md
fmp_api_guide.md
rsi_oversold_strategy.md
scripts/
screen_dividend_growth_rsi.py

詳細

配当成長株の押し目スクリーナー

概要

このスキルは、優れたファンダメンタルズを備えながら、一時的にテクニカル面で弱含んでいる配当成長株をスクリーニングします。配当成長率が特に高い(CAGR 12%以上)一方、RSI が売られ過ぎの水準(40 以下)まで下落した銘柄を対象とし、長期的な配当成長を目指す投資家にとってのエントリー機会を探ります。

投資仮説: 高品質な配当成長株(利回りは多くの場合 1~2.5%)は、現在の高い利回りではなく、増配を通じて資産を複利で増やします。一時的な押し目(RSI 40 以下)でこうした銘柄を購入することで、堅調なファンダメンタルズの成長と有利なテクニカル上のエントリータイミングを組み合わせ、トータルリターンを高められる可能性があります。

このスキルを使用する場面

以下のような場合に、このスキルを使用してください:

  • 複利効果が特に期待できる配当成長株(配当 CAGR 12%以上)を探す場合
  • 一時的な市場の弱含み局面で、優良株へのエントリー機会を探す場合
  • 現在の利回りが低くても(1.5~3%)、より高い配当成長率を重視する場合
  • 現在の収入ではなく、5~10 年のトータルリターンを重視する場合
  • セクターローテーションや市場全体の下落が優良銘柄に影響している場合

次の場合は使用しないでください:

  • 現在の高い収入を求めている場合(代わりに value-dividend-screener を使用してください)
  • 3%を超える配当利回りがすぐに必要な場合
  • 厳格な P/E または P/B の条件を満たすディープバリュー銘柄を探している場合
  • 短期売買を重視している場合(6 か月未満)

スクリーニングのワークフロー

ステップ 1:API キーを設定する
2 段階方式(推奨)

最適なパフォーマンスを得るには、事前スクリーニングに FINVIZ Elite API を、詳細分析に FMP API を使用してください:

# Set both API keys as environment variables
export FMP_API_KEY=your_fmp_key_here
export FINVIZ_API_KEY=your_finviz_key_here

2 段階方式を使う理由

  • FINVIZ:RSI フィルターを使った高速な事前スクリーニング(API 呼び出し 1 回 → 候補約 10~50 銘柄)
  • FMP:事前スクリーニングを通過した候補のみを詳細にファンダメンタル分析
  • 結果:FMP API の呼び出し回数を抑えながら、より多くの銘柄を分析できます(無料枠の制限内に収まります)
FMP のみを使う方法(従来方式)

FINVIZ Elite にアクセスできない場合:

export FMP_API_KEY=your_key_here

制限: FMP の無料枠(1 日あたり 250 リクエスト)では、分析できる銘柄は約 40 に限られます。制限内に収めるには、--max-candidates 40 を使用してください。

ステップ 2:スクリーニングを実行する

2 段階スクリーニング(推奨):

cd dividend-growth-pullback-screener/scripts
python3 screen_dividend_growth_rsi.py --use-finviz

次の処理が実行されます:

  1. FINVIZ による事前スクリーニング:配当利回り 0.5~3%、配当成長率 10%以上、EPS 成長率 5%以上、売上成長率 5%以上、RSI 40 未満
  2. FMP による詳細分析:配当 CAGR 12%以上を検証し、正確な RSI を計算して、ファンダメンタルズを分析

FMP のみを使ったスクリーニング:

python3 screen_dividend_growth_rsi.py --max-candidates 40

カスタマイズオプション:

# Two-stage with custom parameters
python3 screen_dividend_growth_rsi.py --use-finviz --min-yield 2.0 --min-div-growth 15.0 --rsi-max 35

# FMP-only with custom parameters
python3 screen_dividend_growth_rsi.py --min-yield 2.0 --min-div-growth 10.0 --max-candidates 30

# Provide API keys as arguments (instead of environment variables)
python3 screen_dividend_growth_rsi.py --use-finviz --fmp-api-key YOUR_FMP_KEY --finviz-api-key YOUR_FINVIZ_KEY
ステップ 3:結果を確認する

スクリプトは次の 2 種類の出力を生成します:

  1. JSON ファイル: dividend_growth_pullback_results_YYYY-MM-DD.json

    • 追加分析に使用できる、すべての指標を含む構造化データ
    • 配当成長率、RSI 値、財務健全性指標を含みます
  2. Markdown レポート: dividend_growth_pullback_screening_YYYY-MM-DD.md

    • 銘柄プロフィールを含む、人が読みやすい分析
    • シナリオ別の確率評価
    • エントリータイミングの推奨
ステップ 4:条件を満たした銘柄を分析する

条件を満たした各銘柄について、レポートには次の内容が含まれます:

配当成長の概要:

  • 現在の利回りと年間配当額
  • 3 年間の配当 CAGR と一貫性
  • 配当性向と持続可能性の評価

テクニカル面のタイミング:

  • 現在の RSI 値(40 以下=売られ過ぎ)
  • RSI の状況(30 未満の極端な売られ過ぎ、または 30~40 の初期の押し目)
  • 直近のトレンドに対する値動き

品質指標:

  • 売上高と EPS の成長(事業の勢いを確認)
  • 財務健全性(負債水準、流動性比率)
  • 収益性(ROE、利益率)

投資推奨:

  • エントリータイミングの評価(すぐにエントリーするか、確認を待つか)
  • 銘柄固有のリスク要因
  • 配当成長の複利効果に基づく上昇シナリオ

スクリーニング条件の詳細

フェーズ 1:基本スクリーニング(FMP API)

初期フィルター:

  • 配当利回り ≥ 1.5%(実際の配当支払い額から算出)
  • 時価総額 ≥ $2 billion(流動性と安定性)
  • 取引所:NYSE、NASDAQ(OTC/ピンクシートを除外)

配当成長分析:

  • 3年間の配当 CAGR ≥ 12%(6年で配当が2倍)
  • 配当の安定性:過去4年間に減配なし
  • 配当性向 < 100%(持続可能性を確認)

財務健全性:

  • 3年間の売上高成長率がプラス
  • 3年間の EPS 成長率がプラス
  • 負債資本比率 < 2.0(管理可能なレバレッジ)
  • 流動比率 > 1.0(流動性)
フェーズ 2:テクニカルスクリーニング(RSI の計算)

RSI の計算:

  • 日次終値を使用した14期間の RSI
  • 計算式:RSI = 100 - (100 / (1 + RS))
    • RS = 14期間の平均上昇幅 / 平均下落幅
  • データソース:FMP の過去の株価データ(過去30日間)

RSI フィルター:

  • RSI ≤ 40(売られ過ぎ/調整の状態)
  • RSI の解釈:
    • < 30:極端な売られ過ぎ(反転の可能性)
    • 30-40:初期の調整(上昇トレンドの調整)
    • 40:売られ過ぎではない(除外)

フェーズ 3:ランキングと出力

複合スコア(0-100):

  • 配当成長(40%):CAGR の高さと安定性を評価
  • 財務品質(30%):ROE、利益率、負債水準
  • テクニカル状況(20%):RSI が低いほど、エントリーの好機として評価
  • バリュエーション(10%):参考として P/E と P/B を使用(除外基準ではありません)

銘柄は複合スコアでランキングされます。上位銘柄は、優れた配当成長と魅力的なテクニカル面でのエントリーポイントを兼ね備えています。

結果の見方

RSI 水準の解釈

RSI 25-30(極端な売られ過ぎ):

  • パニック売りや悪材料を示すことがよくあります
  • リスクは高いものの、リターンも最大になる可能性があります
  • 推奨:RSI が上向く(安定化の兆候)まで待ちます
  • エントリー:ポジションの50%から段階的に投資し、RSI が >30 になったら追加します

RSI 30-35(強い売られ過ぎ):

  • 強い上昇トレンドにおける通常の調整です
  • 極端な売られ過ぎよりリスクは低くなります
  • 推奨:すぐにポジションを開始できます
  • エントリー:ポジション全額を投資してもよく、5-8%下に損切りを設定します

RSI 35-40(初期の調整):

  • 上昇トレンドにおける軽度の弱含みです
  • さらなる下落のリスクが最も低い水準です
  • 推奨:確信度の高い銘柄に対する慎重なエントリーです
  • エントリー:ポジション全額を投資し、3-5%下にタイトな損切りを設定します
配当成長の複利計算例

配当 CAGR 12%(最低基準):

  • 初期利回り:1.5%
  • 6年目:取得価額に対する利回り 2.96%(2倍)
  • 12年目:取得価額に対する利回り 5.85%(4倍)
  • 例:Visa (V)、Mastercard (MA) の過去の推移

配当 CAGR 15%(優秀):

  • 初期利回り:1.8%
  • 6年目:取得価額に対する利回り 4.08%(2.3倍)
  • 12年目:取得価額に対する利回り 9.22%(5.1倍)
  • 例:Microsoft (MSFT) の2010-2020年の期間

配当 CAGR 20%(卓越):

  • 初期利回り:2.0%
  • 6年目:取得価額に対する利回り 6.00%(3倍)
  • 12年目:取得価額に対する利回り 18.0%(9倍)
  • 例:Apple (AAPL) の2012-2020年の期間

重要なポイント: 10年以上の期間では、初期利回りが低くても成長率が高い方が、初期利回りが高くても成長率が低い場合を上回ります。

トラブルシューティング

結果が見つからない場合

考えられる原因:

  1. 市場環境: 強い強気相場で、売られ過ぎの銘柄が少ない
  2. 条件が厳しすぎる: 配当成長率 12% はまれです(通常、条件を満たすのは5~10銘柄)
  3. RSI のしきい値が低すぎる: 候補を増やすには RSI ≤45 への引き上げを検討してください

解決策:

  • RSI のしきい値を緩和します:--rsi-max 45(初期の調整局面)
  • 配当成長率を引き下げます:--min-div-growth 10.0(それでも優れた成長率です)
  • 最低利回りを引き下げます:--min-yield 1.0(より多くの成長株を対象にします)
API レート制限に到達しました

FMP 無料プランの制限:

  • 1 日あたり 250 リクエスト
  • 分析する銘柄ごとに API 呼び出しが 6 回必要です(株価、配当、価格、損益計算書、貸借対照表、キャッシュフロー、指標)
  • FMP のみを使用するモードでは、1 日あたり最大約 40 銘柄です

解決策:

1. FINVIZ を使った 2 段階のアプローチ(推奨)

python3 screen_dividend_growth_rsi.py --use-finviz
  • FINVIZ による事前スクリーニング:API 呼び出し 1 回 → 候補銘柄 10~50 件(RSI で絞り込み済み)
  • FMP による分析:6 回 × 10~50 銘柄 = FMP の呼び出し 60~300 回
  • メリット:FINVIZ の RSI フィルターによって候補が大幅に絞られるため、FMP の制限内に収まります

2. FMP のみを使う場合は候補数を制限する

python3 screen_dividend_growth_rsi.py --max-candidates 40

3. レート制限がリセットされるまで 24 時間待つ

  • FMP の制限は UTC の午前 0 時にリセットされます

4. FMP の有料プランにアップグレードする

  • Starter(月額 $14):1 日あたり 500 リクエスト
  • Professional(月額 $29):1 日あたり 1,000 リクエスト

**注記:**この用途では、FINVIZ Elite サブスクリプション(月額 $40)と FMP 無料プランの組み合わせのほうが、FMP の有料プランよりも費用対効果に優れています。

RSI の計算エラー

問題:「RSI の計算に必要な価格データが不足しています」

**原因:**銘柄の取引履歴が 30 日未満です(IPO または取引停止中)

**解決策:**スクリプトは、データが不足している銘柄を自動的にスキップします。対応は不要です。

他のスキルとの組み合わせ

事前スクリーニングのコンテキスト:

  1. Market News Analyst → セクターのローテーションや市場の下落を特定します
  2. Breadth Chart Analyst → 市場全体の売られ過ぎの状況を確認します
  3. Economic Calendar Fetcher → 今後の金利決定やマクロ経済イベントを確認します

スクリーニング後の分析:

  1. Technical Analyst → 条件を満たした候補銘柄の個別チャートを分析します
  2. US Stock Analysis → エントリー前に特定銘柄を詳しく調査します
  3. Backtest Expert → RSI と増配戦略の過去の実績を検証します

ワークフローの例:

1. Market News Analyst: "Market pulled back 5% this week on Fed hawkish comments"
2. Breadth Chart Analyst: Confirms market oversold (S&P breadth weak)
3. Dividend Growth Pullback Screener: Finds 8 quality dividend growers with RSI <35
4. Technical Analyst: Analyze top 3 candidates for support levels and entry timing
5. Execute: Enter scaled positions with 6-12 month time horizon

リソース

scripts/

screen_dividend_growth_rsi.py - メインのスクリーニングスクリプト

  • FMP API を統合してファンダメンタルデータを取得します
  • 過去の価格から 14 期間 RSI を計算します
  • 複数段階のフィルタリングとランキングを適用します
  • JSON と Markdown のレポートを出力します
references/

rsi_oversold_strategy.md - RSI 指標の解説

  • RSI による売られ過ぎの状況の特定方法
  • 極端な売られ過ぎ(30 未満)と早期の下落(30~40)の違い
  • RSI とファンダメンタル分析の組み合わせ
  • 偽陽性への対処とリスク軽減

dividend_growth_compounding.md - 配当成長の数学的解説

  • 12%以上の配当 CAGR が長期的に持つ力
  • 利回りと成長率のトレードオフ
  • 過去の例(MSFT、V、MA、AAPL)
  • 増配株の品質特性

fmp_api_guide.md - API 使用方法のドキュメント

  • API キーの設定と管理
  • スクリーニング用エンドポイントのドキュメント
  • レート制限への対処方法
  • エラー処理とトラブルシューティング

**免責事項:**このスクリーニングツールは情報提供のみを目的としています。過去の増配実績は、将来の成果を保証するものではありません。投資判断を行う前に、十分なデューデリジェンスを実施してください。RSI が売られ過ぎの状態であっても、価格の反転が保証されるわけではありません。銘柄は長期間にわたって売られ過ぎの状態が続く場合があります。

コメント