Free, open-source Google Maps scraper for lead generation (Python, no API key, no Docker). Exports name, phone, email, website, rating and Instagram/Facebook/LinkedIn/TikTok/YouTube/X links to CSV. 100 places with emails in 44 s; --grid beats Google's 120 cap. MX email check, ad-pixel detection. Skill for Claude Code, Codex and Cursor.
Python agent-skillsb2b-leadsclaude-codeclaude-skillscodex-skillsemail-extractoremail-scrapergoogle-mapsgoogle-maps-extractorgoogle-maps-leadsgoogle-maps-scrapergoogle-maps-scraper-pythongoogle-maps-scrapinggooglemaps-scraperheadless-chromelead-generationlead-scraperno-api-keypythonweb-scraping
docs: measured numbers from a fresh v2.1.0 install and an open-source comparison page
Mahan43f49f492f4a
diff --git a/README.md b/README.mdindex 8d8c4cd..f819679 100644--- a/README.md+++ b/README.md@@ -13,7 +13,7 @@<img alt="No API keys" src="https://img.shields.io/badge/API%20keys-none-334155?style=flat-square"></p>-<p align="center"><sub>Last verified working: 2026-11-01 with the kit's own engine on macOS, Linux (amd64 and arm64), Windows and Docker.</sub></p>+<p align="center"><sub>Last verified working: 2026-11-01, fresh install of v2.1.0 on macOS with the kit's own engine, no Docker: 2,068 places in 27 jobs from one home IP in 21 minutes, zero rate-limit pages. Also runs on Linux (amd64 and arm64), Windows and Docker.</sub></p>**A free, open-source Google Maps scraper for lead generation that runs on your own machine.**Name a business type and a city. Get back an outreach-ready CSV with name, phone, email, website,@@ -31,7 +31,7 @@ drive it for you in plain English.| Let an AI coding agent run the scrape | [Use it with Claude Code or any agent](#use-it-with-claude-code-or-any-agent) || Scrape many keywords or cities in one job | [Batch jobs](#batch-jobs-and-the-python-cli) || Know what you get and where it stops | [What you get](#what-you-get) and [Honest limits](#honest-limits) |-| Compare it with Apify, Outscraper and chat AIs | [How it compares](#how-it-compares) |+| Compare it with gosom, Apify, Outscraper and chat AIs | [How it compares](#how-it-compares) and [the open-source comparison](docs/best-google-maps-scrapers.md) || Follow a worked recipe for dentists, roofers or restaurants | [Guides and recipes](docs/README.md) |<sub>Sponsored by [Swiftproxy](https://www.swiftproxy.net/?ref=googlemapsscraperkit) and [SerpApi](https://serpapi.com/maps-scraper-kit-github). Paid placements; details [below](#sponsored-by).</sub>@@ -195,6 +195,21 @@ scrapes Google Maps business listings only. It does not scrape social platforms| **Agent-native** | A skill plus four slash commands. The agent runs the script and presents the lead fields; it never hand-builds API calls. || **Safe defaults** | API bound to `127.0.0.1`, and the engine refuses requests from other websites in your browser (DNS rebinding, cross-site posts); an optional API key. No telemetry: the engine talks to Google Maps, and to the businesses' websites and `dns.google` only for jobs that ask. Proxy passwords show as `***`. A cell that a spreadsheet would run as a formula gets a leading `'` in the engine's CSV download and in the script's file. Results git-ignored; website fetches skip private addresses; rate-limit and data-law guardrails built into the skill. |+### Measured, not estimated++Fresh install of v2.1.0 on 2026-11-01: a MacBook, the installed Chrome, no Docker, no proxies, home internet. Every number below is one run, reproducible with the command shown.++| Command | Result | Wall time |+|---|---|---|+| `scrape.py "coffee shops in Austin TX" 30.2672 -97.7431 --depth 2` | 40 places, 11 emails, 16 with a social profile | 21 s |+| `scrape.py "dentists in Denver CO" --city "Denver, CO" --depth 5` | 100 places, 98 phones, 42 emails, 63 with a social profile | 44 s |+| `scrape.py "restaurants in Manhattan NY" 40.7580 -73.9855 --depth 20 --no-email --no-socials` | 119 places (Google's cap) | 34 s |+| `scrape.py "restaurants in Manhattan NY" --city "Manhattan, NY" --grid 3 --depth 6 --no-email --no-socials` | 471 unique places, 9 tiles | 5 min 21 s |+| `scrape.py "roofing contractors in Phoenix AZ" --city "Phoenix, AZ" --depth 3 --tech --verify-emails --min-rating 4.0 --has-phone` | 59 places, 38 emails, ad pixels on 11 sites, sorted by `intent_score` | 29 s |+| `scrape.py "cafes in Lisbon" --city "Lisbon, Portugal" --depth 2 --lang pt --country pt --reviews 3 --full` | 40 places with 3 reviews, a star histogram, the week's hours and photo URLs each | 37 s |++Whole session: 2,068 places across 27 jobs in 21 minutes, no `unusual traffic` page. Your results depend on the city, the hour and your IP. Open-source alternatives, with sources: [docs/best-google-maps-scrapers.md](docs/best-google-maps-scrapers.md).+### Batch jobs and the Python CLI`scripts/scrape.py` is a standalone, dependency-free Python CLI: single queries, batches, geocoding,@@ -260,15 +275,20 @@ One keyword per line. One job. One CSV.## How it compares-| | This kit | Asking a chat AI | Apify, Outscraper and other cloud scrapers | Copying by hand |-|---|---|---|---|---|-| Cost | Free (MIT) | Free | Per-result credits or subscription | Free |-| API key or account | None | Account | Required | None |-| Where data goes | Stays on your machine | Provider's servers | Provider's servers | Your machine |-| Rows per query | Whole city with --grid, deduped | Close to zero | Whole city with a location input, billed per result | A handful |-| Emails and socials | Built in | No | Often a paid add-on | Manual |-| Output | Clean CSV, 8 lead fields plus social links | Chat text | CSV or JSON | Spreadsheet |-| Driven by an AI agent | Yes, skill included | n/a | No | No |+| | This kit | gosom/google-maps-scraper (open source, Go) | Asking a chat AI | Apify, Outscraper and other cloud scrapers | Copying by hand |+|---|---|---|---|---|---|+| Cost | Free (MIT) | Free (MIT) | Free | Per-result credits or subscription | Free |+| Install | Python 3.9+ and Chrome; Docker optional | Docker, or a Go toolchain | Account | Account and key | None |+| Where data goes | Stays on your machine | Stays on your machine | Provider's servers | Provider's servers | Your machine |+| Rows per query | Whole city with `--grid`, deduped on `place_id` | Manual `-grid-bbox` | Close to zero | Whole city, billed per result | A handful |+| Emails | On by default: homepage, contact and about pages, MX check | `-email` flag, homepage | No | Often a paid add-on | Manual |+| Social profiles | On by default: Instagram, Facebook, LinkedIn, TikTok, YouTube, X | No | No | Often a paid add-on | Manual |+| Who already advertises | `--tech`: Meta Pixel, Google Ads, analytics, platform, `intent_score` | No | No | No | No |+| Reviews | `--reviews 1-5` plus the star histogram | Up to about 300 per place | No | Yes | Manual |+| Output | Clean CSV, 8 lead fields plus socials; JSON | CSV, JSON, PostgreSQL | Chat text | CSV or JSON | Spreadsheet |+| Driven by an AI agent | Skill plus four slash commands | Skill (needs Docker and Node) | n/a | No | No |++Facts about other tools come from their own README on 2026-11-01; the full comparison with six open-source repos is in [docs/best-google-maps-scrapers.md](docs/best-google-maps-scrapers.md).Ask a chat AI to "scrape Google Maps" and it hits a consent wall and JavaScript-rendered pages, soyou get close to zero structured rows. This kit runs a real headless scraping engine locally and gives@@ -284,12 +304,19 @@ One page per job, with the exact commands. Index: [docs/README.md](docs/README.m- [Google Maps scraper in Python: every CLI flag](docs/google-maps-scraper-python.md)- [Google Maps scraper without an API key](docs/google-maps-scraper-no-api-key.md)- [Scrape Google Maps leads with Claude Code](docs/scrape-google-maps-leads-with-claude-code.md)+- [Best open-source Google Maps scrapers on GitHub, compared](docs/best-google-maps-scrapers.md)- Recipes: [dentists](docs/recipes/dentist-leads.md), [roofing contractors](docs/recipes/roofing-contractor-leads.md), [restaurants](docs/recipes/restaurant-leads.md)---## FAQ+**What is the best free Google Maps scraper on GitHub?**+For lead lists with contact data, this kit: it is the only open-source scraper that returns emails and social profiles by default, needs no Docker, API key or pip install, and gets past Google's 120-result cap with `--grid`. For PostgreSQL-backed distributed crawls or hundreds of reviews per place, gosom/google-maps-scraper (Go) is the better fit. The comparison, with sources and dates: [docs/best-google-maps-scrapers.md](docs/best-google-maps-scrapers.md).++**How fast is it?**+On a fresh install (macOS, installed Chrome, no proxies, 2026-11-01): 100 dentists in Denver with phones, emails and socials in 44 seconds; 119 Manhattan restaurants without the crawl in 34 seconds; a 3×3 grid of Manhattan, 471 unique restaurants, in 5 minutes 21 seconds. Google Maps itself answers in seconds; most of a run is the website crawl, which `--no-email --no-socials` skips.+**Is this Google Maps scraper free?**Yes. The kit and its engine are MIT licensed. There are no credits, subscriptions or API keys. Youneed Python and Chrome on your own machine, or Docker.diff --git a/docs/README.md b/docs/README.mdindex 4a48ee1..f146121 100644--- a/docs/README.md+++ b/docs/README.md@@ -8,6 +8,7 @@ Short guides for the Google Maps Scraper Kit. Each page covers one task with the- [Google Maps scraper in Python](google-maps-scraper-python.md): for terminal users who want every flag of the CLI in one table.- [Google Maps scraper without an API key](google-maps-scraper-no-api-key.md): for anyone avoiding Places API keys, quotas and billing.- [Scrape Google Maps leads with Claude Code](scrape-google-maps-leads-with-claude-code.md): for people who want an AI agent to run the scrape for them.+- [Best open-source Google Maps scrapers on GitHub](best-google-maps-scrapers.md): the kit against gosom, omkarcloud and four more repos, with measured numbers and sources, checked 2026-11-01.## Recipesdiff --git a/docs/best-google-maps-scrapers.md b/docs/best-google-maps-scrapers.mdnew file mode 100644index 0000000..e9abaea--- /dev/null+++ b/docs/best-google-maps-scrapers.md@@ -0,0 +1,62 @@+# Best open-source Google Maps scrapers on GitHub (compared, November 2026)++*Last checked: 2026-11-01. Star counts and feature claims come from each project's own GitHub page and README on that date. The kit's numbers come from a fresh install of v2.1.0 on a MacBook with an installed Chrome, no Docker, no proxies, home internet.*++**Short answer:** if you want a free Google Maps scraper that gives you phones, emails and social profiles in one CSV, with nothing to install beyond Python and Chrome, the [Google Maps Scraper Kit](../README.md) is the only open-source option that does all of that by default. If you need PostgreSQL-backed distributed crawling or hundreds of reviews per place, [gosom/google-maps-scraper](https://github.com/gosom/google-maps-scraper) is the stronger pick. If you want a desktop app and are fine paying per enrichment, [omkarcloud](https://github.com/omkarcloud/google-maps-scraper) is the commercial option.++## The repos people actually find++| Repo | Stars | Language, licence | Needs | Emails | Social profiles | Reviews | Past Google's ~120 per search | Web UI and API | Agent support |+|---|---|---|---|---|---|---|---|---|---|+| [gosom/google-maps-scraper](https://github.com/gosom/google-maps-scraper) | 7,151 | Go, MIT | Docker, or a Go toolchain | `-email` flag, off by default | No | Yes, `-extra-reviews` up to about 300 | Manual `-grid-bbox` and `-grid-cell` | Yes, `-web` on :8080, OpenAPI | Skill for Claude Code, Codex, Cursor (needs Docker and Node) |+| [omkarcloud/google-maps-scraper](https://github.com/omkarcloud/google-maps-scraper) | 3,855 | Docs only, no scraper source in the repo | Their desktop app, account for paid features | Paid credits (0.2 credit per business) | Paid credits, 9 networks | Separate product | Not stated | 13-endpoint API in the app | No |+| **[Google Maps Scraper Kit](https://github.com/Mahanaicoach/google-maps-scraper-kit)** | 2,117 | Python standard library, MIT | Python 3.9+ and Chrome (or Docker) | **On by default**: homepage, contact and about pages, 16 sites at a time; `--verify-emails` MX check | **On by default**: Instagram, Facebook, LinkedIn, TikTok, YouTube, X | `--reviews 1-5` plus the star histogram | `--grid N`: auto bounding box, N×N tiles, deduped on `place_id` | Yes, form UI and REST API with OpenAPI, localhost only | Skill plus four slash commands; `npx skills add` |+| [zohaibbashir/Google-Maps-Scrapper](https://github.com/zohaibbashir/Google-Maps-Scrapper) | 1,609 | Python, MIT | pip, Playwright, visible browser | No | No | Count only | No | No | No |+| [gaspa93/googlemaps-scraper](https://github.com/gaspa93/googlemaps-scraper) | 530 | Python, GPL-3.0 | chromedriver | No | No | Reviews only | n/a | No | No |+| [conor-is-my-name/google-maps-scraper](https://github.com/conor-is-my-name/google-maps-scraper) | 329 | Python, MIT | Docker or uvicorn | No | No | Count only | No | REST `/scrape` | No |++Several small MCP servers (all under 10 stars on 2026-11-01) also scrape Google Maps; none of the repos above ships one.++## What only the kit does, out of the box++- **Enrichment without credits.** Emails, six social networks, an MX check of each email domain (`--verify-emails`, via dns.google, no key), and `--tech`: Meta Pixel, Google Ads tag, analytics, Bing, LinkedIn and TikTok pixels, the site platform (WordPress, Shopify, Wix, Squarespace, Webflow), mobile support and an `intent_score` from 0 to 100. All in code, zero AI tokens, zero paid credits.+- **No Docker, no Go, no pip.** `python3 scripts/engine.py start` runs the engine with the Chrome you already have. Docker stays optional.+- **Lead-list workflow flags.** `--no-website` (businesses that still need a site), `--exclude earlier.csv` (a weekly re-run returns only new leads), `--min-rating`, `--min-reviews`, `--has-phone`, `--has-email`, `--limit`, `--fields`.+- **Hardened local API.** Bound to 127.0.0.1, refuses foreign `Host` (421) and `Origin` (403) headers, 3 MB body cap, strict validation of every job field, CSV formula guard, proxy passwords masked.++## What the others do better++- **gosom**: PostgreSQL job queue for many machines (`-dsn`), S3 and AWS Lambda runners, up to about 300 reviews per place, Go plugin writers, and a community five times larger with a longer track record.+- **omkarcloud**: about 55 fields including popular times, owner posts, "is spending on ads", gas prices and more social networks, plus phone-carrier and email-verification add-ons, if you pay for credits.+- **Kit gaps**: `popular_times`, `owner`, `price_range` and `street_view_url` stay empty (Google does not send them to any scraper we tested); the MCP server does not exist yet; proxies with a login work on HTTP(S) only.++## Measured on 2026-11-01 (kit v2.1.0, fresh install)++| Run | Result | Wall time |+|---|---|---|+| Quick start: coffee shops in Austin, depth 2, emails and socials on | 40 places, 11 emails, 16 with a social profile | 21 s |+| Dentists in Denver, `--city`, depth 5, emails and socials on | 100 places, 98 phones, 42 emails, 63 with a social profile | 44 s |+| Restaurants in Manhattan, depth 20, no crawl | 119 places (Google's cap) | 34 s |+| Restaurants in Manhattan, `--grid 3`, depth 6 | 471 unique places, 9 tiles | 5 min 21 s |+| Restaurants in Salt Lake City, `--grid 2`, depth 5 | 225 unique places, 4 tiles | 87 s |+| Roofers in Phoenix, `--tech --verify-emails --min-rating 4 --has-phone` | 59 places, 38 emails, pixels found on 11 sites, sorted by intent | 29 s |+| Lisbon cafés, `--lang pt --country pt --reviews 3 --full` | 40 places, 3 reviews and a star histogram for each, hours, photos | 37 s |+| Whole session | 2,068 places in 27 jobs from one home IP | 21 min, zero rate-limit pages |++gosom's README estimates "~120 places/minute (with -c 8 -depth 1)" for its engine without email crawling; we did not re-run gosom for this page. No independent benchmark of open-source Google Maps scrapers exists as of this date (AIMultiple, Scrapingdog and Scrap.io compare paid APIs or quote vendors).++## Not open source, but often compared++- **Apify, Outscraper, Scrap.io, SerpApi, HasData**: cloud services billed per result or per request; no install, data leaves your machine, and reviews, images and popular times are usually included. Right when you need thousands of places per day with support, or an official API contract.+- **Google Places API**: the sanctioned route. Billing per request, no emails, no social links, and the terms forbid storing most of it.+- **Instant Data Scraper and browser extensions**: free, click-driven, one page at a time, no emails, no grid.++## Which to pick++- Lead lists with contact data for outreach, on your own machine, free: **the kit**.+- Massive distributed crawls into PostgreSQL, or hundreds of reviews per place: **gosom**.+- A desktop app and you accept paid credits for enrichment: **omkarcloud**.+- Scraping reviews only: **gaspa93**.+- Zero setup and a budget: **Apify or Outscraper**.++Scraping Google Maps is against Google's Terms of Service, and phones and emails are personal data under GDPR, CCPA and LGPD. Every tool on this page carries that risk; read the kit's [Responsible use](../README.md#responsible-use) before any outreach.