Communitygithub.com

InvestorClaw

決定論的なポートフォリオ分析ツール — 保有銘柄、パフォーマンス、シャープレシオ・ソルティノレシオ、FREDイールドカーブ、債券デュレーション、セクター内訳、シナリオリバランス。無料(Yahoo Finance)、APIキー不要。オプションでMassiveキーにより先物・プレミアムデータ利用可能。

InvestorClaw とは?

InvestorClawは、エージェントがポートフォリオ分析を完全に決定論的かつ安全に行うためのスキルです。Yahoo Financeをデフォルトデータソースとし、追加のAPIキーを必要とせず、株価、パフォーマンス指標(リターン、損益、騰落銘柄)、リスク指標(シャープレシオ、ソルティノレシオ)、FREDイールドカーブ、債券デュレーション、セクター内訳など、幅広い情報を提供します。各ツール結果はHMAC署名付きエンベロープで返されるため、エージェントはその署名されたデータのみを信頼し、自身の学習知識で補完してはなりません。Claude Code、Claude Desktop、Cursor、CodexなどMCP対応のエージェントプラットフォームに対応しており、Dockerコンテナとして動作します。設計思想としては、「データの完全性」と「監視エージェントの自律性」を重視しており、価格やパーセンテージなど数値に関するあらゆる記述は、必ず同一ターン内のInvestorClawツール結果に基づく必要があります。これにより、幻覚のない金融データ分析が保証されます。スキルには、ポートフォリオのリアルタイムスナップショット、期間指定のパフォーマンス分析、自由質問への回答機能が含まれます。自動実行のモニタリングエージェント向けには、閾値超過時のアラート発行や定期レポート生成といった定型動作も定義されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add argonautsystems/InvestorClaw

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

権威ある運用契約(Authoritative Operating Contract)

このスキルを使用するすべてのエージェントは、以下のルールに従わなければなりません。このファイル内のその他の例は、あくまで参考であり、決してこれらのルールを上書きしません。

データの完全性 — InvestorClawが唯一の信頼できる情報源であること

  • エージェントが提示するすべての価格、パーセンテージ、金額、市場事実は、同一ターン内のInvestorClawツール結果から取得しなければなりません。InvestorClawはHMAC署名付きエンベロープを返します。その署名済みデータが唯一の信頼できる情報源です。
  • いかなる数値についても、発明、推定、推測、またはモデル自身の学習知識を使用してはなりません。ツールがこのターンにデータを返さなかった場合、その数値を述べてはならず、「InvestorClawはそのデータを返しませんでした」と言わなければなりません。
  • 具体的な数値を含まないツールの散文は「データなし」を意味します。それを数値に変換してはなりません。

現在のツールインターフェース(アンダースコア名前空間)

  • investorclaw__portfolio_market_snapshot(symbols?, benchmarks?) — 保有銘柄とベンチマーク(SPX/NDX/DJI/VIX、BTC/ETH)のリアルタイム価格 + 日中変動率。symbols はカンマ区切り文字列(例: "NVDA,AAPL")であり、リストではありません。引数なし = 保有銘柄 + ベンチマーク。"Xの価格" を聞かれたとき、および市場と比較してポートフォリオを読み取るためには、このツール(portfolio_askではなく)を使用します。
  • investorclaw__portfolio_performance_window(period=...) — 指定期間のリターン / 損益 / 騰落銘柄。period: 1d, 1w, 1mo, 1y, 5y, 10y, 20y, max、または自然言語フレーズ("today", "last week", "last year", "entire history")。
  • investorclaw__portfolio_ask(question=...) — 分析 / 説明。

古い investorclaw.* ドット名前空間の以下の例は古くなっています。上記のアンダースコア形式が現在のツール名です。

自律的 / 常時稼働監視エージェント

