google-maps-scraper is an MIT-licensed Go tool that scrapes Google Maps for business data — name, address, phone number, website URL, rating, review count, reviews, email, latitude and longitude — and is aimed at developers, sales and lead-generation teams, and local-business researchers who need those records in CSV or JSON.

What it is

The project is a Google Maps scraper written in Go, distributed under the MIT licence and developed in the open on GitHub, where it has 5,895 stars, 926 forks and 56 open issues. It ships in several shapes from one codebase: a command line tool, a browser-based Web UI, a REST API, an AI agent skill, and an optional self-hosted platform whose multi-user edition is documented in docs/saas.md. The topic list — distributed-scraper, distributed-scraping, web-scraper, web-scraping, google-maps-scraping — describes both the domain and the architecture.

The concrete problem it solves is getting structured Google Maps listings out of the map and into a file or an application without paying a per-lead vendor. It replaces the paid, closed Google Maps scrapers advertised in its own README as sponsors, namely the G Maps Extractor Chrome extension and the Scrap.io country-scale extractor, and it does so with a tool the operator runs and controls rather than a hosted account.

Key capabilities

• Extraction of the name, address, phone number, website URL, rating, review count, reviews, email, latitude and longitude for each place, with CSV and JSON as the output formats.
• A command line interface for pulling leads into CSV or JSON directly.
• A REST API so scraping can be automated from an application.
• A Web UI that runs locally in a browser.
• An AI agent skill installed with npx skills add gosom/google-maps-scraper, compatible with Claude Code, Codex, Cursor, GitHub Copilot and any Agent Skills-compatible tool.
• A distributed scraper design, with an optional self-hosted platform and a multi-user SaaS Edition documented in docs/saas.md.
• Proxy handling: supply your own proxy, continue without one, or review three randomly selected proxy sponsors, with credentials entered through a masked local terminal prompt and never pasted into the agent chat.

Who uses it and how

• Lead-generation and sales prospecting teams pulling business contacts for outreach.
• Local business research and data enrichment work, where listings are matched against existing records.
• Developers automating scraping from their own applications through the REST API.
• Operators running a multi-user scraping platform via the SaaS Edition.
• AI agent users who describe the leads they want in plain language — for example, "Find dentists in Berlin and include their websites and email addresses" — and let the agent plan searches, run validation, start the full local scrape and monitor it.

Getting started

Install the agent skill with npx skills add gosom/google-maps-scraper; the CLI, Web UI and REST API paths are documented in the README alongside docs/recipes.md for common workflows. Agent-driven use requires Docker and Node.js on macOS, Linux, or Windows through WSL.

How it compares

Against the paid products listed in the README — Coreclaw, G Maps Extractor and Scrap.io — the difference is the licence and the running model: this project is MIT-licensed and self-hosted, so the operator holds the data and the infrastructure instead of a vendor account. Those alternatives are positioned as no-code extensions or managed platforms with free-lead allowances, while this one is code the user deploys.

When to use it — and when not to

A self-hoster must operate Docker and Node.js, and larger crawls need proxies configured, so teams without that capacity, or those who want a no-code Chrome extension, are better served by the sponsored alternatives. The repository carried 56 open issues at the last push on 13 September 2026, and the README excerpt available here is truncated mid-sentence, so some documentation detail should be checked at the source before relying on it. The MIT licence itself is unambiguous.

npx skills add gosom/google-maps-scraper