ポートフォリオトラッカースキル
完全ローカルで動作する投資ポートフォリオトラッカー。すべてのデータは ~/.portfolio-tracker/ に保存されます。
アーキテクチャ
- データ:
~/.portfolio-tracker/data.json(ポートフォリオ、資産、価格) - 設定:
~/.portfolio-tracker/config.json(APIキー、ウォレットアドレス、ユーザープロファイル) - スクリプト: TypeScript CLIツール (
<skill-path>/scripts/内)、npx tsxで実行
初回セットアップ
スクリプトを実行する前に、依存関係をインストールしてください:
npm install --prefix <skill-path>/scripts
<skill-path> をこのスキルの実際のインストールパスに置き換えてください。
スクリプトの動作方法
各スクリプトはスタンドアロンのCLIツールです。次のように実行します:
npx tsx <skill-path>/scripts/<script>.ts <command> [args]
スクリプトは必要に応じて標準入力から読み取り、JSONを標準出力に出力します。
data-store.ts
load— ポートフォリオデータを読み込み (存在しない場合はデフォルトを作成)save— ポートフォリオデータを書き込み (JSONを標準入力から受け取る)load-config— 設定を読み込みsave-config— 設定を書き込み (JSONを標準入力から受け取る)
fetch-prices.ts
crypto <symbol>— 仮想通貨の価格を取得 (Binance → CoinGecko)stock <symbol>— 株式の価格を取得 (Yahoo Finance)fx— USD/CNY/HKDの為替レートを取得historical <symbol>— 3年分の月次履歴データを取得search <query>— 資産を名前/シンボルで検索refresh— 一括価格更新 (資産JSONを標準入力から受け取る)
binance-sync.ts
sync <apiKey> <apiSecret>— すべてのBinance残高を取得 (6つのアカウントタイプ)validate <apiKey> <apiSecret>— API認証情報を検証
ibkr-sync.ts
sync <token> <queryId>— Flex Query経由でIBKRポジションを取得validate <token> <queryId>— IBKR認証情報を検証
blockchain-sync.ts
sync <address> [chain]— ウォレット残高を取得 (単一チェーンまたは全5つのEVMチェーン)validate <address>— EVMアドレスを検証
データ型
資産 (Asset)
{
"id": "unique-id",
"type": "CRYPTO | USSTOCK | HKSTOCK | ASHARE | CASH",
"symbol": "BTC",
"name": "Bitcoin",
"quantity": 1.5,
"avgPrice": 40000,
"currentPrice": 50000,
"currency": "USD | CNY | HKD",
"transactions": [],
"source": { "type": "manual | binance | wallet | ibkr" }
}
ポートフォリオ (Portfolio)
{
"id": "unique-id",
"name": "メイン",
"assets": [...]
}
ワークフローパターン
ポートフォリオの表示
data-store.ts loadでデータを読み込みcurrentPortfolioIdで現在のポートフォリオを特定- 資産ごとに
quantity * currentPriceで合計価値を計算 exchangeRatesを使用して表示通貨に変換- フォーマットされたテーブルとして表示
資産の追加
- データを読み込み
fetch-prices.ts search <query>で資産を検索fetch-prices.ts crypto/stock <symbol>で現在価格を取得- 生成されたユニークIDとともに資産を現在のポートフォリオに追加
- データを保存
価格の更新
- データを読み込み
- 現在のポートフォリオ資産を標準入力で
fetch-prices.ts refreshにパイプ - 為替レートのために
fetch-prices.ts fxも実行 - 各資産の
currentPriceとexchangeRatesを更新 lastPriceRefreshを現在のISOタイムスタンプに設定- データを保存
取引所/ウォレットからの同期
- 設定を読み込み認証情報を取得
- 適切な同期スクリプトを実行
- 結果をマージ: 既存の資産を更新 (symbol+sourceで一致)、新しいものを追加
- データを保存
コマンド
利用可能なユーザーコマンド:
/portfolio— ポートフォリオの表示と管理/prices— すべての価格を更新/setup— APIキーとウォレットを設定/sync-binance— Binanceから同期/sync-ibkr— Interactive Brokersから同期/sync-wallet— ブロックチェーンウォレットから同期/advise— AI投資アドバイスを取得