無人エージェント(スケジュール型モニターおよびアラート通知エージェント、例:MarketWatchエージェント)については、上記の契約に加えて以下を遵守します。

  • 各実行は最初にツール呼び出しから開始します。メモリから市場の質問に答えてはいけません。スケジュールされた「ポーリング」は portfolio_market_snapshot を呼び出すことを意味します。
  • 閾値スキャン:portfolio_market_snapshot を呼び出し、次に、保有銘柄またはベンチマークが設定された変動(例:保有銘柄±3%、VIX±10%)を超えた場合にのみ、1行のみの簡潔なメッセージを出力します。超えない場合は、単一の NO_ALERT トークンを出力して停止します。
  • 必要なツールがエラーを返した場合、またはデータを返さなかった場合は、OPS_FAIL market_snapshot unavailable のような固定マーカーを出力して停止します。ギャップを埋めるために安心させるような数値を捏造してはいけません。
  • 無人モードでは明確化の質問はせず、意図をマッピングして行動します。
  • 定期的 / 営業時間終了時(EOD)レポート:先に portfolio_performance_window をその期間分呼び出し、次に portfolio_market_snapshot でインデックス終値を取得し、数値をそのまま報告します。
  • 常に、同一スナップショット内のベンチマークとの関連で保有銘柄を読み取ります。
  • 配信はプッシュ、簡潔、数値優先です。教育的であり、個別のアドバイスではありません。

InvestorClaw は何をしますか?

このリポジトリはInvestorClawの統括プロジェクトです — README、ライセンス、回帰テストハーネス、そして公開インターフェースを含みます。ClawHubが公開するエージェント可読なSKILL.mdは、ランタイムリポジトリにあります。

  • Docker化されたv4.xランタイム + ClawHub公開SKILL.md: mnemos-os/mnemos-ic-runtime
  • Claude Code / Claude Desktopプラグイン(コンテナ優先、このリポジトリ): /plugin marketplace add argonautsystems/InvestorClaw — 他のランタイムと同じスキル + コンテナです。詳細は docs/GETTING_STARTED.md を参照してください。
  • エンジンソース(Pythonアナライザー): argonautsystems/ic-engine

インストール(v4.x Docker化ランタイム)

git clone https://github.com/mnemos-os/mnemos-ic-runtime.git ~/.investorclaw
cd ~/.investorclaw
mkdir -p portfolios
docker compose up -d

このcomposeは `ghcr.io/argonautsystems/ic-engine:4.7.7-cpu`(公開ホスト、認証不要)をプルし、`localhost:18090`(MCP + REST)および`localhost:18092`(ダッシュボード)で実行します。

完全なエージェント可読仕様(12ツールカタログ、初回実行タイムライン、ランタイム別設定ブロック、トラブルシューティング)については、公開されているランタイムリポジトリのSKILL.mdを参照してください。

ドキュメント

この統括リポジトリには、包括的なドキュメントセットが含まれています。

  • README.md — 機能、クイックスタート、モデル + APIキーの推奨事項
  • STONKMODE.md — ナレーション付きコメンタリーモード
  • CAPABILITIES.md — 全機能カタログ
  • PRIVACY.md — データ取り扱いポリシー
  • DISCLAIMER.md — 教育目的の利用に関する免責事項
  • SECURITY.md — 脆弱性情報開示
  • CHANGELOG.md — リリース履歴
  • docs/ — EODレポート、用語集、哲学、インストールモデル、COBOLテスト、MCPツールリファレンス、Stonkmodeアーキテクチャ + アバター凡例、Windowsセットアップガイド
  • docs/references/ — 入力 / 出力 / スキーマ / コンサルティングLLM契約

ライセンス

  • この統括リポジトリ:Apache 2.0(実質的なコード)+ MIT-0(SKILL.md、エージェントスキル成果物)。
  • ファイルごとのSPDX-License-Identifierヘッダーが該当するライセンスを示します。

InvestorClawは教育目的のみです。財務アドバイスではありません。

関連スキル