mcpField
T
trader-budget

trader-budget

github.com/jakeschincariolその他90749 回インストール2 週間前に更新
リポジトリ

trader-budget について

trader-budgetは、ポートフォリオの比率を買付金額に換算する予算管理スキルです。予算、現金バッファ、保有上限を適用して注文案を作成し、ブローカーへの接続や発注は行いません。

主な機能

  1. 01目標比率から買付金額を計算
  2. 02現金バッファと保有上限を適用
  3. 03価格を使った単元株数の計算
  4. 04注文案と未投資資金の出力

活用シーン

  1. 01コピーしたポートフォリオ比率を注文額に換算
  2. 02予算と制限に沿った資金配分
  3. 03価格を使った単元株の買付計算

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jakeschincariol/trader-skill --skill trader-budget

インストール後、Claude Code で/trader-budgetを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

config.example.json
size.py
targets.example.json

詳細

trader-budget

Budget Manager は、「このポートフォリオをコピーして」を、ユーザーが一度設定したルールの範囲内で「それぞれを正確にこの金額分買う」に変換します。書き込むのは提案のみです。trader-risk が内容を確認し、trader-broker が各注文についてユーザーに実行するかどうかを尋ねます。

以下の ${CLAUDE_SKILL_DIR} は、このスキルのフォルダー（この SKILL.md が置かれている場所）です。

python3 "${CLAUDE_SKILL_DIR}/size.py"                       # trader/targets.json + trader/config.json
python3 "${CLAUDE_SKILL_DIR}/size.py" --budget 5000 --write # write trader/orders.json
python3 "${CLAUDE_SKILL_DIR}/size.py" --whole-shares --prices trader/prices.json
python3 "${CLAUDE_SKILL_DIR}/size.py" --weights AAPL=22.04,AXP=17.14,GOOGL=12.62 --json

読み書きするファイル

file内容
trader/config.jsonルール（このフォルダーの config.example.json をひな形として使用します）
trader/targets.jsonコピーする配分。trader-copycat が書き込みます（このフォルダーの targets.example.json）
trader/prices.json単元株または株数の計算にのみ使用します（trader-alerts が書き込みます）
trader/orders.json--write を指定したときに書き込む、買い注文の提案

ステップ 1：ルールを一度設定する

trader/config.json が存在しない場合は、config.example.json を trader/config.json にコピーし、各値についてユーザーに平易な言葉で確認します。

  • budget：この目的に使う金額です。失っても構わない金額だけを設定します。
  • cash_buffer_pct：現金として残しておく割合です（デフォルトは 10）。
  • max_position_pct：予算に対する割合として、1銘柄に割り当てられる上限です（デフォルトは 25）。
  • max_order_usd と min_order_usd：1件の注文の上限額と下限額です（2000 と 5）。
  • fractional：ブローカーが端株を購入できる場合は true（Alpaca は対応しています）、単元株のみの場合は false にします。
  • blocked：絶対に保有したくないティッカーです。
  • ペーパーアカウントでの動作を確認するまでは、paper を true のままにします。

ステップ 2：金額を計算する

python3 "${CLAUDE_SKILL_DIR}/size.py" --write

計算は次の順序で行います。まず現金バッファーを差し引きます。残った銘柄の間でウェイトを再計算し、合計を 100％ にします。上限を超える銘柄は上限に固定し、超過分をほかの銘柄にウェイトに応じて配分します。上限を超える銘柄がなくなるまでこれを繰り返します。最低注文額を下回る配分は除外し、そのウェイトを再配分します。金額は整数ドルに丸め、丸めで生じた 1 ドルは、上限に達していない最大の銘柄に加えます。これにより、意図せず資金が使われずに残ることを防ぎます。実際に投資できない資金（すべての銘柄が上限に達している場合、または単元株の株価が割り切れない場合）は、「未投資額」として表示します。

ステップ 3：ユーザーに提示する

ティッカー、ウェイト、金額、上限に達した銘柄、現金バッファー、未投資額を表で提示します。ウェイトの出所と、その情報がどれくらい古いかも伝えます（13F は提出時点で最大 45 日前の情報です）。その後、/trader-risk に引き継ぎます。

例：リール

Berkshire Hathaway の 2026 年 Q2 13F（提出日：2026-08-14）の上位 5 銘柄は、Apple 22.04％、American Express 17.14％、Alphabet 12.62％、Coca-Cola 10.86％、Bank of America 9.20％です。この 5 銘柄で再計算したウェイトは、30.67／23.85／17.56／15.11／12.80 です。予算が $5,000、現金バッファーが 10％、上限が 25％ の場合：

stock金額
AAPL$1,250上限 25％
AXP$1,119
GOOGL$823
KO$708
BAC$600
現金バッファー$500
未投資額$0

最初に書き込まれる注文は次のとおりです。 {"symbol": "AAPL", "side": "buy", "notional": "1250", "type": "market", "time_in_force": "day"}。 ウェイトは小数点以下 2 桁以上で保持してください。小数点以下 1 桁に丸められたウェイト（30.7／23.9／...）では、配分額に 1 ドルの差が生じることがあります。

ルール

  • 提案のみです。このスキルがブローカーツールを呼び出すことはありません。
  • ユーザーがこの目的に使うと明言していない資金は、決して計算に含めません。予算を確認してください。
  • すべての数値は、設定、目標、価格のいずれかに基づきます。推測はしません。
  • 予測はしません。保有銘柄の価値や利益について、決して述べません。
  • 単元株の計算には trader/prices.json に記録された実際の価格が必要です。価格を捏造してはいけません。

行わないこと

注文の発注、承認、予約は行いません。独自に上限を引き上げることも、オプション、証拠金取引、空売りの金額を計算することもありません。

安全性

  • 教育およびツールの提供を目的としており、金融アドバイスではありません。ここにある内容は、価格を予測したり、利益を保証したりするものではありません。
  • デフォルトではペーパートレードです（"paper": true）。実取引を始めるかどうかは、ユーザー自身の判断であり、独自の設定で行います。
  • このパックで注文を出すのは trader-broker だけです。また、次の3つすべてを満たす場合に限られます。trader-risk が当日、その注文を承認済みであること、ユーザーがチャットでその注文について明示的に「はい」と入力すること、注文ツールが「承認が必要」に設定されているため、ユーザーが Claude 自身のカードで一度「許可」をクリックすること（カスタマイズ > コネクタ > ツールの権限）。注文ツールを「常に許可」に設定しないでください。
  • 設定で許可され、ユーザーが確認しない限り、オプション取引、証拠金取引、空売り、レバレッジは行いません。
  • ブローカーのキーは環境変数または Claude Desktop の設定に保存し、チャットには決して記載しないでください。

コメント

Markdown 対応