MerchantryTidbits

scraping / cli

Google Maps Scraper

Capability: Google Maps Scraper

Use it when

  • You need an authorized CSV or JSON inventory of publicly listed businesses in a region for local-market, directory-quality, or coverage research
  • You need to compare public categories, ratings, review counts, websites, and coordinates across a set of Google Maps searches without copying listings by hand

What it solves

Not the fit when

  • Harvesting personal contact information or automating unsolicited outreach
  • Scraping where applicable law, authorization, or site terms do not permit it
  • Assuming the repository's benchmark throughput for different hardware, depth, concurrency, proxy, or blocking conditions
  • Runs where anonymous telemetry is prohibited unless `DISABLE_TELEMETRY=1` is set
  • Arbitrary non-Maps websites
  • general purpose website scraping
  • bypassing bot detection on arbitrary sites
  • crm deduplication and lead management
  • search engine results scraping beyond maps
  • email deliverability validation

Install

docker pull gosom/google-maps-scraper (recommended), or build from source with Go 1.26.5+: git clone, go mod download, go build. An agent skill is available via npx skills add gosom/google-maps-scraper

Invoke

Mount an authorized query file and output directory into the documented Docker image, then run it with `-input`, `-results`, `-depth`, and `-exit-on-inactivity`; use `-json` for JSON output or `-web` for the local UI/API. Start at low concurrency, disable anonymous telemetry with `DISABLE_TELEMETRY=1` when required, and comply with applicable law and site terms.

Alternatives

No reviewed alternatives recorded yet.