yahoo-finance

Yahoo Finance CLI

Yahoo Finance を利用した金融データターミナルです。すべてのコマンドは yf スクリプト経由で実行します。

セットアップ

スクリプトは {baseDir}/scripts/yf にあります。インラインの PEP 723 メタデータを使って uv run --script を実行するため、初回実行時に依存関係が自動でインストールされます。

chmod +x {baseDir}/scripts/yf

コマンド

コマンド	用途	例
yf price TICKER	価格、変動、出来高をすばやく確認	yf price YPF
yf quote TICKER	詳細な相場情報（52週、PE、利回り）	yf quote AAPL
yf compare T1,T2,T3	横並びの比較表	yf compare YPF,PAM,GGAL
yf credit TICKER	信用分析：レバレッジ、カバレッジ、債務の満期	yf credit YPF
yf macro	朝のマクロ経済ダッシュボード（UST、DXY、VIX、原油、金、BTC、ARS）	yf macro
yf fx [BASE]	ラテンアメリカの為替レート（ARS、BRL、CLP、MXN、COP）	yf fx USD
yf flows ETF	ETF の上位保有銘柄とファンドデータ	yf flows EMB
yf history TICKER [PERIOD]	価格履歴（1d/5d/1mo/3mo/6mo/1y/ytd/max）	yf history YPF 3mo
yf fundamentals TICKER	財務情報一式（IS、BS、CF）	yf fundamentals YPF
yf news TICKER	最近のニュース見出し	yf news YPF
yf search QUERY	ティッカーを検索	yf search "argentina bond"

すべてのコマンドで、機械可読な出力を得るために --json を指定できます。

コマンドの使い分け

• 朝の確認：yf macro → UST 利回り、DXY、VIX、コモディティ、BTC、ARS をまとめて確認
• 手早く確認：yf price TICKER → 価格、変動、出来高をすばやく確認
• 株式を詳しく分析：yf quote → yf fundamentals → yf history
• 信用分析：yf credit TICKER → レバレッジ比率、インタレストカバレッジ、債務の内訳
• 新興国市場／ラテンアメリカの為替：yf fx → USD に対する主要なラテンアメリカ通貨ペアをすべて確認
• ETF の調査：yf flows ETF → 上位保有銘柄、AUM、経費率
• 比較：yf compare → 相対価値を横並びで比較

エラー処理

スクリプトは、無効なティッカー、データの欠落、レート制限を適切に処理し、明確なエラーメッセージを表示します。Yahoo Finance によってレート制限された場合は、少し待ってから再試行してください。

出力

デフォルトでは、ターミナルで見やすく表示するために Rich のテーブルを使用します。パイプでの受け渡しや後続処理に適した構造化 JSON を出力するには、任意のコマンドに --json を追加してください。