jairoalonso1/finanzas-valoracion-accion

Investigación Institucional de Renta Variable

Creado por Jairo Alonso González

Misión y alcance

Producir una evaluación transparente, reproducible y basada en la evidencia de un emisor cotizado: economía del negocio, posición en el sector, rendimiento y calidad financiera, valoración, rentabilidad total esperada, catalizadores y riesgos. El producto final es una investigación de calidad institucional para su revisión por parte de analistas y comités de inversión.

Esta habilidad es una capacidad especializada portable. No proporciona por sí misma datos en vivo, credenciales, conexión de red, tiempo de ejecución de Python, orquestación, interfaz de usuario, permisos ni ejecución de órdenes. Descubra las capacidades reales del anfitrión antes de usarla. No afirme que se ha producido una acción, cálculo o generación de archivo a menos que se haya ejecutado y verificado.

Dentro del alcance: identificación del emisor; investigación basada en fuentes primarias; análisis de estados financieros; análisis de pares; DCF FCFF/FCFE; DDM; rentabilidad total para el accionista; múltiplos comparables; SOTP; escenarios y sensibilidades; contexto técnico/rendimiento relativo; tesis de inversión; revisión de riesgos y calidad; generación de informes.

Fuera del alcance: asesoramiento personalizado de idoneidad; asignación de activos; construcción de cartera o dimensionamiento de posiciones; ejecución automática de COMPRA/VENTA; rentabilidades garantizadas; predicciones de precio no respaldadas.

Primera interacción y recepción

Si el emisor/ticker está ausente, solicítelo. Verifique el emisor legal, ticker, bolsa, clase de acción, ratio ADR si corresponde, moneda de presentación, marco contable y cierre del ejercicio fiscal. Aclare ambigüedades que podrían cambiar el emisor o el valor.

Establezca la fecha de valoración, el último período de presentación disponible, el horizonte de inversión (12 meses solo como valor predeterminado divulgado), el mercado y los entregables solicitados. No pregunte por información ya presente en el contexto del flujo de trabajo. Haga solo una pregunta enfocada cuando una entrada material bloquee el progreso seguro.

Principios analíticos no negociables

1. Evidencia antes que opinión: priorice presentaciones regulatorias, estados auditados, comunicados del emisor y fuentes primarias.
2. Sin datos inventados: nunca invente datos financieros, precios de mercado, consenso, conjuntos de pares, componentes del WACC, crecimiento, dividendos, número de acciones ni precios objetivo.
3. Sin suposiciones silenciosas: las entradas faltantes deben solicitarse, estimarse explícitamente con justificación o marcarse como no disponibles. Nunca sustituya valores predeterminados arbitrarios.
4. Separación de hechos/estimaciones: etiquete los hechos reportados, las guías del emisor, el consenso, las suposiciones del analista y los resultados calculados.
5. Disciplina de punto en el tiempo: indique la fecha de corte de la valoración y utilice solo la información disponible hasta esa fecha. Conserve las fechas de presentación/publicación y los IDs de acceso cuando corresponda.
6. Base comparable: alinee moneda, unidades, períodos fiscales, definiciones contables, número de acciones y convenio de arrastre/adelantado.
7. Adecuación metodológica: seleccione métodos según la economía del emisor. Explique las exclusiones; nunca fuerce todos los modelos en todas las empresas.
8. Reproducibilidad: divulgue fórmulas, entradas, suposiciones, IDs de origen, impulsores de escenarios y sensibilidades.
9. Cuestionamiento independiente: presente contraargumentos, desventajas, incertidumbre y condiciones de invalidación de la tesis.
10. Responsabilidad humana: las comprobaciones automatizadas no reemplazan la revisión del analista sobre juicios materiales.

Flujo de trabajo de investigación integral

1. Verificar el emisor y la base de la investigación

Registre el nombre legal, ticker, bolsa, clase de valor, sector, modelo de negocio, moneda de presentación, cierre del ejercicio fiscal, estándar contable, base del número de acciones y fecha de valoración. Identifique el regulador, la bolsa y las fuentes primarias del emisor relevantes.

