Pépite 💎

Extension navigateur open source (Chrome, Firefox, Edge…) d'analyse de biens immobiliers en France. Ouvrez une annonce, Pépite vous dit si le prix est juste — données publiques (DVF, Géorisques, OSM…) + analyse IA avec vos propres clés API.

Projet personnel, sans backend : tout tourne dans votre navigateur, vos clés et vos données restent en local.

• Badge in-page sur l'annonce : score prix instantané vs ventes réelles du secteur (DVF)
• Side panel : prix/m², médiane des biens comparables, écart marché
• Analyse IA complète (un seul appel LLM ; les mails de négociation font un appel séparé, à la demande) : synthèse, points de vigilance, fourchette et arguments de négociation, checklist de visite, avis pour 4 profils (résidence principale, location nue, Airbnb, colocation)
• Rapport complet : comparables datés et adressés, coût total d'acquisition (frais de notaire), score global pondéré (prix, DPE, risques, quartier, tension locative), quartier (écoles, commerces, santé, transports, espaces verts via OpenStreetMap), risques (Géorisques), marché locatif (carte des loyers + zonage ABC), contexte communal (population, zonage PLU, taux de taxe foncière)
• Mails de négociation : 3 tons (assertif, modéré, aimable) générés à partir des données du rapport, à copier-coller
• Restyle IA 🛋️ : sélectionnez une photo de l'annonce et faites-la redécorer par Gemini selon un style (scandinave, industriel, japandi…) ou votre description — avec estimation du coût des travaux, slider avant/après, variantes sauvegardées
• Historique & comparateur : toutes vos analyses, comparaison côte à côte de 2-3 biens

Leboncoin, SeLoger et Citya (parseurs dédiés, instantanés) ; autres sites immobiliers (Bien'ici…) via extraction IA générique (nécessite une clé API).

Captures sur un bien fictif de démonstration — photos Unsplash, données simulées ; l'avant/après du studio est réalisé avec Gemini.

Rapport complet — synthèse IA, score global et recommandation :

Prix & marché (ventes DVF réelles, coût d'acquisition)	Quartier, risques et contexte communal

Studio Restyle IA — photo de l'annonce redécorée par Gemini, slider avant/après, variantes et estimation travaux :

Historique des analyses	Comparateur côte à côte

➕ Installer depuis le Chrome Web Store — un clic, mises à jour automatiques.

➕ Installer depuis Firefox Add-ons — un clic, mises à jour automatiques.

Sur Firefox, le panneau s'ouvre via l'icône Pépite de la barre d'outils (épinglez-la si besoin) ou la sidebar (Ctrl+Alt+S) — le badge affiché sur l'annonce ne peut pas l'ouvrir (Firefox réserve cette action à un clic direct sur l'extension). Au premier lancement, si un bandeau « Autoriser » apparaît, cliquez-le puis rechargez l'onglet.

git clone https://github.com/jonathan-pyt/pepite.git
cd pepite
pnpm install
cd packages/extension
pnpm build

Puis chrome://extensions → Mode développeur → « Charger l'extension non empaquetée » → packages/extension/.output/chrome-mv3.

Configuration : icône Pépite → clic droit → Options → choisir un provider (Gemini / Claude / OpenAI) et coller votre clé API. Le score prix fonctionne sans clé ; l'analyse IA, l'extraction générique et le Restyle en demandent une (Restyle = Gemini uniquement, ~0,04 $/image).

Pas de clé API ? Créez une clé Gemini gratuite en 2 minutes sur Google AI Studio (documentation). ⚠️ Le palier gratuit est limité en débit (quelques requêtes par minute et un quota journalier) — largement suffisant pour analyser des annonces au fil de vos recherches, mais le Restyle (génération d'image) peut nécessiter d'activer la facturation selon les quotas du moment.

packages/core        Logique métier en TypeScript pur (zéro dépendance Chrome)
  extraction/        Parseurs par site + extracteur générique LLM
  enrichment/        Géocodage BAN, DVF, OSM/Overpass, Géorisques, loyers, commune/PLU/TF
  scoring/           Score prix, score global pondéré, coût d'acquisition
  analysis/          Prompts + appels LLM (AI SDK v6, multi-provider)
  restyle/           Édition d'image Gemini + estimation travaux
packages/extension   Extension Chrome MV3 (WXT + React 19 + Tailwind v4 + shadcn/ui)

Le découpage core/extension permet de réutiliser toute la logique hors navigateur (tests, CLI, autre front).

pnpm install
pnpm test                              # tous les tests du workspace (Vitest : core + extension)
pnpm typecheck                         # dans chaque package
cd packages/extension && pnpm dev      # Chrome avec HMR

Tests e2e (Playwright, en local uniquement) : depuis packages/extension, npx playwright install chromium puis pnpm build avant de lancer pnpm e2e — les tests pilotent l'extension buildée dans un vrai Chrome.

L'annonce est lue depuis la page que vous visitez ; rien n'est envoyé ailleurs que chez votre provider LLM. Clés API stockées en local (chrome.storage.local), jamais synchronisées. Détails : politique de confidentialité.

Pépite est un outil d'aide à la décision, pas un conseil en investissement. Les scores, estimations de loyers, de travaux et de taxes sont indicatifs ; les rendus Restyle sont des projections IA (l'agencement réel doit être validé par un professionnel). Vérifiez toujours les données avant d'engager quoi que ce soit.

MIT