🗺️ n8n MCP Google Maps Scraper

Transform AI assistants into powerful Google Maps research tools with natural language queries! 🚀

This Actor creates a Model Context Protocol (MCP) server using n8n workflows that enables AI assistants like Claude to scrape Google Maps data through conversational commands. Simply ask "Find Italian restaurants in Rome" and get comprehensive business information instantly.

🌟 Key Features

• 🤖 AI-Powered Interface: Natural language queries via MCP protocol
• 🔍 Comprehensive Scraping: Business names, ratings, addresses, contact info, hours
• ⚡ Real-time Data: Fresh information directly from Google Maps
• 🎯 Smart Filtering: Location-based searches with automatic geo-targeting
• 📊 Structured Output: Clean, formatted data ready for analysis
• 🔄 Workflow Automation: n8n-powered backend for reliability and scalability

🛠️ How It Works

graph LR
    A[🤖 AI Assistant] --> B[📡 MCP Client]
    B --> C[⚙️ n8n MCP Server]
    C --> D[🎯 AI Agent]
    D --> E[🕷️ Apify Scrapers]
    E --> F[🗺️ Google Maps]
    F --> E
    E --> D
    D --> C
    C --> B
    B --> A

🚀 Quick Start

1. Prerequisites

• 🏗️ n8n instance (cloud or self-hosted)
• 🔑 Anthropic API key
• 🕷️ Apify account with API access
• 🤖 MCP-compatible AI assistant (Claude Desktop, etc.)

2. Installation

1. Import Workflows 📥

   # Download the workflow files
   wget https://github.com/your-repo/n8n-mcp-google-maps/archive/main.zip
   

2. Configure n8n ⚙️

   • Import MCP-Server.json
   • Import Apify-Google-Maps-Scraper.json
   • Set up credentials for Anthropic and Apify

3. Set Up MCP Client 🔗

   • Configure your AI assistant to connect to the n8n MCP endpoint
   • Use the provided Bearer token for authentication

💻 Usage Examples

Basic Search

"Find sushi restaurants in Tokyo"

Advanced Queries

"Search for 4+ star coffee shops in downtown San Francisco"
"Find auto repair shops near Central Park, New York"
"Get Italian restaurants in Rome with phone numbers"

Response Format

{
  "name": "Trattoria da Enzo",
  "rating": 4.8,
  "reviews": 2547,
  "address": "Via dei Vascellari, 29, Rome, Italy",
  "phone": "+39 06 581 2260",
  "website": "https://trattoriadaenzo.com",
  "hours": "Mon-Sat: 12:30-15:00, 19:30-24:00"
}

⚙️ Configuration

MCP Server Settings

Parameter	Description	Default
endpoint	MCP server URL	Auto-generated
auth_token	Bearer authentication	Required
max_results	Maximum locations returned	20

Apify Integration

Setting	Description	Required
apify_token	Apify API key	✅
scraper_actors	Enabled Google Maps scrapers	✅
timeout	Request timeout (seconds)	60

🔧 Technical Details

Architecture Components

• 🎭 MCP Server Trigger: Exposes n8n workflow as MCP tool
• 🤖 AI Agent Node: Claude-powered query processing
• 🕷️ Apify MCP Client: Connects to Google Maps scrapers
• ⚙️ Workflow Orchestrator: Manages data flow and error handling

Supported Scrapers

• 🗺️ compass/google-maps-extractor
• 📍 compass/crawler-google-places
• ⭐ compass/google-maps-reviews-scraper

Data Fields Extracted

• 🏢 Business name and category
• ⭐ Rating and review count
• 📍 Full address and coordinates
• 📞 Phone number and website
• 🕐 Opening hours and popular times
• 📸 Photos and additional details

🔒 Authentication & Security

Bearer Token Authentication

// MCP Client Configuration
{
  "mcpServers": {
    "n8n-google-maps": {
      "command": "node",
      "args": ["mcp-client.js"],
      "env": {
        "MCP_SERVER_URL": "https://your-n8n.com/webhook/mcp-server",
        "BEARER_TOKEN": "your_secure_token_here"
      }
    }
  }
}

📊 Output Examples

Restaurant Search Results

# Restaurants in Prague 🍽️

## Top-Rated Restaurants

### **Aahar Restaurant** ⭐ 5.0 (151 reviews)
- **Cuisine:** Vegetarian restaurant
- **Address:** Zenklova 232, Prague 8-Kobylisy
- **Phone:** +420 732 776 622
- **Website:** [aaharrestaurant.cz](https://www.aaharrestaurant.cz/)

### **Dookan Dosa Bistro** ⭐ 4.9 (586 reviews)
- **Cuisine:** Indian restaurant
- **Address:** Podvinný mlýn 1418/2, Prague 9-Libeň
- **Phone:** +420 773 848 655

🚨 Error Handling

Common Issues & Solutions

Error	Cause	Solution
Connection closed	Apify API timeout	Increase timeout settings
Schema mismatch	Parameter configuration	Check workflow input mapping
No results found	Invalid location query	Verify location spelling

🔄 Workflow Updates

Version History

• v1.0.0: Initial MCP server implementation
• v1.1.0: Added multi-scraper support
• v1.2.0: Enhanced error handling and retry logic

Upgrade Instructions

1. 📥 Download latest workflow files
2. 🔄 Import updated workflows to n8n
3. ⚙️ Update configuration parameters
4. 🔄 Restart MCP server connections

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for details.

Development Setup

git clone https://github.com/your-repo/n8n-mcp-google-maps
cd n8n-mcp-google-maps
npm install
npm run dev

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• 📚 Documentation
• 💬 Discord Community
• 📧 Support Email
• 🐛 Issue Tracker

🏷️ Tags

google-maps mcp n8n ai-assistant claude web-scraping business-data automation workflow

---

Ready to supercharge your AI assistant with Google Maps data? Deploy this Actor now! 🚀