6 ポイント 投稿者 bboydart91 29 일 전 | 1件のコメント | WhatsAppで共有

海外株に投資しながら、ポートフォリオ管理をGoogleスプレッドシートで行っていることが多い。
firmaはその不便さを解消する、ローカルファーストのCLI資産管理ツール。

主な機能

  • firma show portfolio: 保有銘柄のP&L、平均取得単価、市場価格をひと目で確認(Finnhubの自動価格同期)
  • firma add txn: 買い/売り/配当/税金の記録
  • firma report: 月別純資産の推移、キャッシュフローチャート
  • firma show earnings/financials/news <ticker>: Finnhubベースの決算/財務/ニュース照会
  • すべてのreadコマンドで--jsonをサポートし、AIがスクリプタブルに利用可能

MCP連携

firma mcp installを一度実行するだけで、Claude DesktopにMCPサーバーとして登録される。以後は次のような対話が可能になる:

"TSLA、今日はかなり下がっているけど、自分のポートフォリオでの比率はどうなってる?"
→ ClaudeがDBを直接参照し、保有数量、現在の比率、平均取得単価に対する損益をすぐに答えてくれる

"今月の支出はどうしてこんなに高いの?"
→ 月別キャッシュフローデータを分析し、前月比で比較してくれる

Claudeは単に会話するだけでなく、売買記録や残高入力まで直接処理する。

ローカルファースト

すべてのデータは~/.firma/firma.db(SQLite)にのみ保存される。外部サーバーへ送信されることはない。価格照会は自分のFinnhub APIキーで直接呼び出す。

インストール

$ npm install -g firma-app  
$ firma config set finnhub-key YOUR_KEY  
$ firma mcp install  # Claude Desktopを再起動すれば完了  

1件のコメント

 
bboydart91 29 일 전

夜明けに投稿して寝てしまったのですが、起きてみたらもう最初のコントリビューションが入っていました。ありがとうございます。

ローンチ後、ポートフォリオの数字は見えても、それが今の市場とどうつながっているのかは見えていませんでした。
金利上昇局面でテック株の比率が適切なのか、ドル高が実際にリターンへどれくらい効いているのか、といった情報が欠けていました。

そこで、素早くマクロ機能と、ポートフォリオの集中度(リスク)を判断する機能を追加しました。

  • firma show macro — FREDベースのマクロスナップショット。政策金利、国債利回り、CPI、失業率など8指標。
  • firma show concentration — HHIによるポートフォリオ集中度分析。銘柄/通貨/セクター/国別。
  • firma brief — 保有銘柄ベースの日次ブリーフィング。値動きの大きい銘柄、ニュース、決算日程。
  • ポートフォリオ全体にリアルタイムFXを反映。

Claude Desktopを通じて、「今の金利環境で自分のポートフォリオはどう?」のようなことをすぐに質問できます。