MCP Server Scraper Google Maps

English | Portugues | Espanol

  ______    _                  _____         _                 _             _
 |  ____|  | |                |_   _|       | |               | |           (_)
 | |__ ___ | |___  ___ _ __     | | ___  ___| |__  _ __   ___ | | ___   __ _ _  ___  ___
 |  __/ _ \| / __|/ _ \ '_ \    | |/ _ \/ __| '_ \| '_ \ / _ \| |/ _ \ / _` | |/ _ \/ __|
 | | |  __/| \__ \  __/ | | |   | |  __/ (__| | | | | | | (_) | | (_) | (_| | |  __/\__ \
 |_|  \___||_|___/\___|_| |_|   \_/\___|\___|_| |_|_| |_|\___/|_|\___/ \__, |_|\___||___/
                                                                        __/ |
                                                                       |___/

Go MCP server for searching businesses on Google Maps and enriching results with contacts found on official websites.

Features

• MCP tool scrape_google_maps.
• MCP tool extract_contacts_from_html.
• Optional HTTP mode with POST /scrape, GET /health, and remote MCP endpoint POST /mcp.
• Google Maps search with headless Chrome.
• Place data extraction: name, address, phone, website, rating, number of reviews, category, image, and Maps URL.
• Optional review content extraction: author, rating, relative date, and text.
• Contact enrichment from websites: emails, phones, and social networks.
• Limited crawling of internal contact/about pages.
• Email and phone deduplication.

Contact

If you need consulting for deployment, customization, MCP integration, automations, or data collection, get in touch:

• Whatsapp: 55 11 99281-1461
• E-mail: lucas.rocha@felsen.enterprises / relationship@technologies.felsen.enterprises

License

This project uses the Apache-2.0 license.

Use, copying, modification, distribution, and commercial use are allowed as described in LICENSE.

This project also includes:

• NOTICE, with the attribution that must be preserved in redistributions.
• TRADEMARKS.md, with the rules for using the Felsen Technologies trademark.

How to run

go mod tidy
go test ./...
go run ./cmd/mcp-googlemaps

By default, the binary runs as an MCP server over stdio.

To use HTTP mode:

go run ./cmd/mcp-googlemaps --http :3000

If you are running locally without Chrome installed, install Chrome/Edge or provide the browser path:

CHROME_PATH=/usr/bin/chromium go run ./cmd/mcp-googlemaps --http :3000

On Windows PowerShell, for example:

$env:CHROME_PATH="C:\Program Files\Microsoft\Edge\Application\msedge.exe"
go run .\cmd\mcp-googlemaps --http :3000

Docker

Docker files are in the Docker/ folder.

Helper development scripts are in scripts_dev/:

chmod +x scripts_dev/linux.sh
./scripts_dev/linux.sh

On Windows PowerShell:

.\scripts_dev\windows.ps1

Copy the sample environment file before starting the stack:

cp .env.example .env

On Windows PowerShell:

Copy-Item .env.example .env

Edit .env and replace HTTP_BEARER_TOKEN with a strong token.

The Docker/Dockerfile installs Chromium inside the image and sets CHROME_PATH=/usr/bin/chromium.

docker build -f Docker/Dockerfile -t mcp-googlemaps .
docker run --rm -p 3000:3000 mcp-googlemaps

To start the stack with Docker Compose:

docker compose -f Docker/docker-compose.yaml up -d --build

Variables accepted by compose:

• HTTP_PORT: port published on the host. Default: 3000.
• HTTP_BEARER_TOKEN: global bearer token required by all HTTP routes.
• MCP_BEARER_TOKEN: fallback for HTTP_BEARER_TOKEN, kept for compatibility.
• MCP_ALLOWED_ORIGINS: origins allowed for browser calls.
• DATABASE_URL: optional PostgreSQL connection string for dataset persistence.
• TZ: container timezone. Default: America/Sao_Paulo.

Example with bearer token:

HTTP_BEARER_TOKEN=your-st

... [View full README on GitHub](https://github.com/felsentechnologies/felsen_mcp_server_scraper_googlemaps#readme)