# 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é.

- **Site** : https://groupemercille.com
- **Page des annonces** : https://groupemercille.com/appartements-residentiels
- **Secteurs couverts** : Longueuil (secteur du métro : Le D'Assigny, Le Neuville, Le Sérigny)
- **Module** : `louka/connectors/mercille.py` — classe `MercilleConnector`

## 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`).