De la recherche locale
au suivi commercial.

Un outil local destiné à la prospection de commerces, PME et indépendants, particulièrement adapté à la vente de sites web, de référencement local et de services marketing.

État observé le 16 octobre 2026

Le serveur répond sur 127.0.0.1:8787. Aucun email réellement envoyé n’est enregistré dans la base actuelle. Le transport email est désactivé, la simulation est active, l’automatisation est inactive et aucune clé PageSpeed n’est configurée. Ces valeurs sont une photographie à la date de l’analyse, pas des compteurs en direct.

Le sous-dossier linkedin-agent contient une autre application, « Signal », prévue sur le port 8790. Ses fonctions LinkedIn ne sont pas intégrées aux menus ni aux fiches de ce CRM. Ce guide couvre le CRM du port 8787.

Inventaire du périmètre fonctionnel présent dans l’interface, le serveur et les commandes locales.

1. Démarrez l’application.

   Dans le dossier du projet, double-cliquez sur crm.cmd. Node.js doit être installé. Le serveur local doit rester en fonctionnement pendant l’utilisation.

2. Ouvrez le CRM.

   Accédez à http://127.0.0.1:8787/. Si la page est déjà ouverte, actualisez-la.

3. Connectez-vous.

   Saisissez votre identifiant personnel et votre mot de passe exactement ; « Afficher » aide à repérer une faute. N’ajoutez pas le point final d’une phrase au mot de passe.

4. Complétez votre signature.

   Ouvrez « Réglages », indiquez votre nom, votre entreprise, vos coordonnées et votre offre. Cliquez sur « Enregistrer ».

Utilisateurs et attribution des prospects

Votre compte historique est désormais administrateur. Dans Administration → Utilisateurs, créez les comptes de l’équipe en indiquant nom, identifiant, rôle et mot de passe d’au moins huit caractères. « Modifier » permet la réinitialisation du mot de passe, la modification du rôle et l’activation ou désactivation du compte.

1. Créez un utilisateur actif dans Utilisateurs.
2. Dans Prospects, cochez les fiches, choisissez le responsable dans Attribuer à, puis cliquez sur Attribuer.
3. Pour une seule fiche, utilisez le responsable dans l’onglet Suivi.
4. Dans Filtres → Responsable, choisissez tous les utilisateurs, un portefeuille ou les non attribués.

Une réattribution conserve les notes et échanges et arrête les séquences email concernées. Les prospects non attribués restent visibles uniquement par les administrateurs. Une nouvelle collecte ne modifie pas le responsable existant. Les comptes sont désactivables mais pas supprimables ; leurs prospects restent attribués jusqu’à réaffectation.

Les contrôles s’appliquent côté serveur : les fiches d’un autre utilisateur restent inaccessibles par URL, export ou API. Une modification de compte invalide ses sessions existantes, sauf la session courante de l’administrateur qui modifie son propre compte. Il est impossible de désactiver son propre accès administrateur. Cette fonction ne rend pas le CRM accessible automatiquement depuis d’autres ordinateurs : il reste local sur 127.0.0.1.

Préparer Google Maps

La collecte nécessite Google Chrome installé et Playwright. Le CRM réutilise une session Chrome externe sur le port 9222 si elle existe ; sinon il démarre automatiquement un navigateur sans fenêtre, avec un profil dédié, puis le ferme à la fin. Lancez une seule prospection à la fois. Une adresse PROSPECTION_CDP configurée explicitement doit être disponible : elle ne bénéficie pas du repli automatique. Le détail du diagnostic figure en annexe.

Le menu principal est organisé en trois espaces : Pilotage, Prospection et Administration. Les segments se trouvent dans le sélecteur « Segment » de la page Prospects. Ouvrez « Filtres » pour préciser la liste ; le compteur indique le nombre de filtres actifs.

Dans Prospects et Pipeline, le menu Outils contient OpenStreetMap, la réanalyse Google, PageSpeed, l’export et, pour la liste, la densité d’affichage. « Nouvelle prospection » reste accessible en haut de chaque page. Sur mobile, le bouton de menu ouvre la navigation ; le choix d’une vue referme le menu.

Recherche, tri et sélection

Dans la liste, recherchez un nom, une ville, un email, un téléphone, un site, une catégorie, une requête source, des notes ou un contact. Combinez les filtres statut, pays, angle commercial, ville, score minimum et les bascules Sans site / Avec email / Non enrichis.

Le menu de tri propose score, récence, nombre d’avis, note Google, nom, ville, relance et dernière modification. Le nombre de lignes par page se règle dans « Réglages ». Le bouton de densité commute entre affichage normal et compact.

Cochez les leads à traiter. La case de l’en-tête sélectionne la page affichée. La sélection peut persister d’une page à l’autre ; elle est remise à zéro lorsque vous changez de vue. Contrôlez le nombre indiqué dans la barre avant une action groupée. « Tout désélectionner » vide la sélection.

Les champs de l’interface prévoient 1 à 200 fiches par requête en lot et 1 à 100 requêtes. Le volume réellement collecté dépend des résultats Google et du déroulement de la tâche.

Mode rapide : comprendre le compromis

Il lit la liste de résultats sans ouvrir complètement chaque établissement. Le téléphone et le site peuvent donc manquer. Un enrichissement de site exige une URL déjà connue : relancez une collecte complète pour obtenir les coordonnées manquantes. Une fiche rapide « sans site » doit être qualifiée avant utilisation commerciale.

Résultats et suivi

Le CRM enregistre notamment le nom, la catégorie, l’adresse, le pays, le téléphone, le site, les liens Google, la note et le nombre d’avis, les horaires et les coordonnées géographiques lorsque disponibles. Une même clé de lieu Google entraîne une mise à jour, avec conservation des champs de suivi commercial.

La recherche s’exécute en arrière-plan. L’indicateur en haut de page et l’historique de « Nouvelle prospection » aident à suivre la collecte. Le Journal fournit des détails d’actions et d’erreurs. Il n’existe pas encore de bouton universel pour annuler ou reprendre une tâche.

1. Analysez les sites.

   Ouvrez « À enrichir », cochez les leads, puis « Analyser les sites ». Une fiche individuelle possède aussi ce bouton. Le CRM lit le HTML de la page d’accueil et de pages utiles pour rechercher contacts, réseaux, technologies et mentions légales.

2. Complétez avec OpenStreetMap.

   Utilisez le bouton de la barre haute pour traiter jusqu’à 25 candidats sans email, ou « OpenStreetMap » sur une sélection. Le rapprochement peut apporter des coordonnées, mais n’assure pas de trouver un email pour chaque entreprise.

3. Réanalysez les informations Google.

   « Reparser Google » et « Analyser fiche Google » relisent le texte déjà stocké. Ils ne visitent pas une nouvelle fois Google et ne rafraîchissent pas les avis ou les horaires en direct.

4. Mesurez les sites prioritaires.

   Choisissez « Auditer PageSpeed » dans la fiche ou sur une sélection. Le bouton de la barre haute lance un petit lot de trois sites à auditer. Consultez ensuite les résultats dans les fiches et dans « Sites à optimiser ».

Lire le score

Le score est une somme de règles commerciales, bornée entre 0 et 100. Il sert à prioriser les besoins potentiels pour une offre digitale ; il ne mesure pas la probabilité de signature ni le budget du prospect. L’argumentaire et les messages sont produits par des règles et des modèles de texte, sans appel IA dans le CRM actuel.

La fiche est organisée en quatre onglets : Suivi (argumentaire, statut, contact, relance, notes et tags), Coordonnées (contacts et mentions légales), Diagnostic (Google, site, audit et angles) et Historique (échanges). Les champs restent en place lorsque vous changez d’onglet ; cliquez sur Enregistrer pour conserver les modifications.

Cliquez sur une ligne ou une carte pour ouvrir la fiche latérale. Elle réunit l’argumentaire, le suivi commercial, les coordonnées, les données Google, l’analyse web, la publicité, les résultats OpenStreetMap, le profil Google Business, l’audit PageSpeed, les informations légales, les angles et l’historique disponibles.

Mettre à jour une fiche

1. Choisissez le statut et saisissez le nom du contact.
2. Définissez la date de relance et des étiquettes séparées par des virgules.
3. Complétez les notes internes puis cliquez sur Enregistrer.
4. Pour conserver un échange daté, écrivez-le dans « Historique des échanges » puis cliquez sur Ajouter.

