ポートフォリオトラッカー は何をしますか?
株式と暗号資産のポートフォリオをリアルタイム価格、損益、配当追跡で管理するCLIツール。
このスキルを使用するタイミング
以下のような場面でこのスキルを使用します:
- 株式や暗号資産の保有状況をローカルで追跡する
- リアルタイム価格と損益を取得する
- 配当利回り、Yield on Cost、予想収入を追跡する
- 今後の配当落ち日を確認する
- 複数のポートフォリオを管理する
- ポートフォリオデータをCSVにエクスポートする
ツール
このスキルは以下の機能を提供します:
1. 保有銘柄一覧
現在の評価額と損益を含む全保有銘柄を表示します。
コマンド:
npx tsx portfolio.ts list
2. 保有銘柄の追加
新しい株式または暗号資産の保有を追加します。
コマンド:
npx tsx portfolio.ts add <シンボル> <数量> <価格> <名前> [タイプ]
例:
npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto
3. 保有銘柄の売却
FIFO(先入先出法)方式で株式を売却します。
コマンド:
npx tsx portfolio.ts sell <シンボル> <数量> <価格> [日付]
例:
npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000
4. 取引履歴
全ての保有銘柄または特定のシンボルの売却履歴を表示します。
コマンド:
npx tsx portfolio.ts history [シンボル]
例:
npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL
5. 損益サマリー
実現損益と未実現損益の両方を表示します。
コマンド:
npx tsx portfolio.ts pnl
6. 配当追跡
株式保有に関する詳細な配当情報(利回り、Yield on Cost(YOC)、予想年間収入を含む)を表示します。
コマンド:
npx tsx portfolio.ts dividends
7. 配当サマリー
ポートフォリオレベルの配当サマリー(総予想収入、加重平均利回り、Yield on Cost)を表示します。
コマンド:
npx tsx portfolio.ts dividend-summary
出力内容:
- 予想年間収入の合計
- 月次/四半期収入の推定
- 全保有銘柄の加重平均利回り
- ポートフォリオのYield on Cost
- 配当支払銘柄数
8. 配当カレンダー
保有銘柄の今後の配当落ち日を表示します。
コマンド:
npx tsx portfolio.ts calendar [日数]
例:
npx tsx portfolio.ts calendar # 今後30日間
npx tsx portfolio.ts calendar 60 # 今後60日間
9. 配当付き一覧表示
listコマンドは自動的に配当データを取得します。スキップするには--no-dividendsフラグを使用します。
コマンド:
npx tsx portfolio.ts list # 配当情報付き
npx tsx portfolio.ts list --no-dividends # 配当情報をスキップ
10. 保有銘柄の削除
シンボルを指定して保有銘柄を削除します。
コマンド:
npx tsx portfolio.ts remove <シンボル>
11. ポートフォリオ評価額
ポートフォリオの総評価額と損益を表示します。
コマンド:
npx tsx portfolio.ts value
12. ポートフォリオの管理
ポートフォリオの一覧表示、切り替え、作成を行います。
コマンド:
npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "ポートフォリオ名"
npx tsx portfolio.ts create "新しいポートフォリオ"
ヒント: npm link実行後は、npx tsx portfolio.tsの代わりに短いportfolioコマンドを使用できます。
インストール
まず、必要な依存関係をインストールします:
npm install
これにより、TypeScriptランタイム(tsx)、Next.js、React、およびpackage.jsonに記載されているその他の依存関係を含む、必要なパッケージがすべてインストールされます。
オプション: グローバルにリンクして簡単にアクセスできるようにする:
npm link
リンク後は、npx tsx portfolio.ts <コマンド>の代わりにportfolio <コマンド>を使用できます。
NPMスクリプト
npm run dev # Web UIを起動(オプション)
npm run build # 本番用ビルド
Web UI(オプション)
オプションで、完全な配当追跡機能を備えたWebインターフェースを実行することもできます:
npm run dev
その後、http://localhost:3000 にアクセスしてください。
Web UIの機能:
- リアルタイムのポートフォリオ評価額と損益追跡
- 配当サマリーカード(年間収入、加重平均利回り、YOC、今後の配当落ち日)
- 銘柄ごとの詳細な配当内訳表
- 今後の配当落ち日を視覚的に表示するカレンダー
- ポートフォリオ配分のインタラクティブな円グラフ
データ保存
ポートフォリオデータはローカルのdata/portfolio.jsonに保存されます。データファイルは初回実行時に空のポートフォリオで自動的に作成されます。
機能
- Yahoo Finance APIによるリアルタイム株価取得
- CoinGecko APIによるリアルタイム暗号資産価格取得
- 複数ポートフォリオ対応
- 保有銘柄ごとの損益追跡
- 配当追跡(利回り、YOC、予想収入、配当落ち日)
- CLIおよびオプションのWebインターフェース