What problem it solves

Extracting business information from Google Maps requires collecting details such as contact information, websites, reviews, ratings, and coordinates for each place. The project addresses this workflow by providing command-line, browser, API, and self-hosted interfaces for collecting and exporting those records.

Key features

• Multiple interfaces — Choose a command-line workflow, a local browser interface, a REST API, or an optional self-hosted platform according to the task.

  Source: README

• Business and review data extraction — Collect business contact details, location data, ratings, coordinates, customer reviews, and optional email addresses from business websites.

  Source: README

• Flexible output destinations — Save results as CSV or JSON, or send them to PostgreSQL, S3, LeadsDB, or a custom writer plugin.

  Source: README, examples

• Agent-guided scraping — An optional AI Agent Skill turns a natural-language lead request into a guided local workflow, including validation, monitoring, and result handling.

  Source: README, skills/google-maps-scraper/SKILL.md

• Deployment and proxy options — Run the scraper from Docker or source, use proxy rotation for larger collections, and deploy on a single machine or within a Kubernetes environment.

  Source: README

Quick start

Copied verbatim from the project's README.

docker pull gosom/google-maps-scraper

mkdir -p gmaps-output

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

Who it may suit

This may suit developers, sales teams, and local-business researchers who need structured Google Maps place data through command-line tools, browser workflows, or application integrations.

Topics to discuss

• Which data fields should be included in a standard lead export?

• How should proxy selection and disclosure work in larger scraping workflows?

• Which deployment pattern best fits a self-hosted multi-user setup?

Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/gosom/google-maps-scraper#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.