sellside-research-engine

Sellside Research Engineは、オープンソースのPythonパイプラインと静的Webダッシュボードで、株式リサーチの中核的なループを自動化します。SEC EDGAR XBRLから監査済みのファンダメンタルズ、Yahoo Finance（yfinance経由）から株価とコンセンサス予想、FREDから2年国債利回り、ECBからEUR/USDを取得し、21銘柄の米国株をスクリーニングして上位10銘柄を評価します。APIキーは不要です。 カバレッジと出力 - ユニバース：8セクターにまたがる21銘柄の米国株で、trg_workbench/config.pyのDEFAULT_US_TICKERSで設定可能。ダッシュボードはリサーチスコア上位10銘柄を表示し、更新ごとに再ランキングされます。コンプス、ファクターヒートマップ、散布図は21銘柄すべてを対象とします。 - バリュエーション：5年間の逓減予測とGordonターミナルバリューを用いたベア/ベース/ブルFCF DCF、逆DCF（現在株価が示唆する成長率）、銀行・証券・保険向けの残余利益と正当化P/B、レンジを示すフットボールフィールド、ピアマルチプル。 - リスク：ヒストリカルVaRとCVaR（95%、1日）、21日/63日ボラティリティ、S&P 500に対するベータ、シャープレシオ、ソルティノレシオ、最大ドローダウン、相関行列。 - センチメントとポジショニング：EPS修正、決算サプライズ、推奨トレンド、空売り残高、インサイダー活動。 - セクターとマクロ：S&P 500に対する10のSPDRセクターETF、ローテーションビュー、ライブの10年債、2年債、3ヶ月Tビル、VIX、DXY、WTI、EUR/USD。 - 出力：ダッシュボード用のdashboard_data.json、HTMLリサーチノート（ネイビー/ゴールドのテンプレート）、WeasyPrintによるPDF（HTMLフォールバック付き）、Markdownノート、150 DPIのPNGチャート。 仕組み CLI（main_v2.py）はfetch-all、build-report、build-allを公開し、--dry-run、--quiet、--formatsオプションを備えます。データはdata/normalized以下で正規化され、dashboard_data.jsonにエクスポートされ、実行時にJSONを読み込む単一ファイルのindex.htmlによってレンダリングされます。GitHub Actionsワークフローは平日22:00 UTCに実行され、変更があった場合のみJSONをコミットし、VercelのGit連携が各プッシュで再デプロイします。2段階ビルド（fetch-allの後にexport_dashboard_data.py --skip-fetch）もサポートされています。 方法論の注記 - FCFプロキシ = SEC純利益（Yahooフォールバック）× 0.80。WACCはBlume調整ベータと固定D/E 0.30を用いたCAPM構築を使用。リスクフリーレートはライブの10年国債利回りで、フォールバックは5.3%。 - 成長率はデフォルトでコンセンサスの+1年売上成長率、フォールバックとしてトレーリング成長率、どちらも存在しない場合は5%を使用し、-20%から50%にクランプされます。 - レーティングはコンセンサス目標株価の上昇余地から機械的に決定：+10%超でBUY、-10%未満でSELL、それ以外はHOLD。 - 欠損値はnullとして書き込まれ、n/aとして表示されます。既知のギャップには、FREDがYahooより1日遅れることや、Yahooの単日ギャップが時折発生することが含まれます。 - 経営陣コメントはSEC 8-K決算別紙に対するキーワードヒューリスティックであり、LLMではありません。CIにキャッシュされたトランスクリプトがないため、ライブサイトではn/aと表示されます。 セットアップとカスタマイズ クイックスタート：クローンし、pip install -r requirements.txt（Python 3.12）を実行し、python export_dashboard_data.pyを実行してから、python -m http.server 8000でローカルに配信します。SECはAPI利用者にSEC_USER_AGENT経由で連絡先情報を求めています。フォークとVercelインポートで個人用コピーをデプロイできます。フォークはNOTICEファイルを保持し、元のリポジトリをクレジットする必要があります。カスタマイズポイントには、ティッカー・ユニバース、build_research_datasetのファクターウェイト、valuation.pyのDCF前提、data/analyst_views.csvによるアナリストオーバーレイ（v1レポートのみ）が含まれます。pytestスイートはSEC XBRL抽出、ECB正規化、スクリーニング、DCF入力とシナリオ、逆DCF、残余利益、コンプス、リターンウィンドウ、TTM/デュポン、センチメント、JSONエクスポート、コメント抽出、テンプレート、チャートをカバーしていますが、pytest CIはまだありません。 このプロジェクトはApache 2.0でライセンスされ、投資助言ではなくリサーチおよび教育ツールとして位置付けられています。ロードマップには、10-K/10-Qインテリジェンス、モンテカルロDCF、ヒストリカルマルチプルバンド、PiotroskiおよびAltmanスコア、ティアシート、PowerPointエクスポート、Docker、pytest CIなどの計画作業が記載されています。