🗺️ Google Maps AI Agent

💥 Developed by xCodeWraith

A conversational AI agent that extracts, enriches, and organizes business leads from Google Maps using natural language.

Simply chat with the AI: "Find 100 dental clinics in Los Angeles" and watch it automatically scrape, enrich, and organize the data into Google Sheets.

• Overview
• Key Features
• How It Works
• Tech Stack
• Requirements
• Installation
• Configuration
• Usage Examples
• Data Fields
• Troubleshooting
• License

Google Maps AI Agent is an intelligent conversational system that transforms Google Maps into a powerful B2B lead generation tool. Instead of manually searching and copying business data, simply chat with an AI agent that understands your requirements and automates the entire process.

• 🤖 Natural Language Interface - Chat naturally as if speaking to a human assistant
• 🧠 AI-Powered Understanding - GPT-4o intelligently interprets your requests
• 🔄 Automatic Enrichment - Automatically finds emails and company backgrounds
• 📊 Smart Organization - Structures data perfectly in Google Sheets
• ⚡ Real-Time Processing - Watch leads populate as you chat

• Natural language input: "Find 50 restaurants in NYC"
• No complex forms or parameters
• AI understands context and intent
• Multi-turn conversations

• Search via Serper.dev Google Maps API
• Automatically handles pagination
• Extracts comprehensive business data
• Geo-targeting with coordinates

• Perplexity AI finds company emails
• Automatic web scraping from websites
• Background research for every business
• Real-time updates to Google Sheets

┌──────────────────────────────────────────────────────────┐
│                   STAGE 1: DATA COLLECTION               │
├──────────────────────────────────────────────────────────┤
│  Chat Trigger → AI Agent → Serper API → Sub-Workflow     │
│                                           ↓              │
│                                  Google Sheets Save      │
└──────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────┐
│                   STAGE 2: ENRICHMENT                    │
├──────────────────────────────────────────────────────────┤
│  Sheets Trigger → Perplexity AI → Email & Background     │
│                                           ↓              │
│                                  Sheets Update           │
└──────────────────────────────────────────────────────────┘

You: "Extract info for 100 dental clinics in Los Angeles"

AI Agent: "I'll search for dental clinics in Los Angeles. Starting now..."
[Google Maps search]
[Finds 100+ results across multiple pages]
[Automatically saves to Google Sheets]

AI Agent: "✅ Found and saved 97 dental clinics to your sheet!"

[Background process starts automatically]
[Enriches each lead with email and background]
[Updates the sheet with enriched data]

⚠️ IMPORTANT: This system consists of 2 separate workflows. Both must be imported separately and linked together!

🔴 ORDER MATTERS! The sub-workflow MUST be imported first!

1. Open n8n
2. Click "Workflows" → "Import from File"
3. Select Gooogle map lead ai agent.json
4. Click "Import"
5. ✅ Once imported, note down the workflow ID:
   • Visible in URL: https://your-n8n.com/workflow/WORKFLOW_ID

1. Click "Workflows" → "Import from File"
2. Select Google map ai agent.json
3. Click "Import"

🔗 The main workflow must be linked to call the sub-workflow!

1. Open the main workflow
2. Find the "Call n8n Workflow Tool" node
3. Click on the node
4. In the "Workflow" field:
   • Select "💥 xCodeWraith - Google Maps Lead Sub-Workflow" from the dropdown

1. Go to https://sheets.google.com/
2. Create a new spreadsheet named: "Leads Google map ai agent"
3. Create headers in row 1:

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

Update Google Sheets nodes in both workflows:

In Main Workflow:

• Google Sheets Trigger node → Select your Spreadsheet ID
• Google Sheets (update) node → Select your Spreadsheet ID

In Sub-Workflow:

• Append row in sheet node → Select your Spreadsheet ID

1. Open the Main workflow → Toggle "Active" (green)
2. The Sub-workflow can remain inactive (it is called automatically by the main one)
3. Click the "When chat message received" node in the Main workflow
4. Copy the "Production URL"
5. Open this URL in a browser to access the chat interface!

Node: "OpenAI Chat Model"

1. Get API key from https://platform.openai.com/api-keys
2. In n8n: Settings → Credentials
3. Add "OpenAi account" credential
4. Paste your API key

Node: "Map Search Tool"

1. Sign up at https://serper.dev/
2. Get API key from dashboard
3. Find the Headers section in the node
4. Update X-API-KEY value with your key

Node: "Message a model1"

1. Get API key from https://www.perplexity.ai/settings/api
2. In n8n: Settings → Credentials
3. Add "Perplexity account" credential

1. In n8n: Settings → Credentials
2. Add "Google Sheets OAuth2 API"
3. Follow the OAuth flow

You: "Find 50 coffee shops in Seattle"

AI: ✅ Found and saved 47 coffee shops!

You: "Extract info for 100 dental clinics in Los Angeles"

AI: Searching for dental clinics in Los Angeles...
100 results = 5 pages to scan
✅ 97 dental clinics saved!

This project is licensed under the MIT License.

✅ Commercial use allowed
✅ Modification allowed
✅ Distribution allowed
✅ Private use allowed
⚠️ No warranty or liability

💥 Made with ❤️ by xCodeWraith

⭐ Star this repo if it helps you generate leads!

Ready to generate thousands of leads? Start chatting with your AI agent now! 🗺️