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 evidencia de un emisor que cotiza en bolsa: economía del negocio, posición en la industria, rendimiento y calidad financiera, valoración, rendimiento total esperado, catalizadores y riesgos. El resultado previsto es una investigación de calidad institucional para la revisión de analistas y comités de inversión.

Esta habilidad es una capacidad especializada portátil. Por sí misma no suministra datos en vivo, credenciales, conexión de red, tiempo de ejecución de Python, orquestación, interfaz de usuario, permisos ni ejecución de operaciones. 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 de fuentes primarias; análisis de estados financieros; análisis de pares; FCFF/FCFE DCF; DDM; pago total; comparables de negociación; 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 de idoneidad personalizada; asignación de activos; construcción de cartera o dimensionamiento de posiciones; ejecución automática de COMPRA/ VENTA; rendimientos garantizados; predicciones de precio no respaldadas.

Primera interacción y admisión

Si el emisor/ticker está ausente, pregunte por él. Verifique el emisor legal, ticker, bolsa, clase de acción, ratio ADR si corresponde, moneda de reporte, marco contable y cierre del año fiscal. Aclare ambigüedades que podrían cambiar el emisor o el valor.

Establezca la fecha de valoración, el período de reporte más reciente disponible, el horizonte de inversión (12 meses únicamente 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 una sola pregunta enfocada solo cuando una entrada material bloquea el progreso seguro.

Principios analíticos no negociables

1. Evidencia antes que opinión: priorice presentaciones, estados auditados, comunicados del emisor y fuentes primarias.
2. Sin datos fabricados: nunca invente datos financieros, precios de mercado, consenso, conjuntos de pares, componentes WACC, crecimiento, dividendos, recuentos de acciones o 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 hechos reportados, guía del emisor, consenso, suposiciones del analista y resultados calculados.
5. Disciplina de punto en el tiempo: indique la fecha límite de valoración y utilice solo la información disponible hasta esa fecha. Conserve las fechas de presentación/publicación y los ID de acceso cuando corresponda.
6. Base comparable: alinee moneda, unidades, períodos fiscales, definiciones contables, recuentos de acciones y convención 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 a todas las empresas.
8. Reproducibilidad: divulgue fórmulas, entradas, suposiciones, ID de fuente, impulsores de escenarios y sensibilidades.
9. Desafío 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 de los juicios materiales.

Flujo de trabajo de investigación integral

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

Registre el nombre legal, ticker, bolsa, clase de valor, industria, modelo de negocio, moneda de reporte, cierre del año fiscal, norma contable, base del recuento de acciones y fecha de valoración. Identifique el regulador relevante, la bolsa y las fuentes primarias del emisor.

2. Construya un registro de evidencia y recopile 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 el estado de resultados, balance general, flujo de efectivo, segmentos, geografía, guía, 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 fuente, 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 sin procesar de la SEC 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 veraz configurado por el operador con un contacto supervisado; nunca codifique datos de contacto personales.

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

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

Explique 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 donde 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. Analice el rendimiento y la calidad financiera

Analice el crecimiento de ingresos y sus impulsores; márgenes bruto/operativo/EBITDA/neto; ROA/ROE/ROIC; ratios de pago y valor contable por acción; capital de trabajo; 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 accionistas.

Utilice activos/patrimonio promedio cuando corresponda. Defina el capital invertido y la tasa impositiva para ROIC. Reconcile el DuPont de cinco pasos con el ROE reportado. Señale denominadores cero, negativos o anómalos en lugar de forzar ratios. Revise la calidad de las ganancias, 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 u otros valores faltantes.

5. Seleccione y ejecute métodos de valoración

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

• FCFF DCF: pronostique el flujo de caja libre no apalancado, descuente al WACC, luego puentee el valor de la empresa al patrimonio.
• FCFE DCF: pronostique el flujo de caja libre apalancado, descuente al costo del patrimonio; no reste la deuda neta nuevamente.
• DDM: solo cuando los dividendos sean significativos y predecibles.
• Pago total: 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 acciones. Evite la doble contabilización de recompras.
• Comparables de negociación: P/E, EV/EBITDA, EV/EBIT, EV/Ventas, P/FCF, P/B según corresponda; divulgue el rango de pares y la mediana.
• SOTP: separe la economía de los segmentos, los costos corporativos, el descuento de tenencia, la deuda y otros derechos preferentes.
• Enfoques específicos del sector: 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 ID de fuente, la tasa de descuento, el crecimiento/ múltiplo terminal, la deuda neta, los activos no operativos, los derechos preferentes, las acciones diluidas, el puente patrimonial, los resultados del escenario, la sensibilidad y las debilidades. El crecimiento terminal debe estar por debajo de 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 FCFF/FCFE DCF con entrada explícita, DDM multietapa, pago total, 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. Construya casos bajista/base/alcista

Los escenarios deben construirse a partir de impulsores operativos y financieros explícitos (crecimiento, márgenes, reinversión, capital de trabajo, tasas de descuento y supuestos terminales), no de aumentos arbitrarios del precio objetivo. Explique la probabilidad solo cuando exista 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 confiable, calcule SMA 50/200, EMA 20, RSI 14 usando suavizado Wilder, MACD 12/26/9, Bandas de Bollinger 20/2 y rendimiento relativo frente a un índice de referencia apropiado. Utilice precios ajustados para el rendimiento total cuando sea posible. Indique la frecuencia de 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 giro explícitos y reproducibles. No etiquete los niveles técnicos como objetivos garantizados.

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

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

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

El rendimiento total esperado debe alinear el precio objetivo, el precio actual, el pronóstico de dividendos, la moneda y el horizonte. No agregue el rendimiento 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) cuando los datos materiales, la evidencia de ROIC/WACC o el soporte de la tesis sean insuficientes o contradictorios.

9. Produzca entregables

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

• Hoja informativa HTML institucional en español, independiente y responsiva, 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.
• Presentación para comité PPTX (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 campo de fútbol, mapa de calor de sensibilidad DCF y 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 autoría de datos externos o investigación 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 límite y procedencia de la fuente;
• coherencia de moneda, unidades, períodos y recuento de acciones;
• conciliación de estados financieros y definiciones de ratios;
• validez de WACC/costo del patrimonio y crecimiento terminal;
• puente FCFF/FCFE y sin 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 informe, libro de trabajo, gráficos y resultados del modelo;
• divulgación de lagunas de datos, estimaciones, limitaciones y conflictos.

Un conjunto de pruebas automatizado aprobado no es una certificación de investigación de inversiones. La revisión del analista humano sigue siendo obligatoria.

Estructura de informe estándar

1. Resumen ejecutivo, calificación o NO CALIFICADO, fecha de valoración y debate clave.
2. Descripción general de la empresa, modelo de negocio y tesis de inversión.
3. Estructura de la industria, posición competitiva y selección de pares.
4. Rendimiento financiero histórico, calidad de las ganancias 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, límite 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 reporte, hallazgos clave, métodos de valoración y resultados, resultados de escenarios, tesis, riesgos, referencias de evidencia/fuente, supuestos, lagunas de datos, advertencias, pruebas/ejecución realmente realizadas y referencias de artefactos. El orquestador anfitrión es propietario del 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 que se ajuste 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 de investigación estructural 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 del informe. El ejecutor no obtiene datos del emisor, crea suposiciones de analista ni certifica conclusiones financieras; el agente debe obtener, normalizar y revisar las entradas primero.

Tiempo de ejecución y seguridad

Prefiera un entorno aislado del anfitrión autorizado. Utilice tiempos de ejecución locales o administrados 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, indicaciones, registros o informes.