boursobank-scraper 0.5.1

Outil pour récupérer les données de transaction depuis le site de BoursoBank

Scraper BoursoBank

Ce projet a pour objectif de récupérer les données des opérations bancaires depuis le site web de BoursoBank.

Il utilise la librairie Playwright pour naviguer sur le site de la banque.

Format des données

Le scraper récupère les données au format JSON.

Il s'agit du fichier json fourni par l'api de BoursoBank directement.

Les principaux champs incluent :

• Identifiant unique
• Date de l’opération
• Date de valeur
• Plusieurs libellés
• Montant
• Montant en devise (si applicable)
• Indication de lieu (souvent incorrect)

Résultat

Les fichiers sont enregistrés dans un répertoire nommé data/transactions.

Ils sont rangés des sous-répertoires année/mois/jour.

Les opérations en traitement sont enregistrées dans le répertoire authorization/new.

Les anciennes opérations en traitement sont enregistrées dans le répertoire authorization/old.

Installation

Prérequis

• Python 3.13 ou supérieur

Installation

boursobank-scraper peut être installé via la commande pip install comme n'importe quel module python, mais la méthode recommandée est d'utiliser le gestionnaire de paquets uv et en particulier la commande uv tool install

uv tool install boursobank-scraper

Celle-ci installe la commande boursobank-scraper directement accessible depuis le terminal.

Installation du navigateur Chromium pour playwright.

playwright-bbs install chromium

La commande playwright-bbs est identique à la commande playwright du projet Playwright. Elle est juste nommée différemment pour ne pas interférer avec une autre version qui serait installée en parallèle.

Mise à jour

Pour mettre à jour boursobank-scraper, exécutez simplement la commande :

uv tool upgrade boursobank-scraper

Configuration

Le programme a besoin d'un répertoire contenant le fichier de configuration config.yaml.

Créez un répertoire boursobank-data

mkdir ~/boursobank-data
cd ~/boursobank-data

Ajoutez-y un fichier config.yaml avec les informations de connexion à la banque.

---
username: 12345678
password: 87654321 # optionnel
headless: false # optionnel, défaut : False
timeoutMs: 15000 # optionnel, défaut : 30000 millisecondes
saveTrace: true # optionnel, défaut : false

Attention : le mot de passe n'est pas crypté !

Il n'est pas obligatoire. Dans ce cas, il sera demandé à chaque exécution.

Le paramètre headless peut prendre la valeur false. Dans ce cas, le navigateur sera affiché lors du scrapping. Sinon, le chargement aura lieu en tâche de fond.

Le paramètre timeoutMs définit le temps maximum d'attente après chaque chargement de page.

Le paramètre saveTrace définit si les traces de l'exécution seront sauvegardées dans un fichier debug/trace.zip. Par défaut, la trace n'est pas sauvegardée.

Attention : le mot de passe est visible dans la trace.

Exécution

Placez vous dans le répertoire boursobank-data et exécutez la commande :

cd ~/boursobank-data
boursobank-scraper

Ou, appelez directement la commande avec le répertoire data en paramètre :

boursobank-scraper --data-folder ~/boursobank-data

Indiquez le mot de passe si vous ne l'avez pas spécifié dans le fichier config.yaml.

Si vous avez spécifié false pour headless, le navigateur sera affiché lors du scrapping. Sinon, le chargement aura lieu en tâche de fond.

A la première exécution, le script va tenter de télécharger les informations pour toutes les opérations disponibles.

Les fois suivantes, seules les nouvelles opérations seront téléchargées.

Une fois le script exécuté, les fichiers de transactions sont disponibles dans les répertoires boursobank-scraper/transactions/[année]/[mois]/[jour].

Attention : ne supprimez pas les fichiers json dans ces répertoires, sinon le script les retéléchargera la prochaine fois, et le chargement sera bien plus long.

Les anciennes opérations peuvent toutefois être supprimées à condition de garder au moins les 50 dernières sur chaque compte.

Synthèse des comptes

Un fichier accounts.json est régénéré à chaque exécution. Ilcontient la liste des comptes bancaires. Chaque compte est représenté par un objet JSON avec les informations suivantes :

• id: identifiant unique du compte.
• name: nom du compte.
• balance: solde du compte.
• link: lien vers la page du compte.

Todo

• Utiliser le module keyring pour stocker les informations de connexion dans le trousseau.