Clawdfolio は何をしますか？
プロフェッショナル投資家向け定量ポートフォリオツールキット。複数証券の集約（Longport、Moomoo/Futu、デモ）、機関投資家レベルのリスク分析、オプション戦略ライフサイクル管理、20以上の自動化金融ワークフロー、CSV/JSONデータエクスポートに対応。
PyPI: pip install clawdfolio · リポジトリ: https://github.com/YichengYang-Ethan/clawdfolio · Python >= 3.10（3.10～3.13でテスト済み）
完全なPython API リファレンスは API.md を、設定・環境変数・証券会社セットアップ・モニター詳細は CONFIG.md を参照してください。
CLI コマンド
すべてのコマンドは --broker {longport,futu,demo,all}、--output {console,json}、--config PATH をサポートします。
ポートフォリオ
clawdfolio summary # ポートフォリオ概要（デフォルトコマンド）
clawdfolio summary --top 20 # 上位20銘柄を表示
clawdfolio quotes AAPL MSFT # リアルタイム株価
clawdfolio alerts # 価格・RSI・損益・集中度アラート
clawdfolio alerts --severity critical
リスク分析
clawdfolio risk # ボラティリティ、ベータ、シャープ、ソルティノ、VaR、CVaR、ドローダウン
clawdfolio risk --detailed # + RSI極値、集中度、セクターエクスポージャー、ポートフォリオRSI
算出されるリスク指標：
- ボラティリティ: 20日、60日、年率換算
- ベータ: SPY対比、QQQ対比
- シャープレシオ: 年率換算、超過リターン / 総ボラティリティ
- ソルティノレシオ: 年率換算、超過リターン / 下方ボラティリティのみ
- VaR: 95%および99%（ヒストリカル）、絶対値およびパーセンテージ
- CVaR / 期待ショートフォール: 95%および99% — VaRを超えるテールリスク
- 最大ドローダウン: 過去および現在
- HHI: ハーフィンダール・ハーシュマン集中度指数
- RSI: ポートフォリオレベルの14日RSI
- 相関: 高相関ペアの検出（0.8以上）
決算
clawdfolio earnings # 今後の決算（デフォルト14日）
clawdfolio earnings --days 30 # 30日先まで表示
DCA（ドルコスト平均法）
clawdfolio dca # ポートフォリオのDCAシグナル（リバランス＋ディップ検出）
clawdfolio dca AAPL --months 12 --amount 1000 # ヒストリカルDCAバックテスト
シグナルタイプ: REGULAR（定期）、DIP（最近の高値からの下落）、REBALANCE（目標からのウエイト乖離）。
エクスポート
clawdfolio export portfolio # CSVを標準出力
clawdfolio export portfolio --format json # JSONを標準出力
clawdfolio export risk --file risk.csv # リスク指標をファイル出力
clawdfolio export alerts --format json --file alerts.json
エクスポート対象: portfolio、risk、alerts。形式: csv、json。
オプション
clawdfolio options expiries TQQQ
clawdfolio options chain TQQQ --expiry 2026-03-21 --side calls --limit 10
clawdfolio options quote TQQQ --expiry 2026-03-21 --strike 80 --type C
clawdfolio options buyback # 設定に基づく買い戻しトリガー確認
clawdfolio options buyback --strict # トリガー対象なしの場合、終了コード1
ファイナンスワークフロー
7カテゴリにわたる20のバンドル済みワークフロー。推奨セットアップ手順：
- 証券接続の確認:
clawdfolio summary --broker demo（10のデモポジションが表示されるはず） - ワークスペースの初期化:
clawdfolio finance initを実行後、ls ~/.clawdfolio/financeで確認 - 利用可能なワークフロー一覧:
clawdfolio finance list - ワークフローの実行:
clawdfolio finance run portfolio_daily_brief_tg - 出力の確認: 機械可読な結果を得るには
--output jsonを追加。エラー時は--broker demoで再実行し、ブローカーとワークフローの問題を切り分け
clawdfolio finance list --category alerts_monitors # カテゴリでフィルタ
clawdfolio finance run dca_proposal_tg -- --budget 5000 # 追加引数を渡す
カテゴリ: portfolio_reports、briefing_cards、alerts_monitors、market_intel、broker_snapshots、strategy、security。
主要ワークフロー:
| ID | 説明 |
|---|---|
portfolio_report | パフォーマンス・リスク・保有銘柄を含む日次ポートフォリオレポート |
portfolio_daily_brief_tg | Telegram向け日次ブリーフカード |
portfolio_alert_monitor | 重複排除されたRSI・損益・集中度・価格変動アラート |
option_buyback_monitor | 状態保持型オプション買い戻しトリガーモニター |
earnings_calendar | 現在の保有銘柄の今後の決算情報 |
dca_proposal_tg | 予算制約付きDCA提案カード |
account_report | Longport + moomoo の統合スナップショット |
ワークスペース: ~/.clawdfolio/finance（--workspace で設定可能）
インストール
pip install clawdfolio # コア（yfinance + デモブローカー）
pip install clawdfolio[longport] # + Longportブローカー
pip install clawdfolio[futu] # + Moomoo/Futuブローカー
pip install clawdfolio[all] # 全ブローカー
pip install clawdfolio[dev] # + pytest, mypy, ruff（開発用）
Python API
プログラムで使用するための主要インポート：
from clawdfolio import Symbol, Position, Quote, Portfolio, RiskMetrics, Alert
from clawdfolio.brokers import get_broker
from clawdfolio.analysis.risk import analyze_risk
from clawdfolio.analysis.technical import calculate_rsi, calculate_macd
from clawdfolio.market import get_price, get_history, is_market_open
from clawdfolio.strategies.dca import DCAStrategy, calculate_dca_performance
from clawdfolio.output import export_portfolio_csv, export_risk_json
使用方法の例を含む完全なAPIリファレンスは API.md を参照してください。
設定
検索順序: --config フラグ > CLAWDFOLIO_CONFIG 環境変数 > ./config.yaml > ~/.config/clawdfolio/config.yaml。YAMLとJSONをサポート。
対応ブローカー: Longport（環境変数）、Moomoo/Futu（ローカルOpenD）、デモ（組み込み）、アグリゲーター（複数ブローカーの統合）。
設定の完全なリファレンス、環境変数、ブローカーセットアップ、モニター詳細については CONFIG.md を参照してください。