Les champs directement éditables dans la fiche sont le statut, le contact, la relance, les étiquettes et les notes. Les coordonnées enrichies sont essentiellement affichées en lecture ; leur modification est possible par l’API, sans éditeur complet dans cette interface.

Déplacer une carte

Dans Pipeline, faites glisser la carte vers le statut cible. Le changement est enregistré immédiatement. Vous pouvez aussi utiliser le menu Statut directement sur la carte, au clavier ou sur mobile ; le changement est enregistré immédiatement. La fiche propose également le statut puis « Enregistrer ». Les cartes affichent l’entreprise, la catégorie, la ville, le score, les contacts et la relance si elle existe.

Les relances échues sont mises en évidence. Le déplacement d’une carte change le statut, sans planifier automatiquement une nouvelle date. Les filtres de la liste s’appliquent au pipeline.

Ouvrir les contacts

Depuis la fiche, les liens Téléphone et Email utilisent les applications configurées sur votre ordinateur ; WhatsApp ouvre le service correspondant. Les sites web, réseaux sociaux et fiches Google s’ouvrent par lien. Le CRM ne passe pas lui-même les appels et ne contient pas de messagerie instantanée intégrée.

Les filtres modifiés ne changent la session qu’après application. Les prospects déjà passés sont exclus de cette session. Le bilan distingue les résultats enregistrés et les fiches passées. Un brouillon doit être enregistré avant de recommencer ; quitter la session demande confirmation si des notes ne sont pas enregistrées.

Après une coupure réseau, « Réessayer l’enregistrement » reprend la même opération sans dupliquer les notes ni l’échange. Si un autre utilisateur a modifié la fiche, « Actualiser la fiche » recharge ses données en conservant votre brouillon. Les dates sont calculées selon le calendrier de Bruxelles.

1. Ouvrez « Mode appel ».

   Le CRM propose par défaut les statuts Nouveau, À contacter et À relancer avec un téléphone et une échéance atteinte ou sans date. La file reprend vos filtres et votre segment de Prospects. Elle charge les fiches progressivement, sans troncature aux 300 premiers prospects.

2. Préparez l’échange.

   Consultez l’argumentaire et les trois premiers angles. Ouvrez la fiche ou copiez le script si nécessaire. Le numéro cliquable utilise votre application téléphonique.

3. Saisissez les notes puis choisissez une issue.

   Les quatre boutons enregistrent ensemble le résultat, les notes et l’historique puis passent à la fiche suivante. « Enregistrer les notes et passer » conserve les notes sans changer le statut ni la relance. Sans notes, « Passer sans résultat » ne crée pas d’appel fictif.

Le résultat et les notes sont ajoutés à l’historique. « Intéressé → RDV » ne crée pas d’événement dans un agenda. Pour une date précise, modifiez la fiche ou sélectionnez plusieurs leads et utilisez la date puis « Relancer dans… ».

Email individuel

Dans une fiche disposant d’un email, cliquez sur Écrire un email. Le CRM prépare un objet et un message à partir du principal angle commercial et de votre signature, copie le texte et ouvre votre messagerie. Relisez et adaptez le message avant de l’envoyer depuis cette messagerie. Cet envoi externe n’est pas automatiquement confirmé ni inscrit comme envoyé dans le CRM ; ajoutez votre suivi manuellement.

Séquence de prospection

1. Préparez les réglages.

   Renseignez signature et expéditeur. Choisissez Brevo ou Webhook n8n et les paramètres nécessaires. Pour découvrir le mécanisme, gardez la simulation active.

2. Inscrivez les leads.

   Utilisez « Inscrire séquence » dans la fiche ou la barre de sélection. Une adresse email est nécessaire. Les statuts Client, Rendez-vous et Écarté sont exclus.

3. Lancez une simulation.

   Dans « Séquences email », cliquez sur « Simuler les étapes dues ». Le CRM journalise l’essai et ajoute une interaction simulée, mais ne contacte pas le destinataire et ne fait pas avancer l’étape.

4. Passez à un envoi réel quand votre préparation est terminée.

   Enregistrez un transport configuré, désactivez la simulation, puis utilisez « Envoyer réellement les étapes dues ». L’interface demande confirmation. Vous pouvez d’abord utiliser « Envoyer un vrai email test » dans les réglages vers l’expéditeur configuré.

5. Suivez et arrêtez les séquences.

   Consultez les étapes dues ou planifiées et les derniers envois. « Arrêter » interrompt le suivi. « Réponse reçue » ajoute une interaction et arrête la séquence : cette déclaration est manuelle.

Le rythme par défaut vise J0/J3/J8 si chaque étape part à l’échéance. Les délais suivants sont calculés à partir des envois réellement réussis. Un retard décale donc la suite.

Automatisation et historique

Si le transport réel est configuré, la simulation désactivée et l’option automatique cochée, le serveur vérifie les échéances toutes les minutes. Il traite jusqu’à 20 leads par passage avec le plafond quotidien configuré. Le délai entre messages est de 20 secondes par défaut dans la configuration.

Le serveur doit rester actif. Fermer l’onglet ou cliquer sur Déconnexion ne coupe pas l’automatisation. Désactivez-la dans Réglages pour l’arrêter. Les statuts Client, Rendez-vous et Écarté sont écartés des étapes dues ; cela n’efface pas nécessairement l’inscription stockée.

Le tableau présente les inscrits, les échéances, les envois, les échecs et le volume du jour. Le statut « envoyé » correspond à une réponse positive du transport ; il ne prouve ni la livraison ni la lecture. Pour n8n, un webhook accepté ne garantit pas que le workflow a livré le message.

Examiner un doublon possible

Ouvrez Doublons à vérifier. La détection utilise un même nom normalisé dans la même ville et le même pays, un téléphone identique ou un email identique. Un domaine commun complète les indices d’une paire déjà trouvée ; il n’est pas utilisé seul pour en créer une.

1. Lisez les signaux communs et le niveau « Correspondance forte » ou « À vérifier ».
2. Comparez les deux fiches : entreprise, ville, téléphone, email, domaine et statut.
3. Ouvrez chaque fiche pour consulter les notes et l’historique avant de décider.
4. Utilisez « Masquer » si la suggestion n’est pas pertinente. Le masquage reste dans ce navigateur.

Une ligne téléphonique partagée ne suffit pas à prouver un doublon. La détection n’effectue pas de fusion. Le masquage ne se synchronise pas entre navigateurs et il n’existe pas de bouton de restauration des alertes masquées.

Supprimer un ou plusieurs leads

La corbeille n’est pas vidée automatiquement. « Supprimer définitivement » exige une nouvelle confirmation ; les sauvegardes existantes sont conservées. Les suppressions antérieures à l’installation de cette fonction ne sont pas récupérables depuis la corbeille. Un email déjà transmis ne peut pas être rappelé.

Sauvegardes automatiques et manuelles

Une sauvegarde complète est créée toutes les 24 heures pendant le fonctionnement du serveur, avec contrôle au démarrage puis chaque heure. Le CRM crée aussi une copie avant mise en corbeille ou purge. Le bouton Créer une sauvegarde maintenant produit une copie immédiate. Les sauvegardes sont conservées sans effacement automatique dans data/sauvegardes/.

Chaque dossier contient une base SQLite cohérente, vérifiée, ainsi que la configuration et le compte local lorsqu’ils existent. Le téléchargement de l’interface fournit uniquement la base ; les copies de réglages et du compte restent dans le dossier. Les sauvegardes locales ne protègent pas d’une panne du disque : conservez aussi une copie sur un autre support.

node outils-restaurer-sauvegarde.cjs sauvegarde-IDENTIFIANT --confirmer

Le statut Écarté permet de conserver une fiche pour mémoire. Il bloque les nouvelles inscriptions aux séquences et l’exécution des étapes dues pour ce statut.

Exporter depuis l’interface

Dans une liste, réglez vos filtres puis utilisez l’icône Exporter la vue courante. Pour cibler des fiches, cochez-les et choisissez Exporter dans la barre de sélection. Le téléchargement est un CSV avec séparateur point-virgule et encodage UTF-8 adapté à Excel en français.

