Habilidad de Rastreador de Carteras
Un rastreador de carteras de inversión que funciona completamente de forma local. Todos los datos se almacenan en ~/.portfolio-tracker/.
Arquitectura
- Datos:
~/.portfolio-tracker/data.json(carteras, activos, precios) - Configuración:
~/.portfolio-tracker/config.json(claves API, direcciones de cartera, perfil de usuario) - Scripts: Herramientas CLI en TypeScript en
<skill-path>/scripts/, ejecutadas mediantenpx tsx
Configuración Inicial
Antes de ejecutar cualquier script, asegúrese de que las dependencias estén instaladas:
npm install --prefix <skill-path>/scripts
Reemplace <skill-path> con la ruta real donde está instalada esta habilidad.
Cómo Funcionan los Scripts
Cada script es una herramienta CLI independiente. Ejecútelos con:
npx tsx <skill-path>/scripts/<script>.ts <comando> [args]
Los scripts leen desde stdin cuando es necesario y emiten JSON a stdout.
data-store.ts
load— Lee datos de la cartera (crea valores predeterminados si faltan)save— Guarda datos de la cartera (JSON desde stdin)load-config— Lee la configuraciónsave-config— Guarda la configuración (JSON desde stdin)
fetch-prices.ts
crypto <símbolo>— Obtiene precio de criptomoneda (Binance → CoinGecko)stock <símbolo>— Obtiene precio de acción (Yahoo Finance)fx— Obtiene tipos de cambio USD/CNY/HKDhistorical <símbolo>— Obtiene datos históricos mensuales de 3 añossearch <consulta>— Busca activos por nombre/símbolorefresh— Actualiza precios por lote (JSON de activos desde stdin)
binance-sync.ts
sync <apiKey> <apiSecret>— Obtiene todos los saldos de Binance (6 tipos de cuenta)validate <apiKey> <apiSecret>— Valida las credenciales de la API
ibkr-sync.ts
sync <token> <queryId>— Obtiene posiciones de IBKR mediante Flex Queryvalidate <token> <queryId>— Valida las credenciales de IBKR
blockchain-sync.ts
sync <dirección> [cadena]— Obtiene saldos de cartera (una cadena o las 5 cadenas EVM)validate <dirección>— Valida una dirección EVM
Tipos de Datos
Activo
{
"id": "id-único",
"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" }
}
Cartera
{
"id": "id-único",
"name": "Principal",
"assets": [...]
}
Patrones de Flujo de Trabajo
Visualizar Cartera
- Cargar datos mediante
data-store.ts load - Encontrar la cartera actual usando
currentPortfolioId - Calcular el valor total usando
quantity * currentPricepor activo - Convertir a la moneda de visualización usando
exchangeRates - Presentar como una tabla formateada
Agregar Activos
- Cargar datos
- Buscar el activo usando
fetch-prices.ts search <consulta> - Obtener el precio actual mediante
fetch-prices.ts crypto/stock <símbolo> - Agregar el activo a la cartera actual con un ID único generado
- Guardar datos
Actualizar Precios
- Cargar datos
- Enviar los activos de la cartera actual a
fetch-prices.ts refreshmediante stdin - Ejecutar también
fetch-prices.ts fxpara los tipos de cambio - Actualizar el
currentPricede cada activo y losexchangeRates - Establecer
lastPriceRefreshen la marca de tiempo ISO actual - Guardar datos
Sincronizar desde Exchange/Cartera
- Cargar configuración para obtener las credenciales
- Ejecutar el script de sincronización adecuado
- Fusionar resultados: actualizar activos existentes (coincidir por símbolo+fuente), agregar nuevos
- Guardar datos
Comandos
Comandos de usuario disponibles:
/portfolio— Ver y gestionar carteras/prices— Actualizar todos los precios/setup— Configurar claves API y carteras/sync-binance— Sincronizar desde Binance/sync-ibkr— Sincronizar desde Interactive Brokers/sync-wallet— Sincronizar desde cartera blockchain/advise— Obtener asesoramiento de inversión con IA