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.1 KB

# Logisco — connecteur logisco

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 : 157/241

# Description de la source

connecteur Logisco (logisco.com) Site rendu serveur. Crawl : page liste principale (+ pages villes) pour découvrir les pages projets, puis extraction des unités disponibles (cartes .unitCard) sur chaque page projet. Une annonce par unité. Chaque page unité (mise en cache via self.detail, plafond 150 vraies requêtes/sync) apporte : JSON-LD (adresse avec no d'unité + code postal, étage, téléphone, plan de l'unité), superficie/étage/dispo structurés (sommaire .unitHeader) et les 4 sections de commodités (Inclusions, Particularités, Services offerts, Espaces communs). Villes retenues : Québec, Lévis, Saint-Augustin-de-Desmaures (Donnacona et autres villes hors région exclues).

# Accès

  • Type d'accès : pages HTML (rendu serveur)
  • Endpoint de base : https://logisco.com
  • URLs de départ (constantes du module) : https://logisco.com
  • Authentification : aucune — contenu public
  • Pagination : page de liste unique (pas de pagination)
  • Backend anti-bot / rendu : requests direct (session UA LouKaBot, throttling poli)
  • Politesse : 0.6 s entre requêtes, timeout 30 s, User-Agent identifiable LouKaBot/1.0 (+https://www.lou-ka.com/bot)

# 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 157 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 % L'AMALGAM — Appartement 413
address Adresse civique 100 % 413-975 Rue de l'École, Lévis, G6W 0V4
city Ville (normalisée) 100 % Lévis
sector Secteur / quartier 100 % Saint-Romuald
unit_type Type d'unité (3½, 4½…) 100 % 3½
price Loyer mensuel ($) 100 % 1 423 $
bedrooms Chambres 100 % 1
bathrooms Salles de bain 0 % —
area_sqft Superficie (pi²) 100 % 698
availability_date Date de disponibilité 100 % now
lat GPS (lat/lng) 96 % 46.7358587
description Description 100 % Projet L'AMALGAM — 698 pi², Étage 4 — 12 unité(s) disponible(s) dans le projet
images Photos (JSON) 100 % 17 photo(s) — https://logisco.com/static/vb/3532-475/appartement-413-amalgam-logisco.webp
amenities Commodités (JSON) 100 % ["Un stationnement intérieur", "Climatisation", "Entrée laveuse et sécheuse", "Entrée lav…
details Détails additionnels (JSON) 100 % {"appliances": {"washer_dryer_hookup": true, "dishwasher_hookup": true}, "ac": true, "ele…
url URL de l'annonce source 100 % https://logisco.com/fr/appartements-a-louer/levis/saint-romuald/amalgam/975-appartement-4…

# Fréquence & budget

  • Cadence observée (médiane des passages OK, sync_log) : ≈ 3.4 h
  • Dernier passage OK : 2026-09-04 12:19 — 156 trouvées, +0 / ~0 / -49
  • 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 : 241 au total, 157 actives
  • Première ingestion : 2026-08-06 · Dernière observation : 2026-09-04
  • Complétude clé (actives) : GPS 96 % · prix 100 % · photos 100 % · description 100 %
  • Runs journalisés (60 derniers) : 60, 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 logisco · vérifier ensuite sync_log (SELECT * FROM sync_log WHERE source='logisco' 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-06 — 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).