Saltearse al contenido
Nappai Documentation

YFinance Tool

El YFinance Tool te permite consultar datos financieros de cualquier acción directamente desde Yahoo Finance. Con él puedes obtener información básica del ticker, noticias recientes o cualquier otro dato disponible a través de la librería yfinance.

¿Cómo funciona?

Cuando introduces el símbolo de la acción (por ejemplo, AAPL o GOOG) y eliges el tipo de información que deseas, el componente hace una llamada a la API de Yahoo Finance mediante la librería yfinance.

  • Si seleccionas Information to request como Ticker Info, se devuelve un diccionario con los datos del ticker (precio, mercado, sector, etc.).
  • Si eliges Get News, se recuperan las últimas noticias sobre la empresa; el número de artículos se controla con Number of News.
  • Para cualquier otro método disponible en YahooFinanceMethod, el componente llama al atributo correspondiente del objeto Ticker.

El resultado se envía en dos salidas:

  • Tool: un objeto Tool que puede ser usado por otros componentes o por el flujo de trabajo de Nappai.
  • Data: una lista de objetos Data que contiene la información solicitada, lista para ser procesada o visualizada en el dashboard.

Entradas

Información a solicitar (Information to request)

Selecciona el tipo de dato que quieres obtener de Yahoo Finance.

  • Ticker Info: datos básicos del ticker.
  • Get News: noticias recientes sobre la empresa.
  • Otros métodos disponibles en YahooFinanceMethod.

Número de Noticias (Number of News)

Define cuántos artículos de noticias quieres recuperar. Este parámetro solo se aplica cuando seleccionas Get News. El valor por defecto es 5.

Símbolo de la Acción (Stock Symbol)

Introduce el símbolo bursátil de la acción que deseas consultar (por ejemplo, AAPL, GOOG, MSFT). Este valor es obligatorio.

Salidas

  • Tool: objeto Tool que expone la función de consulta y puede ser reutilizado en otros flujos de trabajo.
  • Data: lista de objetos Data con la información solicitada. Si se pidió noticias, cada artículo aparece como un elemento separado; si se pidió otro tipo de dato, la lista contiene un único objeto con la clave result.

Ejemplo de Uso

  1. Arrastra el componente YFinance Tool al lienzo.
  2. En Stock Symbol escribe AAPL.
  3. En Information to request selecciona Ticker Info.
  4. Haz clic en Run.
  5. La salida Data mostrará un resumen con el precio actual, el sector y otras métricas de Apple.

Para obtener noticias:

  1. Cambia Information to request a Get News.
  2. Ajusta Number of News a 3 si solo quieres las tres noticias más recientes.
  3. Ejecuta el componente y revisa la salida Data; cada artículo aparecerá como un objeto separado con título, fuente y enlace.

Componentes Relacionados

  • YahooFinanceToolComponent – la propia herramienta que expone la funcionalidad de Yahoo Finance.
  • NappaiBaseComponent – la clase base que permite integrar este componente dentro del ecosistema Nappai.
  • Data – tipo de dato que se utiliza para transportar la información entre componentes.

Consejos y Mejores Prácticas

  • Verifica el símbolo: Asegúrate de que el símbolo bursátil sea correcto; de lo contrario, la llamada fallará.
  • Limita el número de noticias: Si solo necesitas un resumen rápido, usa un valor bajo (por ejemplo, 2 o 3) para evitar sobrecargar la salida.
  • Reutiliza el Tool: Si necesitas hacer varias consultas en un flujo, guarda el objeto Tool y reutilízalo en lugar de crear nuevas instancias.
  • Manejo de errores: El componente devuelve una lista vacía y registra el error si la llamada falla; captura este caso en tu flujo para evitar interrupciones inesperadas.

Consideraciones de Seguridad

  • Datos públicos: La información recuperada proviene de Yahoo Finance, que es pública. No se manejan credenciales ni datos sensibles.
  • Límites de uso: La API de Yahoo Finance no requiere autenticación, pero su uso excesivo puede provocar bloqueos temporales. Si necesitas un acceso más robusto, considera usar una API oficial con claves de acceso.
  • Conexión segura: Todas las llamadas se realizan sobre HTTPS, garantizando que la comunicación esté cifrada.

Con estos pasos y recomendaciones podrás integrar fácilmente la obtención de datos financieros en tus dashboards de Nappai.