JobScout

Trouvez des offres d'emploi grâce à un scan multi-plateformes, triez-les avec un score calculé sur votre vrai profil, et générez pour chacune un CV et une lettre de motivation d'une page (compatibles ATS), sans jamais inventer une compétence que vous n'avez pas.

Tout tourne sur votre machine : base SQLite locale, serveur limité à 127.0.0.1, aucun compte à créer. Seuls sortent les recherches envoyées aux sites d'offres pendant un scan et, si vous utilisez une IA en ligne, les textes transmis au fournisseur que vous avez choisi, plus quelques requêtes techniques (détail).

Site et guide de démarrage : https://latenightsbeats1208-pixel.github.io/jobscout/ · Installation · Installation sur Mac · Guide de l'IA · Conditions d'utilisation · Confidentialité

En vidéo, moins de 2 minutes chacune : 1. Installation · 2. Mise en place · 3. Utilisation

• Next.js 15 (App Router) + React 19 + TypeScript + Tailwind
• IA au choix — Anthropic Claude (référence : Opus 4.8 pour la rédaction, Sonnet 5 pour la relecture), OpenAI, Google Gemini, Mistral, DeepSeek, Groq, OpenRouter, Ollama et LM Studio en local, ou tout serveur compatible OpenAI. Deux modèles par fournisseur : un de rédaction (extraction du CV, CV, lettre, message V.I.E) et un de relecture (relecture, traduction anglaise, réparation ciblée de la lettre). Couche commune : lib/ai/llm.ts ; catalogue : lib/ai/providers.ts.
• Tests : Vitest (npm test) et intégration continue GitHub Actions (types, tests, build sur Windows, Linux et macOS à puce Apple avec Node 22, 24 et 26, et sur Mac Intel avec Node 24 ; sur les deux types de Mac, le parcours du guide Mac est rejoué : npm ci, démarrage, moteur LinkedIn installé puis lancé, lanceur)
• SQLite intégré (node:sqlite, WAL) + fichiers locaux
• Scraping : fetch + parsing DOM (jsdom) + JSON-LD JobPosting ; Playwright uniquement pour LinkedIn
• @react-pdf/renderer + docx pour les documents générés ; xlsx pour l'import/export des candidatures

Première installation ? Suivez le guide pas à pas : prérequis, durée de chaque étape (mesurée), messages normaux, ordinateur à laisser allumé ou non, problèmes fréquents.

Sur Mac ? Suivez le guide Mac : les mêmes étapes, avec les gestes du Mac (Terminal, installeur de Node.js, lanceur à double-cliquer).

En vidéo : installation · mise en place · utilisation. Elles ont été tournées sous Windows ; sur Mac, le guide Mac dit ce qui s'y applique.

En résumé (repères établis sous Windows) : environ 10 à 20 minutes au total avec les réglages par défaut (jusqu'à 35 si vous activez d'autres sources), dont 10 à 15 devant l'écran. npm ci prend environ 1 minute ; le premier scan dure 1 à 3 minutes avec France Travail seule, 10 à 20 minutes avec toutes les sources. Pendant ce temps, l'ordinateur doit rester allumé (hors veille), le terminal ouvert.

Requiert Node ≥ 22.13 (module node:sqlite sans drapeau expérimental ; Node 24 convient). Au démarrage, Node affiche ExperimentalWarning: SQLite is an experimental feature : c'est normal et sans effet.

git clone https://github.com/latenightsbeats1208-pixel/jobscout.git
cd jobscout
npm ci
npm run dev

L'app démarre sur http://127.0.0.1:3000 (écoute limitée à la machine locale, rien n'est exposé au réseau). Sous Windows, scripts/Start-JobScout.ps1 lance le serveur de développement et ouvre le navigateur. Sur Mac, npm run shortcut:mac (après npm ci) crée un lanceur JobScout.command dans le dossier du projet, avec une copie sur le Bureau : un double-clic ouvre le Terminal, démarre JobScout avec caffeinate -i (pas de mise en veille automatique tant qu'il tourne) et ouvre http://127.0.0.1:3000 dès qu'il répond (guide Mac).

IA à configurer dès l'inscription : l'onboarding lit votre CV avec un modèle d'IA pour créer le profil. Pas à pas, pour une clé payante ou une IA gratuite en local (Ollama, LM Studio) : guide de l'IA. Dans l'écran « Génération IA », choisissez votre fournisseur et collez votre clé :

« Charger la liste » propose les modèles disponibles chez le fournisseur, « Vérifier » teste la connexion. Les clés restent dans la base locale, enregistrées en clair (non chiffrées) : protégez l'accès à votre ordinateur. Une adresse de serveur doit être en https://, sauf serveur sur la machine même (http://127.0.0.1…). Mode développement : une ANTHROPIC_API_KEY dans .env sert de repli si rien n'est configuré.

LinkedIn (optionnel) : c'est la seule source qui a besoin d'un navigateur Chromium. Cochez-la dans Profil › Recherche › Sources : l'encadré « Moteur LinkedIn requis » apparaît, cliquez « Installer le moteur LinkedIn » (~100 Mo à télécharger, ~265 Mo sur le disque). En ligne de commande : npm run playwright:install.

Mises à jour : arrêtez JobScout (Ctrl + C), puis git pull et npm ci.

Messages npm normaux : npm warn deprecated node-domexception, « packages are looking for funding », et, avec npm récent, le script d'installation de tesseract.js ignoré (il n'affiche qu'un appel aux dons). npm audit --omit=dev, qui ne regarde que ce qui tourne réellement, doit afficher found 0 vulnerabilities (le PostCSS embarqué par Next.js est forcé en version corrigée via overrides). npm audit complet signale des failles dans des outils de développement (Tailwind CSS et ses dépendances), sans effet sur l'application. Ne lancez jamais npm audit fix --force : il installerait Tailwind CSS 4, incompatible.

npm run package produit installer/output/JobScout_Setup_v<version>.exe : un installeur autonome (Node 22 LTS embarqué, aucune dépendance sur la machine cible), avec launcher natif, données sous %LOCALAPPDATA%\JobScout et contrôle anti-fuite de données personnelles bloquant. Voir installer/README.md.

Windows uniquement : la commande a besoin d'Inno Setup 6 (ISCC.exe) et embarque un Node pour Windows (win-x64). Sur Mac ou Linux, elle échoue après la compilation de Next.js. Sur Mac, JobScout se lance depuis les sources : voir le guide Mac.

Avant d'activer une source, lisez les conditions d'utilisation (sections 5 et 6) : les conditions de Welcome to the Jungle, HelloWork, Talent.com et LinkedIn interdisent l'extraction automatisée. C'est pourquoi, depuis la 3.4.13, seule France Travail est cochée d'office. Chaque source s'active ou se désactive dans Profil › Recherche › Sources (ou à l'étape Préférences de l'onboarding). Une source suspendue n'est jamais interrogée, même si elle est restée cochée dans un ancien profil. Une source hors périmètre géographique (ex. HelloWork quand le profil ne cible pas la France) est automatiquement sautée. La disponibilité des sources dépend des sites tiers (anti-bot, changements d'API) ; une source en échec est signalée dans le journal du scan.

WTTJ est interrogée avec la clé de recherche (lecture seule) qu'utilise l'interface du site. Si elle cesse de fonctionner, décochez la source.

lib/scoring/local.ts — critères exposés dans le détail de chaque offre :

