Communitygithub.com

argonautsystems/InvestorClaw

Analyseur de portefeuille déterministe — positions, performance, ratios Sharpe et Sortino, courbes de rendement FRED, duration obligataire, répartitions sectorielles, rééquilibrage par scénario. Gratuit par défaut (Yahoo Finance), sans clé API requise ; clé Massive optionnelle pour données à terme et premium.

Qu'est-ce que InvestorClaw ?

InvestorClaw est un analyseur de portefeuille conçu pour les agents IA, garantissant une exactitude déterministe en exigeant que chaque chiffre provienne directement de ses outils lors du même tour d’exécution. Il prend en charge les runtime Dockerisés (MCP + REST) pour Claude Code, Claude Desktop, Cursor et d’autres plateformes, via un plugin ou un déploiement autonome. Ses fonctionnalités incluent l’instantané de marché en temps réel, les fenêtres de performance, les ratios de risque (Sharpe, Sortino), les courbes de rendement FRED, la duration obligataire, les répartitions sectorielles, et le rééquilibrage par scénario. Les données proviennent par défaut de Yahoo Finance (gratuit, sans clé API) ; une clé Massive optionnelle déverrouille les données à terme et premium. Pour les agents de surveillance autonome, un protocole strict empêche toute invention de données et oblige à signaler les pannes par un jeton fixe comme NO_ALERT ou OPS_FAIL.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add argonautsystems/InvestorClaw

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Contrat de fonctionnement impératif

Ces règles régissent tout agent utilisant cette compétence. Les exemples ailleurs dans ce fichier sont uniquement des références et ne les remplacent jamais.

Intégrité des données — InvestorClaw est la seule source de vérité

  • Chaque prix, pourcentage, montant en dollars ou fait de marché qu’un agent énonce DOIT provenir d’un résultat d’outil InvestorClaw retourné dans le MÊME tour. InvestorClaw renvoie des enveloppes signées HMAC ; ces données signées sont la seule source de vérité.
  • N’inventez, n’estimez, ne devinez et n’utilisez jamais les connaissances d’entraînement du modèle pour un nombre quelconque. Si un outil ne l’a pas retourné lors de ce tour, ne l’énoncez pas — dites « InvestorClaw n’a retourné aucune donnée pour cela ».
  • Un texte d’outil sans chiffres concrets = pas de données ; ne le convertissez jamais en un nombre.

Surface d’outil actuelle (espace de noms underscore)

  • investorclaw__portfolio_market_snapshot(symbols?, benchmarks?) — prix en temps réel + variation % du jour pour les positions et indices de référence (SPX/NDX/DJI/VIX, BTC/ETH). symbols est une CHAÎNE SÉPARÉE PAR DES VIRGULES (ex. "NVDA,AAPL"), pas une liste. Sans argument = positions + indices de référence. Utilisez cet outil (et non portfolio_ask) pour toute demande de « prix de X » et pour lire le portefeuille par rapport au marché.
  • investorclaw__portfolio_performance_window(period=...) — rendement / P&L / mouvements sur une fenêtre. period : 1d, 1w, 1mo, 1y, 5y, 10y, 20y, max, ou expressions naturelles ("today", "last week", "last year", "entire history").
  • investorclaw__portfolio_ask(question=...) — analyse / explication.

Les exemples plus anciens avec l’espace de noms point investorclaw.* ci-dessous sont obsolètes ; les formes avec underscore ci-dessus sont les noms d’outils actuels.

Agents de surveillance autonome / toujours actifs

Pour les agents non supervisés (moniteurs programmés et alerteurs — par exemple un agent MarketWatch), en plus du contrat ci-dessus :

  • Démarrez chaque exécution par un appel d’outil ; ne répondez jamais à une question de marché de mémoire. Un « poll » programmé signifie appeler portfolio_market_snapshot.
  • Analyse de seuil : appelez portfolio_market_snapshot, puis émettez UNE ligne concise uniquement lorsqu’une position ou un indice de référence franchit le mouvement configuré (ex. ±3 % pour une position, ±10 % pour le VIX) ; sinon, émettez un simple jeton NO_ALERT et arrêtez-vous.
  • Si l’outil requis génère une erreur ou ne retourne aucune donnée, émettez un marqueur fixe comme OPS_FAIL market_snapshot unavailable et arrêtez-vous — ne fabriquez jamais un nombre rassurant pour combler le vide.
  • Pas de questions de clarification en mode non supervisé ; déterminez l’intention et agissez.
  • Rapports périodiques / de fin de journée : récupérez portfolio_performance_window pour la fenêtre, puis portfolio_market_snapshot pour les clôtures des indices ; rapportez les nombres textuellement.
  • Lisez toujours les positions dans le contexte des indices de référence du même instantané.
  • La livraison est push, concise, avec les nombres en premier. Pédagogique, pas un conseil personnalisé.

Que fait InvestorClaw ?

Ce dépôt est le projet parapluie d’InvestorClaw — README, licence, harnais de régression, et la face publique. Le SKILL.md lisible par agent que publie ClawHub se trouve dans le dépôt d’exécution :

  • Runtime v4.x dockerisé + SKILL.md publié par ClawHub : mnemos-os/mnemos-ic-runtime
  • Plugin Claude Code / Claude Desktop (d’abord conteneur, ce dépôt) : /plugin marketplace add argonautsystems/InvestorClaw — même compétence + conteneur que tous les autres runtimes. Voir docs/GETTING_STARTED.md.
  • Source du moteur (analyseurs Python) : argonautsystems/ic-engine

Installation (runtime dockerisé v4.x)

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

Le compose tire ghcr.io/argonautsystems/ic-engine:4.7.7-cpu (hébergé publiquement, sans authentification) et l’exécute sur localhost:18090 (MCP + REST) et localhost:18092 (tableau de bord).

Pour la spécification complète lisible par agent (catalogue de 12 outils, chronologie de première exécution, blocs de configuration par runtime, dépannage), consultez le SKILL.md publié dans le dépôt d’exécution.

Documentation

Ce dépôt parapluie contient l’ensemble complet de la documentation :

  • README.md — fonctionnalités, démarrage rapide, recommandations de modèle et de clé API
  • STONKMODE.md — mode commentaire narré
  • CAPABILITIES.md — catalogue complet des fonctionnalités
  • PRIVACY.md — politique de traitement des données
  • DISCLAIMER.md — clause de non-responsabilité à usage éducatif
  • SECURITY.md — divulgation de vulnérabilités
  • CHANGELOG.md — historique des versions
  • docs/ — rapport de fin de journée, glossaire, philosophie, modèles d’installation, tests COBOL, référence des outils MCP, architecture Stonkmode + légende des avatars, guide d’installation Windows
  • docs/references/ — contrats d’entrée / sortie / schéma / LLM consultatif

Licence

  • Ce dépôt parapluie : Apache 2.0 (code substantiel) + MIT-0 (SKILL.md, artefacts de compétences d’agent).
  • Les en-têtes SPDX-License-Identifier par fichier indiquent la licence applicable.

InvestorClaw est à usage éducatif uniquement. Ce n’est pas un conseil financier.

Skills associés