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
3 days agolast push
HTML 98.9% Python 0.6%
4.9 KB

# Groupe Mercille — connecteur mercille

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 : Montérégie · Backend : direct · Annonces actives : 8/9

# Description de la source

connecteur Groupe Mercille (groupemercille.com) Quatre immeubles résidentiels à Longueuil, secteur du métro (Le D'Assigny 110 rue de la Barre, Le Neuville Nord/Sud, Le Sérigny). Site custom (Orangium) rendu serveur : la page « Appartements résidentiels » expose une table .table-listings — une ligne par unité disponible : type + disponibilité (« 3.5 1er septembre »), secteur, prix, étage (« 11 de 22 »), immeuble (lien vers sa page) et plan PDF. Les lignes du formulaire de contact (repliées sous chaque unité) sont ignorées. La page de chaque immeuble (via cache BD) fournit l'adresse civique et une photo. ⚠️ Le volet espaces commerciaux/bureaux du site n'est pas visité.

# Accès

  • Type d'accès : pages HTML (rendu serveur)
  • Endpoint de base : https://groupemercille.com
  • URLs de départ (constantes du module) : https://groupemercille.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 8 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½ — Le D'Assigny
address Adresse civique 100 % 110, rue de la Barre, Longueuil QC J4K 1A3
city Ville (normalisée) 100 % Longueuil
sector Secteur / quartier 100 % Métro Longueuil
unit_type Type d'unité (3½, 4½…) 100 % 3½
price Loyer mensuel ($) 100 % 1 600 $
bedrooms Chambres 100 % 1
bathrooms Salles de bain 0 % —
area_sqft Superficie (pi²) 0 % —
availability_date Date de disponibilité 100 % 2026-12-01
lat GPS (lat/lng) 100 % 45.52765247
description Description 100 % Ce site utilise des témoins (Cookies) afin de vous offrir la meilleure expérience possibl…
images Photos (JSON) 100 % 1 photo(s) — https://assets.orangium.com/api/assets/groupemercille/Content-undefined_d-as…
amenities Commodités (JSON) 0 % []
details Détails additionnels (JSON) 100 % {"balcony": true, "floor_label": "Étage 12 de 22", "plan_pdf": "https://assets.orangium.c…
url URL de l'annonce source 100 % https://groupemercille.com/le-d-assigny

# Fréquence & budget

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