Metodología

StockVS se produce mediante un flujo automatizado: recopilación de datos, una compilación nocturna, verificaciones automatizadas y publicación, cada una descrita más abajo.

Los datos de mercado provienen de Yahoo Finance a través de la biblioteca de código abierto yfinance: precios y volumen diarios, dividendos, perfiles de empresas y fondos con estadísticas clave, cuentas de resultados anuales para las acciones y principales participaciones para los ETFs. Los valores cubiertos proceden de los listados públicos de las bolsas de Estados Unidos y Canadá; los titulares de noticias provienen del servicio de noticias Finnhub. En el caso de los recibos de depósito (ADR), la capitalización de mercado es el precio del ADR multiplicado por el número de acciones equivalentes del ADR, tal como lo informa Yahoo Finance; puede diferir del valor de la empresa en su mercado local cuando el ADR cotiza con prima (por ejemplo, TSM y SKHY).

Las tareas de recopilación escriben los precios y el perfil de cada valor, y los titulares de noticias de las acciones, en una base de datos PostgreSQL. Cada noche, una compilación del sitio estático genera todas las páginas a partir de esa base de datos, y verificaciones automatizadas inspeccionan el resultado; si alguna verificación falla, no se sube nada y la versión anterior permanece en línea. Una compilación que supera las verificaciones se sube a un alojamiento estático detrás de la red de Cloudflare, y a continuación se carga una muestra aleatoria de las páginas nuevas para confirmar que responden.

Los precios se recopilan cada día de negociación después del cierre del mercado, y la compilación nocturna comienza en cuanto termina la recopilación, por lo que las páginas normalmente muestran el precio de cierre de ese día esa misma noche; las compilaciones de fin de semana usan los datos de la última sesión. Los perfiles de empresa y las estadísticas clave se actualizan cada día laborable, las participaciones de los ETFs y los historiales de precios completos de los ETFs, semanalmente, y las cuentas de resultados de cada empresa aproximadamente una vez al trimestre, y las de una empresa recién incorporada, dentro de la primera semana. Los titulares de noticias de las acciones se actualizan a diario para las empresas más grandes, cada pocos días para las más pequeñas. Si la recopilación de un día laborable falla, la compilación de esa noche no se ejecuta, la versión anterior permanece en línea y un monitor emite una alerta.

Las rentabilidades de los períodos móviles, los años naturales y los meses se calculan a partir de los cierres diarios almacenados, ajustados por Yahoo Finance por desdoblamientos y dividendos en el momento en que se descargó cada uno; la volatilidad es la desviación estándar anualizada de las rentabilidades diarias. La capitalización de mercado, los ratios de valoración, los márgenes, el beneficio por acción y las rentabilidades por dividendo se muestran tal como los reporta Yahoo Finance, y un valor fuera de un rango plausible no se muestra. Las cifras conservan su moneda de referencia, dólares estadounidenses o canadienses, y nunca se convierten; los totales que abarcan ambas se indican por moneda. Las comparaciones con la industria usan la mediana de la industria, y las diferencias entre porcentajes se expresan en puntos porcentuales.

El análisis de las páginas de acciones y ETFs se ensambla a partir de plantillas de frases preescritas en cada idioma disponible, rellenadas con cifras de la base de datos. Cuando faltan datos, se omite la frase en lugar de dejar un marcador de posición. Las plantillas describen los datos y su comparación con las medianas de la industria, sin valoraciones, recomendaciones ni predicciones. No se ejecuta ningún modelo de lenguaje al generar el sitio, y ningún modelo escribe texto sobre ninguna acción o fondo en particular. Las ilustraciones abstractas junto a algunos titulares de noticias se generaron una sola vez con un modelo de imagen y no representan las noticias.

Durante la recopilación, los precios se almacenan solo para los días en que el mercado propio del valor estuvo abierto, un precio del día en curso solo después de que cierre la sesión, y la actualización diaria no puede sobrescribir un cierre almacenado con una cotización en vivo. Un nombre truncado procedente de la fuente de datos no puede sustituir a un nombre completo ya almacenado, y los valores que dejan de recibir precios se señalan en el informe de ejecución. En las páginas, un precio que ya no está vigente muestra la fecha de su última operación, y las empresas con doble cotización se cuentan una sola vez.

Antes de cada publicación nocturna, verificaciones automatizadas leen el sitio terminado, página por página o por muestreo. La compilación debe tener un tamaño cercano al de la última versión publicada, contener al menos tantas páginas como las que enumeran sus mapas del sitio, y llevar precios tan recientes como exige el calendario. Los datos estructurados deben estar bien formados, las fechas de los precios deben caer en días de negociación y nunca en el futuro, cada página debe llevar una única fecha de datos, y los recuentos y totales deben coincidir entre páginas. Ninguna tabla puede listar una empresa dos veces ni sumar monedas distintas. El análisis y los resúmenes de los listados deben usar el sistema de escritura del idioma de la página.

StockVS no ofrece cotizaciones en tiempo real: los datos son de cierre de jornada, y algunas páginas pueden quedar una sesión o más por detrás cuando Yahoo Finance publica un cierre con retraso o falla una ejecución de recopilación. Las cifras solo son tan exactas como los datos de Yahoo Finance. No todas las métricas financieras están disponibles para cada acción o ETF. La disponibilidad de datos históricos varía según el ticker. La mayoría de los historiales se amplían día a día, por lo que un ajuste posterior por desdoblamiento o dividendo puede no alcanzar los precios más antiguos, y las rentabilidades a largo plazo pueden diferir de las de otras fuentes. Los valores que dejan de cotizar conservan su página, con el último precio marcado como no vigente, y las descripciones de empresa aparecen solo en las páginas de acciones en inglés.

Los errores se detectan mediante las verificaciones automatizadas descritas arriba y mediante revisiones de las páginas publicadas. Cada uno se corrige en su origen, ya sea en los datos, en un cálculo o en una plantilla, y la siguiente recompilación nocturna traslada la corrección a todas las páginas afectadas; las correcciones se registran en el sistema interno de seguimiento de incidencias del proyecto. Actualmente no existe un canal público para reportar errores.