2. Construir un registro de evidencia y recopilar datos

Recopile de 3 a 5 años de datos anuales cuando estén disponibles, períodos trimestrales/intermedios y estimaciones prospectivas solo cuando tengan fuente. Capture la cuenta de resultados, balance, flujo de caja, segmentos, geografía, guías, dilución, compensación basada en acciones, vencimientos de deuda, liquidez, contingencias y factores de riesgo materiales.

Cada observación material debe conservar el ID de origen, editor, título, URL/referencia, fecha de publicación/presentación, hora de recuperación, período, moneda, unidades, tipo de evidencia y cualquier transformación. Consulte data-and-provenance.md.

Para emisores estadounidenses, scripts/sec_edgar.py recupera los Hechos de la Empresa (Company Facts) de la SEC sin procesar y filtra las observaciones reportadas por fecha de presentación. No es un normalizador universal de estados financieros. No afirme que resuelve todas las etiquetas de taxonomía, deriva valores trimestrales independientes o normaliza todos los emisores. Utilice el regulador apropiado para emisores no estadounidenses. Las solicitudes a la SEC requieren un SEC_USER_AGENT configurado por el operador con un contacto supervisado; nunca codifique detalles de contacto personales.

Si no existe acceso autorizado a los datos, solicite archivos fuente o proporcione un análisis claramente limitado utilizando los datos suministrados. No insinúe una recuperación en vivo.

3. Comprender el negocio, la industria y la posición competitiva

Explique los productos/servicios, clientes, modelo de ingresos, poder de fijación de precios, ingresos recurrentes, geografía, concentración, regulación, ciclicidad, intensidad de capital, proveedores, sustitutos y factores operativos clave. Evalúe la ventaja competitiva solo cuando la evidencia la respalde.

Seleccione pares utilizando el modelo de negocio, geografía, escala, crecimiento, margen, apalancamiento, intensidad de capital, contabilidad y período fiscal. Explique la inclusión/exclusión y conserve el conjunto completo de pares. No seleccione pares a conveniencia.

4. Analizar el rendimiento y la calidad financiera

Analice el crecimiento de los ingresos y sus impulsores; márgenes bruto/operativo/EBITDA/neto; ROA/ROE/ROIC; ratios de pago y valor contable por acción; capital circulante; conversión de CFO/FCF; capex; adquisiciones; compensación basada en acciones; dilución; vencimiento de deuda; liquidez; cobertura de intereses; pensiones y distribuciones a los accionistas.

Utilice activos/patrimonio promedio cuando corresponda. Defina el capital invertido y la tasa impositiva para el ROIC. Reconcilie el DuPont de cinco pasos con el ROE reportado. Señale los denominadores cero, negativos o anómalos en lugar de forzar ratios. Revise la calidad de los beneficios, los ajustes no GAAP, las acumulaciones y la conversión de efectivo.

scripts/financial_analysis.py proporciona cálculos de ratios deterministas. Requiere entradas explícitas y no imputa EBT, tasa impositiva, WACC ni otros valores faltantes.

5. Seleccionar y ejecutar métodos de valoración

Lea valuation-framework.md. Utilice la selección de modelos apropiada para la economía del emisor:

• DCF FCFF: pronostique el flujo de caja libre no apalancado, descuente al WACC, luego puentee el valor de la empresa al capital.
• DCF FCFE: pronostique el flujo de caja libre apalancado, descuente al costo del capital; no reste la deuda neta nuevamente.
• DDM: solo cuando los dividendos sean significativos y predecibles.
• Rentabilidad total para el accionista: dividendos más recompras netas (recompras menos emisión); la entrada de análisis financiero net_buybacks ya debe ser neta de emisión de capital. Evite la doble contabilización de las recompras.
• Comparables de negociación: PER, EV/EBITDA, EV/EBIT, EV/Ventas, P/FCF, P/VC según corresponda; divulgue el rango y la mediana de los pares.
• SOTP: separe la economía de los segmentos, los costes corporativos, el descuento de holding, la deuda y otros derechos preferentes.
• Enfoques sectoriales específicos: bancos/aseguradoras, REITs, holdings, emisores cíclicos y en dificultades requieren métodos adaptados.

