Mes agents IA cherchent des clients pour moi. Dans une vraie ville.

Qu’est-ce que le QG des agents ?

C’est une équipe d’agents IA qui cherche des clients dans une vraie ville, et une interface pour la regarder travailler. Tu choisis une ville sur la carte, un métier et ce que tu vends. L’équipe trouve les commerces, lit leur site, note ce qui leur manque et prépare un premier mail. Toi, tu relis et tu valides.

Ce ne sont pas des chiffres inventés : c’est la mission du 20 octobre 2026, que tu vois tourner plus haut. Ce n’est pas une animation non plus. Chaque robot est un vrai agent, et ce sont de vraies salles de Lyon, avec leur vrai site. Aucun des sept mails n’est parti tout seul.

Comment je l’ai fait avec Claude Code ?

Je n’ai pas écrit une ligne de code. J’ai décrit ce que je voulais à Claude Code, à l’oral, en longs messages vocaux : l’équipe, ce que chacun fait, ce que je voulais voir à l’écran. Puis j’ai regardé, et j’ai dit ce qui n’allait pas, avec mes mots.

Le premier message posait tout : les quatre rôles, l’outil qui tourne sur mon ordinateur, et une règle non négociable, rien ne part sans ma validation. Ensuite, chaque retour tenait en quelques phrases. Voici les vrais, et ce que Claude Code en a fait.

1. Retour 1

   « Les trucs en 3D avec mon logo, ça ne parle pas aux gens. Je veux de vrais agents en mode robot, des robots bien faits, avec une bonne DA, comme dans mon Bureau. »

   Fait : les robots du Bureau des agents, avec un corps, des bras et un accessoire par métier, dans la vraie ville dessinée en pixel art.

2. Retour 2

   « Ce n’est pas très clair qu’ils parcourent la carte, qu’ils vont voir tel ou tel commerce. Rends ça plus vidéoludique, gamifié, super propre. »

   Fait : le chemin se trace jusqu’au commerce avant chaque départ, l’éclaireur scanne la ville avec une onde radar, et au-dessus du commerce lu, un hologramme montre ce qui lui manque.

3. Retour 3

   « Sur la carte de France, je veux toutes les villes quand on zoome. Et un encadré pour mettre son offre, pour que le mail soit personnalisé. »

   Fait : la carte de France en pixel art, où chaque village apparaît en zoomant, et le panneau de lancement : métier, zone, nombre, e-mails et téléphones, ton offre, tes consignes de mail.

4. Retour 4

   « Ils font beaucoup de texte, ça gâche la vue. Il faut que mon public comprenne. »

   Fait : plus de journal à l’écran. Les robots se parlent en phrases courtes (« Léo, trouve-les-moi », « 25 sur la carte ! »), et le détail part dans la fiche du commerce.

5. Retour 5

   « Mets-le en open source. Chacun doit prendre sa propre clé, pas la mienne. »

   Fait : le QG est sur GitHub, sans aucune clé. Claude Code te dit lui-même ce qu’il te faut à l’installation.

Comment ça marche ?

Quatre rôles, chacun fait une seule chose. Ce sont de vrais programmes qui tournent sur ton ordinateur : ils interrogent la carte, ouvrent les sites, et c’est Claude Code qui écrit les mails.

Voici chaque moment, tiré de la mission de Lyon.

1. 01Tu choisis la ville

   La carte de France, puis la plongée sur la ville : chaque immeuble, chaque rue, chaque arbre viennent d’OpenStreetMap.

2. 02Léo scanne la ville

   Max envoie l’équipe. L’éclaireur monte sur le toit du QG, son onde part sur la ville, et chaque salle s’allume quand elle la touche.

3. 03Les lecteurs partent

   Le chemin se trace jusqu’à la salle, par les vraies rues, puis le lecteur y court.

4. 04Un lecteur lit le site

   L’immeuble s’allume, et l’hologramme du site montre ce qui manque : réservation en ligne, chat, WhatsApp. Puis la note tombe.

5. 05Le rédacteur écrit le mail

   Avec ton offre et ce que le lecteur a vu. Le mail part dans la file « En attente de ta validation ».

6. 06Rien ne part sans toi

   À la fin, chaque client potentiel s’allume dans la ville. Les mails t’attendent : tu les relis, tu valides.

Comment l’équipe choisit les clients potentiels

Chaque commerce reçoit une note sur 100, et chaque point est expliqué en une ligne. Pas de boîte noire : tu vois pourquoi un commerce est retenu. Pour mon offre, ce qui compte, c’est un commerce qui reçoit des demandes et n’a personne pour y répondre :

• +25 : pas de réservation en ligne
• +10 : personne pour répondre sur le site
• +10 : ouvert tard, donc des demandes à toute heure
• +5 : pas de WhatsApp
• −20 : aucune adresse de contact affichée

Un commerce est retenu à partir de 60, et seulement s’il affiche une adresse : celle de son site, ou celle du gérant. Les règles se changent en une phrase dans Claude Code, pour coller à ton offre.