Le CSV inclut identité, contacts, score, statut, angles, argumentaire, site, adresse, données Google, réseaux, technologie, mentions légales, provenance OpenStreetMap, notes et dates de création/enrichissement. Il ne contient pas tous les champs récents comme les tags, relances, audits et séquences. Le JSON des leads est plus complet, mais n’inclut pas toute la base relationnelle ni les réglages.

Les formats JSON et CSV de préparation d’import HubSpot/Pipedrive existent via API ou commande locale ; il n’y a pas de sélecteur de format dans l’interface. Ils ne constituent pas une connexion ou une synchronisation directe avec ces CRM.

Lire le tableau de bord

« Statistiques » présente : total de leads, leads chauds, candidats à appeler, relances dues, score moyen, présence de site et d’email, indices de publicité, fiches à enrichir, fiches Google à reprendre, audits réalisés et faibles, étapes email dues. Il détaille aussi les compléments OpenStreetMap, les statuts, tranches de score, angles fréquents, principales villes et ajouts par jour.

L’entonnoir correspond à la répartition actuelle des statuts. Il ne calcule pas les conversions historiques, les durées de traitement, le chiffre d’affaires ou le retour sur investissement. Le compteur « À appeler » utilise la même règle que la file standard : téléphone disponible, statuts Nouveau/À contacter/À relancer, sans échéance future. Dans la session, le compteur de navigation affiche le nombre restant avec les critères appliqués.

Journal et sauvegarde

Le Journal restitue les dernières actions enregistrées et leurs détails. Les recherches ont leur propre historique. La vue Corbeille & sauvegardes propose désormais les sauvegardes automatiques et manuelles de la base, de la configuration et du compte. SQLite produit une copie cohérente, incluant les données du journal WAL ; son intégrité est vérifiée avant sa publication.

Les clés configurées sont masquées dans le navigateur ; elles restent stockées en clair dans le fichier de configuration local. Les mots de passe des utilisateurs sont stockés sous forme de dérivés scrypt avec sel dans SQLite. Le fichier auth.json sert uniquement à la migration initiale du compte historique.

Les raccourcis de navigation sont prévus hors des champs de saisie. L’affichage compact est mémorisé dans ce navigateur. Les liens directs #lead-ID et #vue-pipeline fonctionnent sur cette installation locale après connexion ; ils ne rendent pas les données accessibles depuis un autre ordinateur.

Constats de lecture du code actuel. Ils expliquent certaines différences entre les intitulés de l’interface et le comportement réel. La corbeille et les sauvegardes ont été ajoutées après la première édition ; leurs parcours sont décrits en rubrique 10. Les autres limites ci-dessous restent à traiter.

La vérification documentaire confirme le code présent et la lecture des données locales. Elle ne constitue pas une validation de bout en bout de Google Maps, OpenStreetMap, PageSpeed, Brevo ou n8n. Les résultats d’extraction restent dépendants des pages et services consultés.

Une progression en trois lots : fiabiliser les fonctions existantes, accélérer le travail commercial, puis mesurer les résultats. Le pipeline, la détection de doublons et la suppression sont déjà disponibles.

Pour l’administration et les intégrations. Les parcours utilisateur décrits plus haut ne nécessitent pas de connaître ces détails.

node prospection.cjs serve --port 8787
node prospection.cjs check
node prospection.cjs search "électricien Namur" --max 30 --pays BE
node prospection.cjs batch --secteurs "coiffeur,dentiste" --villes "Liège,Namur" --max 20 --limite 4
node prospection.cjs enrich --limit 30
node prospection.cjs osm --limit 25
node prospection.cjs gbp
node prospection.cjs audit --limit 3
node prospection.cjs sequence status
node prospection.cjs sequence run
node prospection.cjs mail test --to contact@example.com
node prospection.cjs export --format json
node prospection.cjs stats

Sources : code local de l’interface et du serveur, modules de collecte/enrichissement/scoring/doublons/email/export/configuration, aide de la commande principale, manifeste du projet et lecture seule de la base SQLite. Le README est une source complémentaire : certaines de ses descriptions ne reflètent pas les ajouts récents. Ce document est autonome, sans bibliothèque ni ressource distante nécessaire à sa lecture.