SPB Git forge

spb/lou-ka

Public

Lou·Ka — tous les logements à louer du Québec, un seul endroit.

232commits 1branches 0releases
172.9 MBsize
maindefault branch
2 days agolast push
HTML 98.9% Python 0.6%
5.2 KB

# Nomade Gestion immobilière — connecteur nomade

Fiche générée automatiquement par scripts/gen_connector_docs.py le 2026-09-04 14:12 — ne pas éditer à la main, régénérer.

État : actif · Région : Québec · Backend : direct · Annonces actives : 10/10

# Description de la source

connecteur Nomade Gestion Immobilière (nomadegestion.com — 16+ immeubles à Québec : Beauport, Charlesbourg, Val-Bélair, Lebourgneuf… dont Le Melozio, L'Astral, Le Nordet ph. 1-2 et Le Bélair qui ont leurs microsites). Site Squarespace : la liste des prix et disponibilités est publiée dans un PDF dont le NOM CHANGE chaque mois (ex. /s/Liste-site-web-juillet-26.pdf) — on découvre le lien depuis la page d'accueil (bouton « Liste de prix et disponibilités »), puis on parse le tableau du PDF avec pdfplumber : en-tête d'immeuble (« L'Astral - 2500 de Beaubassin - Info ou visite 418-952-2701 »), rangée « Inclus dans le prix : … », rangées d'unités (type | étage(s) | prix ou fourchette | disponibilité) ou « Aucun logement disponible dans cet immeuble ». Photos : page de l'immeuble (interne ou microsite) via le cache BD des pages détail.

  • Site : https://nomadegestion.com
  • Page des annonces : https://nomadegestion.com/
  • Secteurs couverts : Québec : Charlesbourg (Gros-Pin, Louis-XIV), Limoilou, Vanier, Val-Bélair, Neufchâtel — liste prix/disponibilités publiée en PDF Squarespace (lien découvert dynamiquement)
  • Module : louka/connectors/nomade.py — classe NomadeConnector

# Accès

# Champs récupérés → schéma cible

Le connecteur (direct, pages HTML (rendu serveur)) alimente les colonnes de la table listings. Complétude mesurée en SQL sur les 10 annonces actives ; exemple tiré d'une ligne réelle de la BD.

Colonne listings Contenu Renseignée (actives) Exemple réel
title Titre de l'annonce 100 % 3½ — L'Astral
address Adresse civique 100 % 2500, rue de Beaubassin, Québec
city Ville (normalisée) 100 % Québec
sector Secteur / quartier 80 % Beauport
unit_type Type d'unité (3½, 4½…) 100 % 3½
price Loyer mensuel ($) 100 % 1 425 $
bedrooms Chambres 100 % 1
bathrooms Salles de bain 0 % —
area_sqft Superficie (pi²) 0 % —
availability_date Date de disponibilité 100 % 2026-10-01
lat GPS (lat/lng) 90 % 46.846936315
description Description 100 % Étage(s) : 5
images Photos (JSON) 100 % 11 photo(s) — https://images.squarespace-cdn.com/content/v1/66181cd14e66c64b89b937f5/fb8a…
amenities Commodités (JSON) 100 % ["1 stationnement intérieur", "Internet", "Air climatisé", "1 rangement", "Étage : 5"]
details Détails additionnels (JSON) 100 % {"inclusions": {"internet": true}, "ac": true, "storage": true, "parking": {"available": …
url URL de l'annonce source 100 % https://www.lastral.ca

# Fréquence & budget

  • Cadence observée (médiane des passages OK, sync_log) : ≈ 3.4 h
  • Dernier passage OK : 2026-09-04 08:15 — 10 trouvées, +0 / ~1 / -0
  • Throttling : 0.6 s entre requêtes (constante de classe request_delay)
  • Cache des pages détail (BD detail_cache) : activé — évite de re-visiter les fiches inchangées

# Volumétrie & complétude

  • Annonces en BD : 10 au total, 10 actives
  • Première ingestion : 2026-08-25 · Dernière observation : 2026-09-04
  • Complétude clé (actives) : GPS 90 % · prix 100 % · photos 100 % · description 100 %
  • Runs journalisés (60 derniers) : 46, dont 0 en erreur

# Erreurs connues & dépannage

Aucune erreur dans les 60 derniers runs journalisés.

Rejouer la source seule : python3 run.py sync nomade · vérifier ensuite sync_log (SELECT * FROM sync_log WHERE source='nomade' ORDER BY ts DESC LIMIT 5;).

# Licence, attribution & conditions

  • Scraping poli d'annonces publiques (données factuelles : prix, adresse, disponibilité) publiées par le gestionnaire sur son propre site.
  • User-Agent identifiable avec page d'information et contact : LouKaBot/1.0 (+https://www.lou-ka.com/bot; contact@spboucher.ai) ; throttling 0.6 s ; cache détail pour minimiser les requêtes.
  • Chaque annonce affichée sur Lou-Ka pointe vers l'annonce d'origine (colonne url) — la source garde le trafic de conversion.
  • Retrait sur demande : contact@spboucher.ai.

# Historique

  • 2026-08-25 — premières annonces de la source ingérées dans la BD.
  • 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par scripts/gen_connector_docs.py).