Portfolio-Tracker Skill
Ein Investment-Portfolio-Tracker, der vollständig lokal läuft. Alle Daten bleiben in ~/.portfolio-tracker/.
Architektur
- Daten:
~/.portfolio-tracker/data.json(Portfolios, Vermögenswerte, Kurse) - Konfiguration:
~/.portfolio-tracker/config.json(API-Schlüssel, Wallet-Adressen, Benutzerprofil) - Skripte: TypeScript-CLI-Tools im
<skill-pfad>/scripts/Verzeichnis, ausgeführt übernpx tsx
Ersteinrichtung
Bevor Sie ein Skript ausführen, stellen Sie sicher, dass die Abhängigkeiten installiert sind:
npm install --prefix <skill-pfad>/scripts
Ersetzen Sie <skill-pfad> durch den tatsächlichen Installationspfad dieses Skills.
Wie Skripte funktionieren
Jedes Skript ist ein eigenständiges CLI-Tool. Führen Sie sie mit folgendem Befehl aus:
npx tsx <skill-pfad>/scripts/<skript>.ts <befehl> [argumente]
Skripte lesen bei Bedarf von stdin und geben JSON auf stdout aus.
data-store.ts
load— Portfolio-Daten einlesen (erstellt Standarddaten, falls nicht vorhanden)save— Portfolio-Daten schreiben (JSON von stdin)load-config— Konfiguration einlesensave-config— Konfiguration schreiben (JSON von stdin)
fetch-prices.ts
crypto <symbol>— Kryptokurs abrufen (Binance → CoinGecko)stock <symbol>— Aktienkurs abrufen (Yahoo Finance)fx— Wechselkurse USD/CNY/HKD abrufenhistorical <symbol>— 3 Jahre monatliche historische Daten abrufensearch <query>— Nach Vermögenswerten nach Name/Symbol suchenrefresh— Kurse aktualisieren (Asset-JSON von stdin)
binance-sync.ts
sync <apiKey> <apiSecret>— Alle Binance-Guthaben abrufen (6 Kontotypen)validate <apiKey> <apiSecret>— API-Anmeldedaten validieren
ibkr-sync.ts
sync <token> <queryId>— IBKR-Positionen per Flex Query abrufenvalidate <token> <queryId>— IBKR-Anmeldedaten validieren
blockchain-sync.ts
sync <adresse> [blockchain]— Wallet-Guthaben abrufen (einzelne oder alle 5 EVM-Blockchains)validate <adresse>— EVM-Adresse validieren
Datentypen
Asset
{
"id": "eindeutige-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": "eindeutige-id",
"name": "Haupt",
"assets": [...]
}
Arbeitsabläufe
Portfolio anzeigen
- Daten mit
data-store.ts loadladen - Aktuelles Portfolio über
currentPortfolioIdfinden - Gesamtwert mit
quantity * currentPricepro Asset berechnen - Mit
exchangeRatesin Anzeigewährung umrechnen - Als formatierte Tabelle präsentieren
Assets hinzufügen
- Daten laden
- Nach dem Asset mit
fetch-prices.ts search <query>suchen - Aktuellen Kurs mit
fetch-prices.ts crypto/stock <symbol>abrufen - Asset mit generierter eindeutiger ID zum aktuellen Portfolio hinzufügen
- Daten speichern
Kurse aktualisieren
- Daten laden
- Aktuelle Portfolio-Assets über stdin an
fetch-prices.ts refreshübergeben - Zusätzlich
fetch-prices.ts fxfür Wechselkurse ausführen currentPricejedes Assets undexchangeRatesaktualisierenlastPriceRefreshauf aktuellen ISO-Zeitstempel setzen- Daten speichern
Synchronisieren von Börse/Wallet
- Konfiguration laden, um Anmeldedaten zu erhalten
- Entsprechendes Sync-Skript ausführen
- Ergebnisse zusammenführen: bestehende Assets aktualisieren (Abgleich nach Symbol+Quelle), neue hinzufügen
- Daten speichern
Befehle
Verfügbare Benutzerbefehle:
/portfolio— Portfolios anzeigen und verwalten/prices— Alle Kurse aktualisieren/setup— API-Schlüssel und Wallets konfigurieren/sync-binance— Von Binance synchronisieren/sync-ibkr— Von Interactive Brokers synchronisieren/sync-wallet— Von Blockchain-Wallet synchronisieren/advise— KI-Investmentberatung erhalten