# Location Saguenay — connecteur location_saguenay

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 : Saguenay–Lac-Saint-Jean · Backend : direct · Annonces actives : 21/21

# Description de la source

connecteur Location Saguenay (locationsaguenay.com — Saguenay : Chicoutimi près de l'UQAC/Cégep et Jonquière près du Cégep ; propriétaire-gestionnaire, formule de base ou tout inclus). WordPress classique (thème Davis), tout rendu serveur : le menu « Logements disponibles » liste TOUTES les fiches, groupées par « Appartements N chambres » (les pages villes /appartement-a-louer- chicoutimi|jonquiere/ sont des vitrines SEO sans cartes). Une fiche WP par immeuble/type d'unité (granularité immeuble, précédent immeubles_guillot) : description libre et galerie photoswipe ; prix « sur demande » (aucun prix publié -> price = None) et pas de dates de disponibilité. ⚠️ robots.txt : Crawl-delay: 10 -> request_delay = 10 s et budget de fiches réduit (max_details = 12, complété au fil des syncs par le cache BD).

• Site : https://locationsaguenay.com
• Page des annonces : https://locationsaguenay.com/appartement-a-louer-chicoutimi/
• Secteurs couverts : Saguenay (Chicoutimi — UQAC/Cégep/Hôpital, Jonquière — Cégep : rues Bécard, Sydenham, des Hospitalières, d'Alma, Massenet, de la Lorraine, St-Hubert) — 1 à 6 chambres et lofts, base ou tout inclus ; prix sur demande
• Module : louka/connectors/location_saguenay.py — classe LocationSaguenayConnector

# Accès

• Type d'accès : pages HTML (rendu serveur)
• Endpoint de base : https://locationsaguenay.com
• URLs de départ (constantes du module) : https://locationsaguenay.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 : 10.0 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 21 annonces actives ; exemple tiré d'une ligne réelle de la BD.

# Fréquence & budget

• Cadence observée (médiane des passages OK, sync_log) : ≈ 3.4 h
• Dernier passage OK : 2026-09-04 12:18 — 21 trouvées, +0 / ~0 / -0
• Throttling : 10.0 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 : 21 au total, 21 actives
• Première ingestion : 2026-08-09 · Dernière observation : 2026-09-04
• Complétude clé (actives) : GPS 76 % · prix 0 % · 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 location_saguenay · vérifier ensuite sync_log (SELECT * FROM sync_log WHERE source='location_saguenay' 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 10.0 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-09 — 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).