MyInvestor

Busca ETFs (fondos cotizados) del bróker de MyInvestor. Devuelve hasta 10 ETFs con ficha: TER, AUM, nº de posiciones, gestión activa/indexada, top sectores/regiones/asset allocation, rentabilidades (YTD/1A/3A/5A y por año natural), volatilidad, geografía, divisa y descripción. El identificador es el TICKER (p.ej. 'CSPX', 'SXR8.DE'). Para acciones individuales usa `search_stocks`. Para fondos de inversión (no cotizados) usa `search_funds`. Por defecto se excluyen los ETPs apalancados/inversos (2x, 3x, inverse); usa `include_leveraged` para incluirlos.

search_etfs

Busca acciones (renta variable cotizada) del bróker de MyInvestor. Devuelve hasta 10 acciones con ficha: capitalización, PER, rentabilidad por dividendo, rentabilidades (YTD/1A/3A/5A y por año natural), volatilidad, sector, geografía, divisa y descripción. El identificador es el TICKER (p.ej. 'AAPL', 'DMP.DE'). Para ETFs usa `search_etfs`. Para fondos de inversión usa `search_funds`.

search_stocks

Busca y filtra el catálogo de 13 carteras automatizadas (robo-advisor): 6 indexadas de MyInvestor y 7 de Finanbest (incluida la Sostenible). Filtros componibles: query libre, profile, risk_max, family (myinvestor|finanbest), management, order_by. El payload de cada cartera ya contiene composición, fondos subyacentes con ISIN, comisiones e histórico anual — es la ficha completa, no un resumen. Para comparar 2-3 carteras por name_id, usa `compare_portfolios`.

search_portfolios

Busca fondos de inversión de MyInvestor (gestión activa e indexados). Devuelve hasta 10 fondos con ficha completa por fondo: TER, rentabilidades (YTD/1A/3A/5A y por año natural), volatilidad, riesgo SRRI, rating Morningstar, asset allocation, top sectores/regiones, fees, NAV y descripción. Filtros combinables con AND: `category` (filtro principal por geografía/estilo/tema), `asset_class`, `geographic_zone`, `sector`, `product_type`, `max_ter`, `max_risk`, `min_aum`… más un `query` libre con ranking BM25 para buscar por nombre/gestora ('vanguard nasdaq', 'iShares emergentes'). Por defecto ordena por rentabilidad 3A anualizada descendente; con `query` y sin `order_by` explícito, usa relevancia. Para MOSTRAR fondos concretos cuyo ISIN ya conoces (p.ej. tras `resolve_funds`), pasa `isins`: búsqueda exacta, sin match por nombre. Para comparar 2-3 productos (fondos, ETFs y/o acciones, del mismo tipo o mezclados), usa `compare_instruments` con sus identificadores EXACTOS (ISIN de fondo, o ticker/ISIN de ETF o acción); resuelve antes los nombres con `resolve_funds`. Para carteras automatizadas (robo-advisor) usa `search_portfolios` / `compare_portfolios`.

search_funds

Compara 2-3 productos donde al menos uno es una cartera automatizada: carteras entre sí, o una cartera mezclada con fondos/ETFs/acciones (por ISIN de fondo o ticker). Vista sin curva: rentabilidad por año, composición, coste. Para comparar solo fondos/ETFs/acciones usa `compare_instruments`.

compare_portfolios

Compara entre 2 y 3 productos de inversión lado a lado: fondos, ETFs y/o acciones, del mismo tipo o mezclados. El gráfico muestra la rentabilidad por período (YTD/1A/3A/5A); las filas comunes añaden volatilidad, TER, composición por clase de activo y geografía por bloques. Cuando todos los productos son del mismo tipo se muestran además sus métricas específicas (fondo: SRRI, años naturales, sectores; ETF: patrimonio, sectores; acción: PER, rentabilidad por dividendo, capitalización). Incluye botón para contratar cada uno en MyInvestor. Acepta SOLO identificadores exactos: ISIN de fondo, o ticker con sufijo de mercado ('SXR8.DE') / ISIN de ETF o acción. NO resuelve nombres — si el usuario los nombra por texto, resuélvelos antes con `resolve_funds`, `search_etfs` o `search_stocks` y pasa aquí los identificadores exactos. No es para las carteras automatizadas (usa `compare_portfolios`).

compare_instruments

