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
Contributing
This page tells you how to get a bug fixed or a change merged into the Google Maps Scraper Kit.
- Report bugs with the bug report issue template. Include the exact command and the full error.
- Keep pull requests small, one change each. Test with a
depth 1scrape and runpython3 scripts/test_scrape.py,python3 engine/test_engine.pyandpython3 engine/test_cdp.pybefore you open the PR. CI runs the same suites on Linux, macOS and Windows, a bash syntax check, and a freshdocker compose upon every PR. - Keep the scripts portable.
scripts/scrape.pyand the engine use the Python standard library only, so do not add pip dependencies.scripts/scrape.shmust run on macOS's default bash 3.2. - Engine changes go in
engine/, with offline tests inengine/test_engine.py(a fake Chrome and fake Google results, no network). - Never commit scrape output. CSV and result files are git-ignored because they hold personal data.
- Forks: please keep the sponsor box as it is. The web UI reads its sponsor tiles from this
repository's
assets/sponsors/sponsors.jsononmaster(theSPONSORSURL inengine/serve.py), so every copy shows the sponsors who fund the kit's upkeep, and a user can hide the box with its close button. The MIT licence lets you change that line; we ask you not to, and to send sponsor requests upstream instead (Become a sponsor).