Comment installer le QG des agents en une phrase ?

Il te faut seulement Claude Code, installé et connecté à ton compte. Ouvre-le, et colle cette phrase :

Installe et lance le QG des agents : https://github.com/devlikemasta/qg-des-agents

Claude Code lit le projet et fait le reste. Voici ce qui se passe, dans l’ordre.

Étape 1Il vérifie ton ordinateur

Il regarde si Node.js est installé, en version 22.13 ou plus récente. Sinon, il te propose de l’installer depuis nodejs.org. Puis il télécharge le QG et installe ce qu’il faut.

Étape 2Il te dit quelle clé il te faut (aucune n’est obligatoire)

Les commerces viennent d’OpenStreetMap, gratuitement, et les mails sont écrits par Claude Code avec ton abonnement. Tu n’as aucune clé à créer pour commencer. Une seule est facultative : une clé Google Maps, pour relier chaque commerce à sa fiche Google. Si tu la veux, Claude Code te guide pour la créer avec ton propre compte Google, et la range dans un fichier qui reste sur ton ordinateur. Tu ne la colles jamais dans la conversation.

Étape 3Il te demande ton offre

En trois lignes : ce que tu vends, pour qui, ta signature et ton site. Tu peux aussi l’écrire dans le panneau de lancement. C’est ce qui personnalise chaque mail.

Étape 4Il lance le QG, et tu choisis ta ville

Le QG s’ouvre dans ton navigateur. Commence petit : une ville, un métier, 5 commerces. Regarde l’équipe travailler, puis ouvre les fiches.

Que peux-tu faire dans le QG ?

• Lancer une mission dans n’importe quelle ville de France, de Belgique ou de Suisse : le métier, la zone, le nombre de commerces, combien de mails préparer.
• Ouvrir la fiche d’un commerce : ce qui lui manque, ses contacts, la note expliquée, le mail, que tu corriges, valides ou refuses.
• Envoyer un lecteur voir n’importe quel commerce de la carte, en un clic.
• Revoir une mission, sans relancer l’équipe ni consommer ton abonnement.
• La version cinéma, pour filmer ton écran : titres, chapitres, ralentis sur les clients potentiels, compteurs.

Quelles règles respecter avant d’écrire à des commerces ?

Le QG ne t’envoie aucun mail tout seul : c’est voulu. L’envoi, c’est toi qui le fais, depuis ta boîte, un mail à la fois. Garde ces réflexes. Ce n’est pas un conseil juridique.

• Écris à l’adresse professionnelle que le commerce affiche lui-même, pour un sujet qui concerne son activité.
• Dis qui tu es, dès les premières lignes.
• Laisse un moyen simple de dire non, et respecte-le. Chaque mail préparé se termine par une ligne pour ça.
• Ne promets aucun résultat. Tu décris ce que tu proposes, pas ce que ça rapportera.
• Vérifie les règles en vigueur dans ton pays. En France, sur le site de la CNIL.

Les agents préparent le travail. Toi, tu gardes la décision.

Combien ça coûte ?

Le QG est gratuit. Ce qui compte, c’est ton abonnement Claude : chaque mail écrit est un appel à Claude Code.

Questions fréquentes

Faut-il savoir coder pour installer le QG des agents ?

Non. Tu colles une phrase dans Claude Code, avec le lien du projet sur GitHub, et Claude Code l’installe, te dit s’il manque quelque chose et le lance dans ton navigateur.

Les mails partent-ils tout seuls ?

Non, jamais. Le QG n’a aucun code d’envoi. Les mails préparés attendent dans « En attente de ta validation » : tu les relis, tu les corriges, tu valides ou tu refuses. L’envoi, c’est toi qui le fais, depuis ta boîte.

Faut-il une clé API ?

Non. Les commerces viennent d’OpenStreetMap, gratuitement, et les mails sont écrits par Claude Code avec ton abonnement. Une clé Google Maps est facultative : elle relie chaque commerce à sa fiche Google. Claude Code te guide pour la créer avec ton propre compte, et elle reste sur ton ordinateur.

Ça marche dans quelles villes ?

Partout en France, en Belgique et en Suisse : la carte montre chaque ville et chaque village. S’il n’y a pas assez de commerces dans la zone choisie, l’éclaireur l’élargit et te dit combien il en a trouvé.

Pour quels métiers ?

Salles de sport, restaurants, cafés, coiffeurs, garages, dentistes, agences immobilières… et n’importe quel autre métier que tu tapes. Les règles de la note se changent en une phrase dans Claude Code, pour coller à ton offre.

Est-ce que j’ai le droit d’écrire à ces commerces ?

Écris à l’adresse professionnelle que le commerce affiche lui-même, pour un sujet qui concerne son activité, dis qui tu es et laisse un moyen simple de dire non. Les règles dépendent de ton pays : en France, vérifie-les sur le site de la CNIL. Ce n’est pas un conseil juridique.