• Secteur (30 %) — titre et description comparés aux secteurs cibles du profil
• Compétences (50 %) — une compétence ancrée dans une expérience pèse davantage qu'une compétence simplement listée
• Pays (20 %) — 100 si le pays de l'offre fait partie des pays cibles, 0 sinon ; neutre si l'offre n'a pas de pays ou si aucun pays cible n'est déclaré
• Contrat (±10) — selon les contrats recherchés du profil (preferred_contracts, par défaut CDI et CDD) : +10 si le contrat de l'offre en fait partie, neutre s'il est inconnu, −6 s'il est identifié mais non recherché
• Bonus Langue (jusqu'à +8) — +8 si l'offre est rédigée dans une langue maîtrisée (B2+) ; +2,4 si elle n'est pas en anglais mais que l'utilisateur maîtrise l'anglais
• Bonus Durée V.I.E (jusqu'à +5, V.I.E uniquement) — +5 pour 12–24 mois, +3 pour 6–11 mois

Aucun appel IA : instantané et illimité. Re-scoring global : POST /api/offres/rescore (après modification du profil).

Cascade selon le type de fichier : PDF (pdf-parse ou pdfjs-dist multi-colonnes, meilleur retenu), DOCX (mammoth), image (tesseract.js FR+EN), TXT. Les modèles de reconnaissance d'image (FR, EN) sont téléchargés une fois depuis cdn.jsdelivr.net. Puis extraction structurée par le fournisseur d'IA choisi (appel d'outil forcé, ou réponse JSON contrainte selon le fournisseur), validation Zod, score de confiance et garde-fou anti-hallucination (suppression des entreprises et compétences non ancrées dans le profil).

data/documents/… — CV et lettre en PDF et DOCX, avec une boucle de rétrécissement qui garantit une page A4. Langue détectée par offre (français, ou anglais si l'annonce est en anglais). Relecture automatique : orthographe, affirmations non étayées par le profil. Message court (V.I.E) réservé aux offres V.I.E.

Coût : avec Claude (Anthropic), environ 0,12 à 0,20 $ par dossier (CV + lettre, relecture comprise) aux tarifs actuels, selon la longueur du profil et de l'offre. Avec un autre fournisseur, le coût suit ses tarifs ; en local (Ollama, LM Studio), il est nul. Le nombre de jetons de chaque appel est écrit dans le journal du serveur ([llm] …).

Qualité selon le modèle : les garde-fous anti-invention (validation contre le profil, limites de mise en page) s'appliquent quel que soit le modèle. Mais JobScout a été mis au point avec Claude : avec un autre modèle, relisez vos premiers documents. Si un modèle renvoie une réponse mal formée, JobScout tente un repli (mode JSON, extraction tolérante) avant d'afficher une erreur qui invite à choisir un modèle plus capable.

• Serveur limité à 127.0.0.1 ; l'API refuse les requêtes venant d'un autre site ou d'un hôte non local (middleware.ts)
• Clés IA stockées en clair dans la base locale, jamais renvoyées au navigateur (seuls les 4 derniers caractères sont affichés)
• Aucune télémétrie : JobScout n'envoie rien à son éditeur, et les scripts de lancement (npm run dev, npm run build) coupent celle de Next.js (scripts/next.mjs) — voir Confidentialité
• Whitelist de colonnes sur la mise à jour des candidatures (anti mass-assignment)
• Bornage des chemins d'écriture du dossier documents ; ouverture de dossier restreinte au dossier configuré
• Descriptions d'offres assainies (DOMPurify) ; rel="noopener noreferrer" sur tous les liens sortants

JobScout est gratuit (licence MIT), sans compte ni abonnement. Modes IA (lib/ai/client.ts) : byok (votre clé ou votre modèle local, fournisseur au choix) ; unset (rien de configuré : l'onboarding reste bloqué à l'import du CV). Le code contient aussi un mode pack (relais défini par JOBSCOUT_PROXY_URL) : il est inactif dans cette version, aucun relais n'étant configuré.

npm test            # tests automatiques (Vitest) : couche IA, fournisseurs, configuration, génération de bout en bout
npm run typecheck   # vérification des types

Les tests n'utilisent ni clé ni réseau : un faux serveur compatible OpenAI rejoue la génération complète (prompts, validation anti-invention, relecture). GitHub Actions les lance à chaque push et pull request (.github/workflows/ci.yml).

Test réel optionnel avec votre propre fournisseur (appels facturés par lui, quelques centimes) :

JOBSCOUT_LIVE=1 JOBSCOUT_LIVE_PROVIDER=openai JOBSCOUT_LIVE_KEY=sk-... npx vitest run tests/live

MIT — voir LICENSE. Les marques des sites scannés appartiennent à leurs propriétaires ; JobScout n'est affilié à aucun d'eux.

Utilisation : conditions générales d'utilisation. Données personnelles : politique de confidentialité.