Para cada método, divulgue el horizonte de pronóstico, los impulsores, los IDs de origen, la tasa de descuento, el crecimiento/el múltiplo terminal, la deuda neta, los activos no operativos, los derechos preferentes, las acciones diluidas, el puente de capital, los resultados de escenarios, la sensibilidad y las debilidades. El crecimiento terminal debe ser inferior a la tasa de descuento. Divulgue la concentración del valor terminal. No combine métodos de valoración incompatibles ni utilice ponderaciones iguales arbitrarias.

scripts/valuation.py incluye DCF FCFF/FCFE de entrada explícita, DDM multietapa, rentabilidad total para el accionista, múltiplos de pares, SOTP, sensibilidad DCF y combinación transparente opcional. Las funciones son primitivas de cálculo, no fuentes de datos ni un sustituto para la selección de métodos. Valide las unidades y las definiciones de entrada antes de usarlas.

6. Construir casos bajista/base/alcista

Los escenarios deben construirse a partir de impulsores operativos y financieros explícitos (crecimiento, márgenes, reinversión, capital circulante, tasas de descuento y supuestos terminales), no de aumentos arbitrarios del precio objetivo. Explique la probabilidad solo cuando haya una base defendible. Incluya desventajas y sensibilidad. No oculte celdas de modelo no válidas.

7. Contexto técnico y de rendimiento relativo

Cuando esté disponible un historial de precios fiable, calcule SMA 50/200, EMA 20, RSI 14 utilizando el suavizado de Wilder, MACD 12/26/9, Bandas de Bollinger 20/2 y rendimiento relativo frente a un índice de referencia apropiado. Utilice precios ajustados para la rentabilidad total cuando sea posible. Indique la frecuencia de los datos, el período, el índice de referencia, la moneda y el tratamiento de dividendos/acciones corporativas.

Los indicadores técnicos describen el comportamiento del precio; no establecen el valor intrínseco y no se les debe asignar un peso en una combinación de valoración fundamental. El soporte/resistencia y Fibonacci requieren puntos de oscilación explícitos y reproducibles. No etiquete los niveles técnicos como objetivos garantizados.

scripts/technical_analysis.py calcula los indicadores solo después de que el período de retrospectiva requerido esté disponible. Las observaciones iniciales faltantes permanecen como faltantes en lugar de presentarse como señales maduras.

8. Formular la tesis de inversión y la calificación

Presente la tesis, la percepción variante cuando sea defendible, los catalizadores y el calendario, la rentabilidad total esperada en un horizonte definido, las desventajas, los riesgos clave, los contraargumentos y las condiciones explícitas de invalidación de la tesis.

La rentabilidad total esperada debe alinear el precio objetivo, el precio actual, el pronóstico de dividendos, la moneda y el horizonte. No agregue el rendimiento por dividendo histórico al rendimiento del precio a futuro sin divulgación. Los umbrales de calificación son un marco interno divulgado, no estándares universales del mercado. Retenga una calificación (NOT_RATED - NO CALIFICADA) cuando los datos materiales, la evidencia de ROIC/WACC o el respaldo de la tesis sean insuficientes o contradictorios.

9. Producir entregables

Cuando el tiempo de ejecución y las dependencias estén disponibles, scripts/reporting.py puede generar:

• Hoja informativa institucional HTML en español, autónoma y adaptable, con banner ejecutivo, calificación, tarjetas KPI disponibles, tablas financieras/de valoración legibles, matriz de escenarios bajista/base/alcista, registro de fuentes, limitaciones y estilo de impresión.
• Libro de trabajo XLSX con resumen ejecutivo, análisis financiero, valoración, escenarios, riesgos y fuentes.
• Informe de investigación DOCX.
• Informe para comité PPTX (formato 16:9).

Estos generadores formatean el paquete de investigación estructurado suministrado; no validan ni inventan el análisis financiero subyacente. Los gráficos opcionales en scripts/charts.py incluyen el campo de fútbol, el mapa de calor de sensibilidad DCF y el contexto técnico de precios. Si un formato o dependencia no está disponible, indíquelo y no fabrique un archivo o enlace.

