Skip to content

kronosun/GoogleMapAIagent

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

🗺️ Agent IA Google Maps

Licence : MIT n8n OpenAI IA Assistée

💥 Développé par xCodeWraith
Agent IA conversationnel capable d'extraire et d'enrichir des prospects d’entreprises depuis Google Maps via un dialogue en langage naturel.

Discutez simplement : « Trouve-moi 100 cabinets dentaires à Los Angeles »
L'IA collecte automatiquement les données, les enrichit et les organise dans Google Sheets.


📋 Sommaire

  • Aperçu général
  • Fonctionnalités principales
  • Comment ça fonctionne
  • Stack technologique
  • Prérequis
  • Installation
  • Configuration
  • Exemples d’utilisation
  • Champs de données
  • Dépannage
  • Licence

🎯 Aperçu général

L’Agent IA Google Maps transforme Google Maps en un outil puissant de génération de prospects B2B.
Vous discutez avec un agent IA qui comprend vos besoins et automatise la recherche et la collecte.

Ce qui le rend unique

  • 🤖 Interface en langue naturelle
  • 🧠 Interprétation intelligente grâce à GPT-4o
  • 🔄 Enrichissement automatique (emails, infos entreprise)
  • 📊 Organisation parfaite dans Sheets
  • ⚡ Traitement en temps réel

Pour qui ?

Public Usage
💼 Équipes commerciales Listes ciblées
📞 Téléprospecteurs Numéros et infos instantanés
📧 Email marketeurs Contacts enrichis
🏢 Agences B2B Recherche locale pour clients
🚀 Entrepreneurs Partenaires & prospects

✨ Fonctionnalités principales

🗣️ Interface conversationnelle

  • « Trouve 50 cafés à Seattle »
  • Compréhension du contexte
  • Conversation multi-tours

🔍 Extraction Google Maps

  • Recherche via Serper.dev
  • Pagination automatique
  • Extraction complète des données

📧 Enrichissement automatique

  • Emails trouvés via Perplexity AI
  • Analyse du site web
  • Recherche d'informations additionnelles

🔄 Workflow en 2 phases

Phase 1 : Collecte → Enregistrement dans Sheets
Phase 2 : Enrichissement → Mise à jour Sheets


🔄 Comment ça fonctionne

Vous : « Extrait 100 cabinets dentaires à Los Angeles » IA : Recherche en cours... Résultats trouvés → Sheets mis à jour IA : « ✅ 97 cabinets dentaires enregistrés ! »

(En arrière-plan) → Recherche d’emails → Recherche d'informations → Mise à jour automatique


🛠️ Stack technologique

Catégorie Technologie Rôle
Automatisation n8n Orchestration
Agent IA OpenAI GPT-4o Compréhension & actions
Mémoire Buffer Window Contexte
Recherche Serper.dev API Google Maps
Enrichissement Perplexity AI Emails + infos
Stockage Google Sheets Base prospects

📦 Prérequis

Service Obligatoire ? Usage Coût
n8n Oui Workflows Gratuit ou 20$/mois
OpenAI Oui GPT-4o ~0,01–0,03$/requête
Serper.dev Oui Recherche Maps 50$/mois
Perplexity Oui Enrichissement 20$/mois
Google Oui Sheets Gratuit

🚀 Installation

⚠️ Le système comporte 2 workflows, à importer séparément et dans le bon ordre.

Fichiers

  • Google map ai agent.json → workflow principal
  • Gooogle map lead ai agent.json → sous-workflow

Étape 1 — Importer d’abord le sous-workflow

  1. n8n → Workflows → Import
  2. Choisir Gooogle map lead ai agent.json
  3. Importer
  4. Noter l’ID du workflow

Étape 2 — Importer le workflow principal

  1. Importer Google map ai agent.json

Étape 3 — Lier les workflows

  1. Ouvrir le workflow principal
  2. Trouver le node Call n8n Workflow Tool
  3. Sélectionner le sous-workflow importé

Étape 4 — Créer la Google Sheet

Créer « Leads Google map ai agent » avec les colonnes :

UUID | Name | Address | Number | Website | Rating | Opening Hours | Email | Background

Étape 5 — Mettre à jour les nodes Google Sheets

Configurer votre Spreadsheet ID dans :

  • Trigger Sheets
  • Update Sheets
  • Append row (sous-workflow)

Étape 6 — Activer

  1. Activer le workflow principal
  2. Copier l’URL Production → ouvre le chat

⚙️ Configuration

1. OpenAI API

  • Ajouter credentials OpenAI dans n8n

2. Serper.dev

  • Renseigner X-API-KEY dans le node Maps

3. Perplexity API

  • Ajouter credentials Perplexity

4. Google Sheets OAuth

  • Ajouter OAuth2 Google dans n8n

📖 Exemples

Vous : « Trouve 50 cafés à Seattle » IA : « ✅ 47 cafés trouvés et enregistrés ! »

Vous : « Extrait 100 dentistes à Los Angeles » IA : « 97 dentistes enregistrés ! »


📊 Champs de données

Champ Description Source
UUID Identifiant unique Automatique
Name Nom Google Maps
Address Adresse Google Maps
Number Téléphone Google Maps
Website Site web Google Maps
Rating Note Google Google Maps
Opening Hours Horaires Google Maps
Email Contact Perplexity
Background Description entreprise Perplexity

🐛 Dépannage

Problème Solution
Chat ne charge pas Activer workflow principal
Pas de résultats Vérifier clé Serper.dev
Sheets non mises à jour Vérifier credentials
Sous-workflow non appelé Vérifier le lien

📈 Performances

Métrique Valeur
Recherche 20 résultats / 2 s
Scraping 100 prospects / min
Enrichissement 60 prospects / 5–10 min
Précision 90 %
Capacité 5 000–10 000 prospects / jour

📄 Licence MIT

✔️ Usage commercial
✔️ Modifications
✔️ Distribution
✔️ Usage privé
⚠️ Pas de garantie


Créé avec ❤️ par xCodeWraith
⭐ Si ce projet vous aide, pensez à laisser une étoile !

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors