Méthodologie

StockVS est produit par un pipeline automatisé : collecte des données, construction nocturne, contrôles automatisés et publication, chacun décrit ci-dessous.

Les données de marché proviennent de Yahoo Finance via la bibliothèque open source yfinance : cours et volumes journaliers, dividendes, profils d'entreprise et de fonds avec des statistiques clés, les comptes de résultat annuels pour les actions et les principales positions pour les ETFs. Les titres couverts proviennent des cotations publiques des bourses américaines et canadiennes ; les titres d'actualité proviennent du service d'information Finnhub. Pour les certificats de dépôt (ADR), la capitalisation boursière correspond au cours de l'ADR multiplié par le nombre d'actions équivalentes de l'ADR, tel que rapporté par Yahoo Finance ; elle peut différer de la valeur de l'entreprise sur son marché national lorsque l'ADR se négocie avec une prime (par exemple TSM et SKHY).

Des tâches de collecte enregistrent les cours et le profil de chaque titre, ainsi que les titres d'actualité pour les actions, dans une base de données PostgreSQL. Chaque nuit, une construction du site statique génère toutes les pages à partir de cette base de données, et des contrôles automatisés examinent le résultat ; si un contrôle échoue, rien n'est mis en ligne et la version précédente reste disponible. Une construction qui réussit est mise en ligne sur un hébergement statique derrière le réseau Cloudflare, puis un échantillon aléatoire des nouvelles pages est chargé pour vérifier qu'elles répondent.

Les cours sont collectés chaque jour de bourse après la clôture du marché, et la construction nocturne démarre une fois la collecte terminée, si bien que les pages affichent normalement les cours de clôture du jour dès le soir même ; les constructions du week-end utilisent les données de la dernière séance. Les profils d'entreprise et les statistiques clés sont actualisés chaque jour ouvré, les positions des ETFs et l'historique complet des cours des ETFs chaque semaine, et les comptes de résultat de chaque entreprise environ une fois par trimestre, ceux d'une nouvelle cotation sous une semaine. Les titres d'actualité pour les actions sont actualisés chaque jour pour les plus grandes entreprises, tous les quelques jours pour les plus petites. Si une collecte en semaine échoue, la construction du soir n'a pas lieu, la version précédente reste en ligne et un outil de surveillance déclenche une alerte.

Les rendements sur périodes glissantes, années civiles et mois sont calculés à partir des cours de clôture enregistrés, tels qu'ajustés par Yahoo Finance pour les fractionnements et les dividendes au moment du téléchargement de chacun ; la volatilité est l'écart type annualisé des rendements journaliers. La capitalisation boursière, les ratios de valorisation, les marges, le bénéfice par action et les rendements du dividende sont affichés tels que Yahoo Finance les rapporte, et une valeur hors d'une plage plausible n'est pas affichée. Les chiffres conservent leur devise de référence, dollar américain ou canadien, et ne sont jamais convertis ; les totaux couvrant les deux devises sont donnés par devise. Les comparaisons avec l'industrie utilisent la médiane de l'industrie, et les écarts entre pourcentages sont exprimés en points de pourcentage.

L'analyse des pages d'actions et d'ETFs est assemblée à partir de modèles de phrases préécrits dans chaque langue prise en charge, complétés avec des chiffres issus de la base de données. Une donnée manquante fait disparaître la phrase correspondante plutôt que de laisser un espace vide. Les modèles décrivent les données et leur comparaison avec les médianes de l'industrie, sans notation, recommandation ni prédiction. Aucun modèle de langage ne s'exécute lors de la construction du site, et aucun modèle ne rédige de texte sur une action ou un fonds en particulier. Les illustrations abstraites accompagnant certains titres d'actualité ont été générées une seule fois par un modèle de génération d'images et ne représentent pas les événements relatés.

Pendant la collecte, un cours n'est enregistré que pour les jours où le marché du titre concerné était ouvert, un cours du jour même seulement après la clôture de la séance, et la mise à jour quotidienne ne peut pas remplacer un cours de clôture déjà enregistré par une cotation en direct. Un nom tronqué provenant du flux de données ne peut pas remplacer un nom complet déjà enregistré, et les titres qui cessent de renvoyer des cours sont signalés dans le rapport d'exécution. Sur les pages, un cours qui n'est plus à jour affiche la date de sa dernière transaction, et les entreprises à double cotation sont comptées une seule fois.

Avant chaque publication nocturne, des contrôles automatisés lisent le site terminé, page par page ou par échantillonnage. La construction doit être proche en taille de la dernière version publiée, contenir au moins autant de pages que ses sitemaps en listent et présenter des cours aussi récents que le calendrier l'exige. Les données structurées doivent être bien formées, les dates de cours doivent tomber sur des jours de bourse et jamais dans le futur, chaque page doit porter une seule date de données, et les décomptes et totaux doivent concorder entre les pages. Aucun tableau ne peut lister une entreprise deux fois ni additionner des devises différentes. L'analyse et les résumés de répertoire doivent utiliser le système d'écriture de la langue de la page.

StockVS ne fournit pas de cotations en temps réel : les données sont de fin de journée, et certaines pages peuvent accuser un retard d'une séance ou plus lorsque Yahoo Finance publie un cours de clôture en retard ou qu'une collecte échoue. Les chiffres ne sont fiables qu'à hauteur des données de Yahoo Finance. Toutes les métriques financières ne sont pas disponibles pour chaque action ou ETF. La disponibilité des données historiques varie selon le titre. La plupart des historiques de cours sont prolongés jour après jour, si bien qu'un fractionnement ou un ajustement de dividende ultérieur peut ne pas atteindre les cours plus anciens, et les rendements de long terme peuvent différer d'autres sources. Les titres qui cessent d'être négociés conservent leur page, avec le dernier cours signalé comme n'étant plus à jour, et les descriptions d'entreprises n'apparaissent que sur les pages d'actions en anglais.

Les erreurs sont détectées par les contrôles automatisés décrits ci-dessus et par la relecture des pages publiées. Chacune est corrigée à sa source, dans les données, un calcul ou un modèle, et la reconstruction nocturne suivante applique la correction à chaque page concernée ; les corrections sont consignées dans l'outil de suivi interne du projet. Il n'existe actuellement aucun canal public pour signaler des erreurs.