Devuelve los valores que existen DE VERDAD en el catálogo de ETFs/acciones por dimensión, con cuántos instrumentos hay en cada uno (recuentos EXACTOS, en una sola llamada). No muestra ninguna vista al usuario — es para tu análisis. Dimensiones: `geography`, `sector`, `currency`, `asset_type`, `management_type`, `management_company` (gestora, solo aplica a ETFs). Úsala PRIMERO, antes que `search_etfs`/`search_stocks`, en estos casos: (1) preguntas de CONTEO o catálogo ('¿cuántos ETFs indexados hay?', '¿cuántas divisas hay?') — responde con esta herramienta, NO infieras el total desde una búsqueda con tope 10; (2) DESCUBRIMIENTO ('¿qué sectores hay?', '¿qué geografías existen?'); (3) FUNDAMENTAR un filtro — antes de pasar a `search_etfs`/`search_stocks` un `geography`/`sector`/`asset_type`/`management_type` que no tengas seguro, consúltalo aquí y usa el valor literal devuelto; (4) tras una búsqueda de ETFs/acciones con 0 resultados, para ver qué valores existen de verdad antes de reintentar. Usa `product_type` ('etf' o 'stock') para acotar los recuentos a un solo tipo. Cada dimensión trae `total` (cuántos valores distintos existen) y `values` (los más frecuentes, hasta `top`). Para enseñar ETFs/acciones al usuario usa `search_etfs`/`search_stocks`; para fichas completas por ticker, `get_instruments`.

list_instrument_facets

Devuelve los valores que existen DE VERDAD en el catálogo MyInvestor por dimensión, con cuántos fondos hay en cada uno (recuentos EXACTOS, en una sola llamada). No muestra ninguna vista al usuario — es para tu análisis. Dimensiones: `asset_class`, `category`, `geographic_zone`, `product_type`, `management_company` (gestora), `currency`, `sector`, `region`. Úsala PRIMERO, antes que `search_funds`, en estos casos: (1) preguntas de CONTEO o catálogo ('¿cuántos fondos indexados hay?', '¿cuántas gestoras?') — responde con esta herramienta, NO infieras el total desde un `search_funds` con tope 10; (2) DESCUBRIMIENTO ('¿qué gestoras hay?', '¿qué categorías de renta fija existen?'); (3) FUNDAMENTAR un filtro — antes de pasar a `search_funds` un `category`/`sector`/`geographic_zone` que no tengas seguro, consúltalo aquí y usa el valor literal devuelto, no lo inventes; (4) VALIDAR que una temática existe antes de buscarla (cripto/blockchain, cannabis, defensa…): si no aparece ninguna categoría ni sector relacionado, no lances `search_funds` con un valor inventado. La gestora NO es un filtro propio: para acotar por gestora usa su nombre exacto (el que devuelve esta herramienta) dentro del `query` libre de `search_funds`. Cada dimensión trae `total` (cuántos valores distintos existen) y `values` (los más frecuentes, hasta `top`). Para enseñar fondos al usuario usa `search_funds`; para fichas completas por ISIN, `get_funds`.

list_facets

Herramienta INTERNA: obtén la ficha COMPLETA de uno o varios ETFs/acciones por su TICKER exacto. NO muestra vista al usuario — sirve para analizar antes de responder. Para mostrar comparativas visuales usa `compare_instruments` (fondos, ETFs y/o acciones).

get_instruments

Herramienta INTERNA de consulta: obtén la ficha COMPLETA de uno o varios fondos por su ISIN exacto (TER, rentabilidades por período y por año natural, volatilidad, riesgo SRRI, rating Morningstar, asset allocation, top regiones/sectores, AUM, NAV). NO muestra ninguna vista al usuario — sirve para que analices los fondos antes de responder. Úsala cuando ya tienes los ISIN (p.ej. tras `resolve_funds`, o tras la selección del usuario en el selector) y necesitas examinar las fichas para razonar sobre solapamientos, exposición geográfica o costes ANTES de hacer una recomendación. Es el camino correcto para 'déjame ver las fichas completas': NO uses `search_funds` por nombre para esto — re-buscar por nombre pinta un carrusel innecesario y puede devolver el fondo equivocado. Si quieres mostrar al usuario una comparativa visual de 2-3 productos, usa `compare_instruments` (esa sí pinta vista). `get_funds` es solo para tu análisis interno.

get_funds