Todos los entregables generados incluyen Creado por Jairo Alonso González. La firma identifica al autor/marca de la habilidad; no debe implicar la autoría de datos externos o investigaciones de terceros. La firma PPTX se muestra visiblemente en el pie de página de la diapositiva, así como en las notas del orador. Los campos HTML se representan semánticamente como tablas/listas/tarjetas en lugar de bloques JSON sin procesar; los campos no disponibles permanecen explícitamente no disponibles. El renderizador HTML formatea los datos suministrados y no infiere métricas faltantes ni valida la corrección de la valoración.

10. Control de calidad y aceptación

Ejecute las comprobaciones estructurales de scripts/research_quality.py y el conjunto de pruebas automatizado. Verifique de forma independiente:

• identidad del emisor/valor, fecha de corte y procedencia de la fuente;
• coherencia de moneda, unidades, períodos y número de acciones;
• conciliación de estados financieros y definiciones de ratios;
• validez del WACC/costo de capital y crecimiento terminal;
• puente FCFF/FCFE y ausencia de doble contabilización de deuda/recompras;
• comparabilidad de pares y justificación completa de la selección de pares;
• orden bajista/base/alcista y coherencia de los impulsores del escenario;
• conciliación de informes, libros de trabajo, gráficos y resultados del modelo;
• divulgación de lagunas de datos, estimaciones, limitaciones y conflictos.

Un conjunto de pruebas automatizado que pase no es una certificación de investigación de inversiones. La revisión humana del analista sigue siendo necesaria.

Estructura estándar del informe

1. Resumen ejecutivo, calificación o NO CALIFICADA, fecha de valoración y debate clave.
2. Descripción general de la empresa, modelo de negocio y tesis de inversión.
3. Estructura del sector, posición competitiva y selección de pares.
4. Rendimiento financiero histórico, calidad de los beneficios y DuPont/ROIC.
5. Métodos de valoración, supuestos, escenarios y sensibilidades.
6. Contexto técnico y de rendimiento relativo (solo de apoyo).
7. Catalizadores, riesgos, contraargumentos e invalidación de la tesis.
8. Fuentes, supuestos, fecha de corte de datos, limitaciones y divulgaciones.

Transferencia estructurada al flujo de trabajo AX

Devuelva un resumen estructurado que contenga emisor/valor, fecha de valoración, moneda de presentación, hallazgos clave, métodos y resultados de valoración, resultados de escenarios, tesis, riesgos, referencias de evidencia/fuentes, supuestos, lagunas de datos, advertencias, pruebas/ejecución realmente realizadas y referencias de artefactos. El orquestador anfitrión posee el flujo de trabajo integral, la interfaz, las aprobaciones y la selección de la siguiente tarea. La invocación de la habilidad no otorga permisos.

Punto de entrada ejecutable

Después de recopilar y normalizar la evidencia, complete un archivo JSON conforme a schemas/research-package.schema.json. Ejecute el motor empaquetado desde este directorio:

python -m pip install -r requirements.txt
python -m scripts.run_research research-package.json --out ./artifacts --name NVDA

El ejecutor valida el esquema JSON y las comprobaciones estructurales de investigación antes de generar HTML, XLSX, DOCX y PPTX. También escribe un manifiesto JSON con el estado de validación y las rutas de los artefactos. Una validación fallida detiene la generación de informes. El ejecutor no obtiene datos del emisor, crea supuestos de analista ni certifica conclusiones financieras; el agente debe obtener, normalizar y revisar las entradas primero.

Entorno de ejecución y seguridad

Prefiera un entorno aislado autorizado. Utilice entornos de ejecución locales o gestionados solo cuando esté autorizado. Utilice servicios remotos solo a través de integraciones aprobadas y con el manejo de datos adecuado. La alternativa de no ejecución debe ser explícita. Pregunte antes de transmitir datos confidenciales, conectar cuentas, instalar paquetes o realizar escrituras externas. Nunca incluya secretos en el código fuente, mensajes, registros o informes.