Portfolio-Tracker
Ein CLI-Tool zum Verfolgen von Aktien- und Krypto-Portfolios mit Echtzeitkursen, Gewinn/Verlust und Dividenden-Tracking.
Wann dieses Skill verwendet werden sollte
Verwende dieses Skill, wenn du Folgendes benötigst:
- Lokale Verfolgung von Aktien- und Kryptobeständen
- Echtzeitkurse und Gewinn/Verlust
- Dividendenrenditen, Yield on Cost und prognostizierte Einnahmen verfolgen
- Bevorstehende Ex-Dividenden-Termine anzeigen
- Mehrere Portfolios verwalten
- Portfolio-Daten als CSV exportieren
Werkzeuge
Dieses Skill bietet die folgenden Fähigkeiten:
1. Bestände auflisten
Zeige alle Bestände mit aktuellen Werten und Gewinn/Verlust.
Befehl:
npx tsx portfolio.ts list
2. Bestand hinzufügen
Füge einen neuen Aktien- oder Krypto-Bestand hinzu.
Befehl:
npx tsx portfolio.ts add <symbol> <menge> <preis> <name> [typ]
Beispiele:
npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto
3. Bestand verkaufen
Verkaufe Anteile nach der FIFO-Methode (First-In-First-Out).
Befehl:
npx tsx portfolio.ts sell <symbol> <menge> <preis> [datum]
Beispiele:
npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000
4. Transaktionsverlauf
Zeige den Verkaufshistorie für alle Bestände oder ein bestimmtes Symbol.
Befehl:
npx tsx portfolio.ts history [symbol]
Beispiele:
npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL
5. Gewinn/Verlust-Zusammenfassung
Zeige sowohl realisierte als auch nicht realisierte Gewinne/Verluste.
Befehl:
npx tsx portfolio.ts pnl
6. Dividenden-Tracking
Zeige detaillierte Dividendeninformationen für Aktienbestände an, einschließlich Rendite, Yield on Cost (YOC) und prognostiziertem Jahreseinkommen.
Befehl:
npx tsx portfolio.ts dividends
7. Dividenden-Zusammenfassung
Zeige eine Zusammenfassung der Dividenden auf Portfolioebene: gesamtes prognostiziertes Einkommen, gewichtete Durchschnittsrendite und Yield on Cost.
Befehl:
npx tsx portfolio.ts dividend-summary
Die Ausgabe umfasst:
- Gesamtes prognostiziertes Jahreseinkommen
- Monatliche/vierteljährliche Einkommensschätzungen
- Gewichtete Durchschnittsrendite über alle Bestände
- Portfolio-Yield on Cost
- Anzahl der dividendenzahlenden Aktien
8. Dividendenkalender
Zeige bevorstehende Ex-Dividenden-Termine für deine Bestände an.
Befehl:
npx tsx portfolio.ts calendar [tage]
Beispiele:
npx tsx portfolio.ts calendar # Nächste 30 Tage
npx tsx portfolio.ts calendar 60 # Nächste 60 Tage
9. Auflisten mit Dividenden
Der Befehl list ruft automatisch Dividenden-Daten ab. Verwende das Flag --no-dividends, um sie zu überspringen.
Befehle:
npx tsx portfolio.ts list # Mit Dividendeninfo
npx tsx portfolio.ts list --no-dividends # Ohne Dividenden
10. Bestand entfernen
Entferne einen Bestand anhand des Symbols.
Befehl:
npx tsx portfolio.ts remove <symbol>
11. Portfoliowert
Zeige den gesamten Portfoliowert und Gewinn/Verlust.
Befehl:
npx tsx portfolio.ts value
12. Portfolios verwalten
Portfolios auflisten, wechseln oder erstellen.
Befehle:
npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "Portfolio-Name"
npx tsx portfolio.ts create "Neues Portfolio"
Tipp: Nachdem du npm link ausgeführt hast, kannst du den kürzeren Befehl portfolio anstelle von npx tsx portfolio.ts verwenden.
Installation
Installiere zunächst die erforderlichen Abhängigkeiten:
npm install
Dadurch werden alle notwendigen Pakete installiert, einschließlich TypeScript-Laufzeit (tsx), Next.js, React und andere in der package.json aufgeführte Abhängigkeiten.
Optional: Verlinke die CLI global für einfacheren Zugriff:
npm link
Nach dem Verlinken kannst du portfolio <befehl> anstelle von npx tsx portfolio.ts <befehl> verwenden.
NPM-Skripte
npm run dev # Starte Web-UI (optional)
npm run build # Erstelle für Produktion
Web-UI (Optional)
Du kannst auch eine optionale Weboberfläche mit vollständiger Dividenden-Tracking-Unterstützung ausführen:
npm run dev
Öffne dann http://localhost:3000
Web-UI-Funktionen:
- Echtzeit-Portfoliowert und Gewinn/Verlust-Tracking
- Dividenden-Zusammenfassungskarten (Jahreseinkommen, gewichtete Rendite, YOC, bevorstehende Termine)
- Detaillierte Dividendenaufschlüsselungstabelle pro Aktie
- Visueller Kalender für bevorstehende Ex-Dividenden-Termine
- Interaktives Kreisdiagramm für die Portfolioaufteilung
Datenspeicherung
Portfoliodaten werden lokal in data/portfolio.json gespeichert. Die Datendatei wird beim ersten Ausführen automatisch mit einem leeren Portfolio erstellt.
Funktionen
- Echtzeit-Aktienkurse über die Yahoo Finance API
- Echtzeit-Kryptokurse über die CoinGecko API
- Unterstützung mehrerer Portfolios
- Gewinn/Verlust-Tracking pro Bestand
- Dividenden-Tracking (Rendite, YOC, prognostiziertes Einkommen, Ex-Daten)
- CLI und optionale Weboberfläche