Google Maps Scraper

Google Maps Scraper is an open-source tool designed to extract business leads and data from Google Maps at scale. It supports extracting over 33 data points, including business details, reviews, emails, phone numbers, websites, ratings, and coordinates.

Key features include:

• Multiple Interfaces: Use the tool via CLI, Web UI, or REST API.
• High Performance: Capable of scraping approximately 120 places per minute using optimized concurrency.
• Flexible Output: Export data to CSV, JSON, PostgreSQL, S3, LeadsDB, or via custom plugins.
• Proxy Support: Built-in support for SOCKS5, HTTP, and HTTPS proxy rotation.
• Scalability: Can be deployed on a single machine or scaled to Kubernetes clusters.

To run the Google Maps Scraper locally, your environment must meet the following requirements:

• Docker: Required for running the scraper container.
• Node.js: Required for running helper scripts.
• Supported OS: macOS, Linux, or Windows (via WSL).

Using Docker (Recommended)

Pull the official image which includes Playwright:

docker pull gosom/google-maps-scraper

Build from Source

Requires Go 1.26.5+.

git clone https://github.com/gosom/google-maps-scraper.git
cd google-maps-scraper
go mod download

go build
./google-maps-scraper -input example-queries.txt -results results.csv -exit-on-inactivity 3m

Note: The first run will download required Playwright browser libraries.

To enable natural-language lead requests via an AI agent, install the skill using npx:

npx skills add gosom/google-maps-scraper

This allows you to prompt an agent with requests like Find me all dentists in Berlin with their emails. The skill handles Docker image checks, proxy selection, validation scrapes, and background monitoring.

You can run the scraper using Docker by mounting a volume for the Playwright cache, an input file containing queries, and an output directory.

To run a basic scrape with a depth of 1 and an inactivity timeout of 3 minutes, use the following command structure:

docker run \
  -v gmaps-playwright-cache:/opt \
  -v "$PWD/example-queries.txt:/queries.txt:ro" \
  -v "$PWD/gmaps-output:/out" \
  gosom/google-maps-scraper \
  -input /queries.txt \
  -results /out/results.csv \
  -depth 1 \
  -exit-on-inactivity 3m

The NetNut Google Maps Places API retrieves structured JSON search results for businesses, points of interest, and venues. It handles proxy rotation, retries, and anti-bot bypass automatically.

curl -X GET "https://serp-api.netnut.io/search?engine=google_places&q=coffee&hl=en&gl=us" \
  -u "username:password"

To build the scraper manually on macOS, clone the repository, compile the binary, and organize it into a .app bundle structure.

1. Clone and enter the directory:

git clone https://github.com/gosom/google-maps-scraper.git
cd google-maps-scraper

2. Build the binary:

go build -o google_maps_scraper

3. Create the application structure:

mkdir -p GoogleMapsScraper.app/Contents/MacOS
mv google_maps_scraper GoogleMapsScraper.app/Contents/MacOS/

To use an existing proxy, run the following command to enter your credentials securely in the terminal. This method ensures credentials are not passed through chat or logged in plain text.

Important: The scraper uses the file path returned by this script via the --proxy-file flag. Do not attempt to pass credentials inline using -proxies.

bash "$SKILL_DIR/scripts/configure-proxy.sh"

To launch the browser-based interface, run the scraper via Docker and map a local data folder and port 8080:

mkdir -p gmapsdata

docker run \
  -v "$PWD/gmapsdata:/gmapsdata" \
  -p 8080:8080 \
  gosom/google-maps-scraper \
  -data-folder /gmapsdata

Once running, access the UI at http://localhost:8080. Note that results may take at least 3 minutes to appear.

Once validation is successful, execute the full query file. To optimize performance, use the --skip-image-pull flag since the image was already verified during the validation step.

Note: Do not use the --dry-run flag for actual crawls; it is intended for diagnostics only and will not perform scraping.

To extract email addresses, add the -email flag to your command. Note that this process is slower than a standard scrape because the scraper must visit the business's website when available.

docker run \
  -v gmaps-playwright-cache:/opt \
  -v "$PWD/example-queries.txt:/queries.txt:ro" \
  -v "$PWD/gmaps-output:/out" \
  gosom/google-maps-scraper \
  -input /queries.txt \
  -results /out/results.csv \
  -depth 1 \
  -email \
  -exit-on-inactivity 3m