← all repositories
Mahanaicoach/google-maps-scraper-kit

Claude can't scrape Maps alone — this kit hands it the engine

Ask a chat AI to scrape Google Maps and you get a consent wall and zero structured rows; this kit hands Claude a real local scraping engine to drive instead.

★2.6k stars Python Coding AssistantsData Tooling
google-maps-scraper-kit
Velocity · 7d
+34
★ / day
Trend
→steady
star history

What it does Name a business type and a city — gyms in Miami, dentists in Denver — and get back an outreach-ready CSV: name, phone, email, website, category, address, rating, review count. The scraping engine runs in a local container bound to 127.0.0.1, and a Claude Code skill plus four slash commands handle job creation, polling, download, and cleanup. Prefer no AI in the loop? scripts/scrape.py is a standalone, dependency-free CLI covering single queries, batches, geocoding, and socials.

The interesting bit This is honest glue code, and the glue is the point. The engine captures ~34 raw fields; the kit’s real contribution is the boring filter that keeps the 8 you actually contact and qualify with. Social enrichment (--socials) is refreshingly un-AI — plain HTTP and regex over business websites, zero tokens burned — and the skill ships with guardrails: it flags risky large requests, suggests proxies, and refuses only clearly abusive use.

Key highlights

  • Runs entirely on your machine — no SaaS, no credits, no API keys.
  • Email extraction on by default, pulled from each business’s own website.
  • Auto-geocoding: type a city name, coordinates get resolved for you.
  • Batch mode: many keywords, one job, one CSV.
  • Optional Instagram, Facebook, and LinkedIn enrichment from business sites.

Caveats

  • Scraping Google Maps is against Google’s Terms of Service — the README admits it. Treat output as leads to verify, not a dataset to resell.
  • Heavy use without proxies can get your IP temporarily rate-limited (minutes to hours); the engine rotates proxies automatically if you supply them.
  • Requires Docker Desktop, and the repo is mostly orchestration — third-party components are credited in CREDITS.md.

Verdict Worth a look if you do B2B outreach and already live in Claude Code: it’s the difference between asking an AI for leads and actually getting a CSV. Skip it if you need airtight compliance or expected the model itself to do the scraping.

Frequently asked

What is Mahanaicoach/google-maps-scraper-kit?
Ask a chat AI to scrape Google Maps and you get a consent wall and zero structured rows; this kit hands Claude a real local scraping engine to drive instead.
Is google-maps-scraper-kit open source?
Yes — Mahanaicoach/google-maps-scraper-kit is open source, released under the AGPL-3.0 license.
What language is google-maps-scraper-kit written in?
Mahanaicoach/google-maps-scraper-kit is primarily written in Python.
How popular is google-maps-scraper-kit?
Mahanaicoach/google-maps-scraper-kit has 2.6k stars on GitHub and is currently holding steady.
Where can I find google-maps-scraper-kit?
Mahanaicoach/google-maps-scraper-kit is on GitHub at https://github.com/Mahanaicoach/google-maps-scraper-kit.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.