Skip to content
Get packs

Google Maps Scraper

Lets the agent run a local Google Maps crawl and turn results into leads, contacts, and reviews.

Source Download skill
Repository
gosom/google-maps-scraper
Stars
7,175
Licence
MIT
Files
15 files

What it does

Once installed, the agent can turn a plain request like finding dentists in Berlin into a set of Google Maps searches, run the open-source scraper on your own computer using Docker, check on its progress, and then show you a preview of businesses with details such as phone, website, address, and rating, plus a file you can save. It also guides you through optional proxy setup and can extract emails or reviews when you ask.

Great for

  • Sales or marketing teams building local business lead lists
  • Analysts who want Google Maps business data in a CSV file
  • Nontechnical users who want guided setup of a local scraper

Skip it if

  • Users who cannot install Docker or Node.js, since the scraper will not run without them
  • Large-scale or sensitive scraping without checking Google Maps terms and local privacy rules, because collecting contact details can carry legal and reputational risk
  • Anyone expecting guaranteed complete results, since the skill itself says proxies do not guarantee results

Try asking

  • “Find dentists in Berlin and give me a CSV of names, phones, and websites”
  • “Scrape Google Maps for coffee shops in Lisbon and show me the top 20 by rating”
  • “Collect Google Maps reviews for my competitor's gym in Austin”
  • “Get local business leads for roofing companies in Ohio, including emails from their websites”
Step-by-step guide: how to use Google Maps ScraperInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the MIT licence and an attribution note.

    google-maps-scraper.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip google-maps-scraper.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip google-maps-scraper.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Start with a single validation query and shallow depth so you can confirm the setup works before a large crawl.
  • Keep proxy credentials out of chat; enter them only in the local terminal prompt the helper opens.
  • Check the terms of service and privacy rules that apply to you before extracting emails or contact details.

What's inside

  • references/advanced-coverage.md
  • references/local-execution.md
  • references/proxy-setup.md
  • references/proxy-sponsors.json
  • references/query-planning.md
  • references/recovery.md
  • references/results.md
  • scripts/configure-proxy.sh
  • scripts/ensure-latest.sh
  • scripts/helpers_test.sh
  • scripts/run-local.sh
  • scripts/select-proxy-sponsors.mjs
  • scripts/select-proxy-sponsors.test.mjs
  • scripts/status-local.mjs
  • SKILL.md

Redistributed unmodified from gosom/google-maps-scraper under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.