Quoi faire — agrégateur de sorties québécois (quoifaire)
Fiche générée le 2026-08-25 19:01 EDT par
scripts/gen_connector_docs.py— ne pas éditer à la main, relancer le script.
Statut : actif · Type : agregateur · Connecteur : sortika/connectors/quoifaire.py
Description
- Source : Quoi faire — agrégateur de sorties québécois
- Couverture : centaines de fiches à venir (Québec, Montréal, Saguenay, Outaouais, Mauricie) — site lent, sections parfois 502 (tolérées)
- Extraction : listes HTML rendues serveur //evenements (+?page=N, 5 sections villes) puis fiches serveur : dates FR, heure (À confirmer→None), prix publié brut, région touristique, lieu/adresse, lat/lng Google Maps, auditoire, og:image ; incrémental cache 7 j, plafond QUOIFAIRE_DETAIL_MAX=150
Accès
- Type : agregateur
- Endpoint (
BASE) :https://quoifaire.com - Auth : Aucune (accès public, identification honnête par User-Agent)
- Pagination : par numéro de page, parcours de sitemap XML
- Backend : GET direct
requests(throttlé, UASortiKa/1.0identifié) - Throttle : 0.8 s entre requêtes
- Accès légal : robots.txt Allow: / (seuls /search et admin exclus, non visités), GET throttlés 0,8 s, identification honnête
En-tête documentaire du connecteur
connectors/quoifaire.py : connecteur Quoi faire (quoifaire.com) — agrégateur Source : agrégateur de sorties québécois (sections villes : Québec, Montréal, Saguenay, Outaouais, Mauricie — les autres sections renvoyaient 502 à la sonde du 2026-08-25, ignorées proprement). Extraction: listes HTML rendues serveur //evenements (+ ?page=N) → URLs de fiches À VENIR seulement (le sitemap remonte 15 ans d'archives, on ne s'en sert pas). Fiches rendues serveur : h1, résumé, plage de dates FR (next-date__date), prix publié (next-date__price « min. X$ | max. Y$ »), heure (data-meta-time, « À confirmer » → None), Région touristique / Lieu / adresse, lat/lng du lien Google Maps, auditoire, catégorie, og:image. INCRÉMENTAL avec cache disque (data/quoifaire_cache.json) : nouvelles fiches d'abord, re-visite après 7 jours, plafonné à QUOIFAIRE_DETAIL_MAX fiches/sync. Accès : robots.txt « Allow: / » (seuls /search et l'admin sont exclus, on n'y touche pas) ; GET throttlés 0,8 s, identification honnête. Prix : price_label = texte publié (« min. 40.00$ | max. 150.00$ ») → parse_price en aval (price_min = plus bas montant). Jamais inventé.
Champs récupérés → schéma
Complétude mesurée sur les 113 événements actifs de la source ; exemples tirés d'un événement réel (quoifaire:61e-coupe-vanier-greenshield).
Champ (events.*) |
Description | Complétude | Exemple réel |
|---|---|---|---|
title — Titre |
titre de l'événement | 100 % | 61e Coupe Vanier GreenShield |
description — Description |
texte descriptif (source ou fiche détail) | 100 % | La grande finale du football universitaire canadien est de retour à Québec! |
url — URL |
lien vers la fiche originale / billetterie | 100 % | https://quoifaire.com/quebec/evenements/61e-coupe-vanier-greenshield |
categories — Catégories |
taxonomie canonique Sorti-Ka (JSON) | 100 % | ["sport"] |
venue — Salle (venue) |
nom du lieu | 42 % | PEPS (Université Laval) |
address — Adresse |
adresse civique | 42 % | 2300 Rue de la Terrasse, Saint-Thomas-d'Aquin, Cité-Universitaire, Sainte-Foy–Sillery–Cap-Rouge,… |
city — Ville |
municipalité | 41 % | Québec |
region — Région |
région administrative | 100 % | Capitale-Nationale |
lat — GPS (lat/lng) |
coordonnées géographiques | 100 % | 46.784796, -71.276909 |
start_date — Date début |
date locale AAAA-MM-JJ | 100 % | 2026-11-28 |
end_date — Date fin |
date locale AAAA-MM-JJ | 100 % | 2026-11-28 |
start_time — Heure (start_time) |
heure locale HH:MM (Québec) | 56 % | 15:00 |
end_time — Heure de fin (end_time) |
heure locale HH:MM (Québec) | 0 % | ∅ |
status — Statut |
cancelled / postponed / soldout (NULL = prévu) | 0 % | ∅ |
is_free — Gratuité (is_free) |
1 gratuit / 0 payant / NULL inconnu | 100 % | 0 |
price_min — Prix min |
tarif minimal réel ($) | 75 % | 20.0 |
price_label — Libellé prix |
étiquette tarifaire affichable | 100 % | min. 20.00$ | max. 26.00$ |
artists — Artistes |
têtes d'affiche / lineup (JSON) | 0 % | [] |
organizer — Organisateur |
promoteur / organisme | 0 % | ∅ |
image — Image |
visuel (og:image ou média source) | 100 % | https://quoifaire.tor1.digitaloceanspaces.com/prod/events/Xp3IjJQGTc7mgqU5TYcX1OiWuNlaqeJyJAtCe0… |
website — Site web |
site officiel de l'événement | 0 % | ∅ |
Fréquence & budgets
- Cadence : hebdomadaire
- Budgets / plafonds (variables d'environnement) :
| Variable | Défaut | Rôle |
|---|---|---|
QUOIFAIRE_CITIES |
quebec,montreal,saguenay,outaouais,mauricie |
— |
QUOIFAIRE_DETAIL_MAX |
150 |
— |
- Budget global : géocodage Nominatim plafonné à
SORTIKA_GEOCODE_MAX(défaut 120) requêtes réseau/cycle, toutes sources confondues (sortika/geocode.py, cache disque).
Volumétrie & complétude live
(mesuré le 2026-08-25 19:01 EDT dans data/sortika.db)
- Événements en base : 113 (dont 113 actifs)
- GPS : 113/113 actifs (100 %)
- Prix : 113/113 actifs (100 %)
- Heure (start_time) : 63/113 actifs (56 %)
- Heure de fin : 0/113 actifs (0 %)
- Statut (annulé/reporté/complet) : 0/113 actifs (0 %)
- Artistes : 0/113 actifs (0 %)
- Image : 113/113 actifs (100 %)
- Salle (venue) : 47/113 actifs (42 %)
- Dernier sync : 2026-08-25 18:52 — fetched 113, +113 ajoutés, ~0 mis à jour, -0 retirés
- Syncs enregistrés (sync_log) : 1
Erreurs & dépannage
Aucune erreur dans sync_log pour cette source. ✅
- Rejouer un sync isolé :
python3 run.py sync --source quoifaire(ou via le watcher PM2) ; inspecter ensuitesync_log:sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='quoifaire' ORDER BY ts DESC LIMIT 5;"
Licence / attribution
- robots.txt Allow: / (seuls /search et admin exclus, non visités), GET throttlés 0,8 s, identification honnête
Historique
- 2026-08-18 — Vague 1 d'enrichissement (commit
7d9d1b0) : géocodage Nominatim des salles (sortika/geocode.py, cache disque, plafondSORTIKA_GEOCODE_MAX), fiches détail lepointdevente (description, heure, tarifs réels/plugins/rates/<id>), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD. - 2026-08-18 — Vague 2 d'enrichissement (commit
65d2d33) : colonnes additivesevents.start_time(HH:MM locale QC) etevents.artists(JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown). - 2026-08-19 — Phase 2 (travail de moine) : colonnes additives
end_time,status(annulé/reporté/complet) etquarantine(règles anti-aberrations, non publié mais réintégrable) ; règle d'ARCHIVAGE des événements terminés à chaque cycle (jamais supprimés) ; dedup_key inclut désormais l'heure (les séances multiples d'un même jour ne sont plus écrasées à l'affichage) ; alerte « 0 événement futur / chute > 80 % » par source (data/future_counts.json + /api/sources) ; heure et description La Vitrine ; end_time/organisateur/statut Eventbrite ; og:description Atuvu ; premières parties + portes + tournée evenko ; offres billets Bandsintown ; taxonomie type-event + description intégrale Brossard ; image Longueuil ; géocodage par ADRESSE CIVIQUE prioritaire ; villes normalisées au Répertoire MAMH (data/villes_canon.json) ; laval consignée « morte-a-la-source ».