# Auto·Ka

# Toutes les voitures usagées à vendre au Québec. Un seul endroit.

www.auto-ka.com

Agrégateur indépendant de voitures usagées — chaque annonce avec ses photos, ses caractéristiques standardisées (année, km, transmission, carburant, VIN…) et un lien direct vers l'annonce originale du concessionnaire. Toujours à jour, automatiquement. Suivi des baisses de prix intégré.

# Pourquoi Auto-Ka ?

Chercher une auto usagée au Québec, c'est ouvrir des dizaines de sites de concessionnaires — chacun avec sa navigation, ses filtres, son format. Auto-Ka retourne le problème : un connecteur dédié par commerce visite chaque site à la source (aucune plateforme d'annonces revendue), normalise chaque véhicule vers un schéma unique et détecte les changements en continu.

Les sites de concessionnaires n'offrent pas de webhooks. Auto-Ka reproduit l'équivalent : synchronisation périodique + hash de contenu → arrivages, baisses de prix et ventes détectés automatiquement. Un véhicule qui disparaît du site source est marqué vendu dans Auto-Ka.

# Les chiffres

# L'architecture en 30 secondes

flowchart LR
    subgraph Sources["99 concessionnaires"]
        S1["D2C Media ×50 · SM360 ×8<br/>AMVOQ ×6 · EvalAuto ×11<br/>Convertus ×4 · customs<br/>HGrégoire · AED · Beaucage…"]
    end
    subgraph AutoKa["Auto-Ka"]
        C["Connecteurs<br/><i>1 adaptateur / plateforme</i>"] --> N["Normalisation<br/><i>schéma Vehicle unique</i>"]
        N --> D[("SQLite<br/>hash + diff + prix")]
        D --> A["API FastAPI<br/>/api/vehicles · /api/facets"]
        A --> F["React 18 + Vite<br/>filtres auto · fiches · stats"]
    end
    W["⏱ Watcher 2 h<br/>(PM2)"] -.-> C
    S1 --> C
    F --> U["🔑 Acheteur"]

# Le marché en direct

# Démarrage rapide

git clone https://git.spboucher.ai/auto-ka.git && cd auto-ka

# Backend
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt

# Frontend
cd frontend && npm install && npm run build && cd ..

# Sites derrière Cloudflare (optionnel)
echo "FIRECRAWL_API_KEY=fc-votre-cle" > .env

# Ingestion puis service
.venv/bin/python run.py sync            # toutes les sources (ou: run.py sync forceoccasion)
.venv/bin/python run.py serve 8080      # → http://localhost:8080
.venv/bin/python run.py watch 120       # resynchronisation en boucle (minutes)

# Ajouter un concessionnaire (≈ 6 lignes)

L'enregistrement est auto-découvrant : déposez un module dans autoka/connectors/ contenant une sous-classe de BaseConnector avec un source_id — c'est tout. Pour un site D2C Media (le fournisseur le plus répandu au Québec) :

# dans autoka/connectors/d2c_dealers.py
class MonConcessionnaire(D2CConnector):
    source_id = "monconcessionnaire"
    base_url = "https://www.monconcessionnaire.ca"
    dealer_name = "Mon Concessionnaire"
    city = "Sherbrooke"

Puis : .venv/bin/python run.py sync monconcessionnaire — et l'inventaire apparaît sur le site avec fiches, galeries et liens sources. Ajoutez l'entrée correspondante dans data/sources.json pour la page Sources.

# API

# Couverture

Grands réseaux — HGrégoire (mégacentres partout au Québec), Automobile En Direct, Occasion Beaucage (7 concessions), Le Prix du Gros, Méga Centre de liquidation, St-Jérôme Auto Dépôt, Ste-Foy Chrysler, Desmeules, Entrepôt Auto Durocher…

Toutes les régions — Montérégie, Capitale-Nationale, Laurentides, Mauricie, Laval, Estrie, Outaouais, Centre-du-Québec, Chaudière-Appalaches, Lanaudière, Montréal, Saguenay–Lac-Saint-Jean, Bas-Saint-Laurent, Abitibi-Témiscamingue, Côte-Nord, Gaspésie…

Chaque source non connectable est documentée avec sa raison dans data/sources.json (ex. : doublon d'inventaire d'un autre site du même groupe, vérifié par VIN).

# Production

Déployé sous PM2 (3 processus) derrière ngrok :

auto-ka-web     .venv/bin/python run.py serve 8095      # API + frontend
auto-ka-sync    .venv/bin/python run.py watch 120       # resync 2 h
auto-ka-ngrok   ngrok http --url=www.auto-ka.com 8095   # tunnel

Philosophie d'exploitation : on ne pousse que le code — le serveur maintient ses données lui-même.

# Principes

1. À la source — les annonces viennent des sites des concessionnaires eux-mêmes, jamais des plateformes d'agrégation existantes.
2. Politesse — délai ≥ 1 s entre requêtes, cache des pages détail (revalidation hebdomadaire), backoff sur rate-limit, User-Agent identifié.
3. Fidélité — aucun prix inventé : si la source n'affiche pas de prix, price = null (« Prix sur demande »).
4. Traçabilité — chaque fiche renvoie vers l'annonce originale.
5. Robustesse — un connecteur qui casse n'affecte jamais les autres ; un 404 (véhicule vendu) ne bloque jamais une source ; détection de dérive (chute de volume → retraits suspendus + alerte).