Equity Research Agentの機能
Equity Research Agentは、日付のある公開財務データを、編集可能なWord形式と対応するPDF形式の英語の株式調査レポートに変換します。米国株、上海A株、香港株に対応し、数値に基づく重要なポイントを維持しながら、収益性、キャッシュへの転換、バリュエーションの要因を説明します。
このプロジェクトでは、データ収集、財務計算、前提条件の確認、文書の書式設定を分離しています。決定論的な財務エンジンがバリュエーション結果をローカルで計算し、DeepSeekは投資仮説の検証や、DCFの前提条件候補の提案を支援します。
主な機能
- 3市場に対応: 米国ティッカー、6桁の上海コード、または香港株コードを選択できます。
- 明示的なバリュエーション入力: 成長率、利益率、税率、再投資、WACC、永久成長率、ROIC、株主価値へのブリッジに関する前提条件を設定できます。
- 3シナリオDCF: シナリオごとの成長率、利益率、設備投資、運転資本の変化を用いて、強気・基本・弱気のケースを確認できます。
- 編集可能な出力: Wordレポートをエクスポートでき、対応するWindows環境では一致するPDFも出力できます。
- 証拠と出所情報: 出典スナップショット、日付、通貨、ハッシュ、検証概要を保持します。
- オフライン再現: LLMへのリクエストなしで、付属の財務スナップショットを再計算できます。
ワークスペースのインストールと起動
Python 3.10以降が必要です。展開したリポジトリのディレクトリで、仮想環境を作成し、テスト依存関係を含めてプロジェクトをインストールした後、ローカルワークスペースを起動します。
python -m venv .venv
.venv/Scripts/python.exe -m pip install -e ".[test]"
.venv/Scripts/python.exe -m equity_research_agent.cli serve --port 8766
ブラウザーでhttp://127.0.0.1:8766を開きます。Windowsでは、インストール後にStart Workspace.cmdを起動することもできます。
公開データをリアルタイムで収集するにはインターネット接続が必要ですが、別途データAPIキーを用意する必要はありません。DeepSeekはオプションです。有効にするには、.env.exampleを.envにコピーし、ローカルでキーを追加します。認証情報はローカル環境に保持されます。
基本的な企業レポートを作成する
ワークスペースで市場と正確な銘柄を選択します。レポートを生成する前に、読み込まれた企業情報、報告通貨、株価通貨、データの対象範囲、利用可能なバリュエーション項目を確認します。
再現可能なオフライン例として、付属の固定NVIDIAスナップショットを使用します。
.venv/Scripts/python.exe -m equity_research_agent.cli company --market US --symbol NVDA --snapshot examples/nvda/company_snapshot.json --skip-pdfこのコマンドは保存済みの企業スナップショットを使用し、モデルへのリクエストを回避して、PDF変換を試行せずにWordレポートを生成します。同じワークフローを、適切な市場、シンボル、スナップショット、または公開データのリアルタイム入力を指定して、対応する他の銘柄にも適用できます。
DCFの前提条件を設定する
バリュエーションを左右する前提条件を、ワークスペースで直接設定します。入力できる項目には、売上成長率、営業利益率、税率、再投資、WACC、永久成長率、ROIC、企業価値から株主価値へのブリッジが含まれます。シナリオ設定では、強気・弱気ケースの成長率、利益率、設備投資、運転資本の変化を調整できます。
財務エンジンは、確認済みの入力値を使用して3つのキャッシュフローシナリオを計算します。レポートでは、バリュエーションのロジックを単一の目標値の背後に隠すのではなく、前提条件、年間FCFF計算、割引キャッシュフロー、ターミナル再投資、企業価値から株主価値へのブリッジを示します。
DeepSeekで前提条件を検討する
単に前提条件を入力するのではなく、投資仮説を検証したい場合は、ディスカッション画面を使用します。質問または仮説を入力し、必要に応じて公開ソースへのリンクを追加します。DeepSeekは取得した証拠を確認し、見解を検証し、範囲、理由、参照情報、反論を含む前提条件を提案します。
- 仮説またはバリュエーションに関する質問を入力します。
- 利用できる場合は、関連する公開ソースへのリンクを追加します。
- 提案された範囲、証拠、反論を確認します。
- 適用する提案だけを選択します。
- ローカル財務エンジンでバリュエーションの変化を確認します。
- レポートを生成する前に、必要な項目を手動で編集します。
モデルは提案と文章作成を行い、数値はローカルエンジンが計算します。DeepSeekは高い思考モードと、累計CNY 100の予算上限を既定で使用します。画面が提案をモデルに自動適用することはなく、適用はユーザーが明示的に行います。
生成されたレポートを確認する
完成したレポートには、財務分析、DCFの可視化、計算表、感応度情報、出典の制約、開示されたシナリオ前提が含まれます。バリュエーションページでは、3つのキャッシュフローシナリオに、日付付きの株価終値、株主価値へのブリッジ、ターミナル前提を組み合わせて示します。
レポート通貨と評価通貨が明確であること、株価終値の日付が記載されていること、想定が確認したいシナリオと一致していることを確認してください。サポート対象のWindows環境でPDFを書き出すには、Microsoft WordとPopplerのpdftoppmをPATHに追加するか、EQUITY_PDFTOPPM環境変数を設定する必要があります。その他のシステムでは、--skip-pdfを指定してWord文書を作成できます。
インストールを検証する
インストール後、リポジトリの公開テストスイートを実行してください。
.venv/Scripts/python.exe -m pytest tests -qリポジトリには、財務エンジン、企業レポート、レイアウト、前提条件の説明、ローカルHTTPルート、予算管理を対象とする35件の公開テストが記載されています。リリース検証では、財務再計算、デュポン恒等式、通貨換算、チャートの値、文書の整合性、データの出典も確認します。
検証によって計算と文書の整合性は確認できますが、発行体の提出書類との照合や企業固有の投資調査に代わるものではありません。
高度な利用方法と重要な制限事項
再現性のために固定スナップショットを使用する
付属のサンプルでは、保存済みの財務スナップショットとシナリオをオフラインで再生できます。新たなモデルリクエストを行わずに、テスト、レポートレイアウトの確認、提供されたサンプルの再現を行う際に便利です。
前提条件を受け入れる前に根拠を確認する
DeepSeekの提案は、範囲、理由、参照情報、反論と併せて確認してください。一般的な前提条件には企業固有の検討が必要であり、二次データの項目は発行体の提出書類との照合が必要になる場合があります。
対象セクターを理解する
銀行、保険会社、REIT、その他の金融セクターを選択した場合、企業FCFFは無効になります。年間残高についても、その後の配当、資金調達、希薄化を反映するために更新が必要になる場合があります。
新しい書き出し結果を目視で確認する
リポジトリには提供されたレポートの検証機能が含まれていますが、新たに作成した文章やレイアウトの書き出し結果には、個別の目視確認が必要です。チャート、計算表、通貨、日付、ダウンロードしたファイルが、選択した入力内容と一致していることを確認してください。
結論
Equity Research Agentは、日付が明確な公開情報から、透明性があり編集可能なリサーチへ進むための体系的な手順を提供します。ローカルにインストールし、サポート対象の証券を選択し、DCFの前提条件を確認または検討し、決定論的なエンジンでシナリオを計算して、生成されたWordまたはPDFレポートを確認してください。出力は、投資判断や確実な目標株価ではなく、条件付きのリサーチ草稿として扱ってください。