How this works
The Google Maps Scraper Kit pulls clean lead lists from Google Maps: business name, phone, website, rating, and address. Normally, setting this up would mean typing technical commands into a terminal. In this guide, you do not do that. You use Claude Code inside the Claude Desktop app, and you just tell it what you want in plain English. Claude runs every technical step behind the scenes.
This tool pulls data directly from Google Maps, which is against Google's Terms of Service. Use it responsibly, one job at a time, and follow data protection rules such as GDPR or CCPA for any phone numbers or emails you collect.
What you need
Install Docker Desktop
Docker Desktop is the app that quietly runs the scraper on your computer. You will not need to open it or click anything inside it once it is installed.
- a.Go to docker.com/products/docker-desktop and download the version for your computer
- b.Open the installer and follow the on-screen steps, using all the default options
- c.Open Docker Desktop once so it finishes starting up, then leave it running in the background
You do not need to understand Docker to use it. Think of it as the engine under the hood. Claude Code will check that it is running for you later, so nothing more to do here.
Install Claude Desktop
Claude Desktop is the app that does the technical work in every step from here on, through its built-in Code tab.
- a.Go to claude.com/download and install the app for your computer
- b.Open the app and sign in with your Claude account
Open a folder in Claude Code
No terminal needed. You just need an empty folder ready for Claude to work in, then point Claude Desktop at it with a couple of clicks.
- a.Create a new, empty folder on your computer and name it something like "Google Maps Scraper"
- b.In Claude Desktop, click the Code tab at the top, next to Chat and Cowork
- c.Choose Local to work with files on your own computer
- d.Click Select folder and choose the empty folder you just created
A chat box opens for this project. Everything from here is just typing sentences into that box, starting with getting the actual kit files into this folder.
Get the kit files from GitHub
The folder you selected is empty. Ask Claude to pull the actual kit files into it from GitHub.
Replace the bracketed part with the actual GitHub link before you send it. Claude checks whether git is installed, installs it if needed, clones the repository into the folder, and confirms once the files are there.
If someone already shared the kit folder with you directly instead of a GitHub link, skip this step. Just select that shared folder in step 3 and move on to step 5.
Ask Claude Code to set everything up
Type the request below into the Claude Code chat box. It starts the scraper in the background and checks that it is ready.
Claude Code will start Docker running the scraper, check the connection, and tell you in plain English once everything is ready. If Docker is not open yet, ask Claude Code to check, and it will tell you what to do.
Run your first scrape
Tell Claude Code the type of business and the city you want. It handles everything: starting the search, waiting for it to finish, and turning the results into a table for you.
Swap in whatever business type and city you actually need. A first search usually takes one to two minutes to come back.
Understand what you get back
By default, Claude Code hands you a clean table with only the useful fields for outreach: name, phone, email, website, category, address, rating, and review count. Anything technical, like map coordinates or internal IDs, is left out so the list is easy to actually use.
Treat the list as leads to verify and reach out to, not as data to resell. Phone numbers and emails count as personal data, so follow the usual outreach and privacy rules where your business operates.
Ask for more detail if you need it
You can ask for extra information without changing anything on your end. Just say what you want.
This scans each business's own website for links to their social pages, so it does not add any extra effort on your side. It is a bit slower, and coverage depends on whether a business actually links its socials.
Scale up without getting blocked
Google can temporarily block scraping from your internet connection if you run very large searches back to back. This clears itself after a while and never affects your Google account, but it does mean a search might come back empty or fail while it is happening.
If a search comes back empty, fails, or has far fewer results than usual, wait a while before trying again rather than running it right back.
For a big or repeated job, just ask.
Claude Code will slow the pace down and add proxies if you have them, or tell you plainly if the job is risky as described.
Manage and stop jobs
You never need to touch a terminal command directly. Ask for what you want instead.
Stopping the scraper when you are done frees up your computer's resources. Starting it again next time is just step 5, asking Claude Code to set everything up.
Good habits, at a glance
FAQs
Do I ever need to type a technical command myself?
No. Opening the Code tab and selecting the folder is done entirely with clicks. Everything after that is a plain English sentence in the chat box.
Can this find leads from Instagram or TikTok instead?
No. It only works with Google Maps listings. Ask Claude and it will tell you plainly if a request is outside what this tool does.
Will a block affect my Google account?
No. Only the internet connection making the requests is affected, and only temporarily. Your Google account is never banned.
What if I close the app and come back later?
Open Claude Desktop, click the Code tab, and open the same session or select the kit folder again. Your past results are still saved.
If something goes wrong
You do not need to diagnose anything yourself. Just describe what you are seeing to Claude Code in plain English, and it will check what is wrong and fix it.
| What you notice | What to say to Claude Code |
|---|---|
| Nothing seems to be working at all | "Can you check if the scraper is running and fix it if not?" |
| A search came back empty | "That search came back empty, can you check what went wrong?" |
| A search is stuck and never finishes | "This search has been running a long time, can you check its status?" |
| You are missing emails you expected | "Can you re-run that with email addresses included?" |
| You want to start completely fresh | "Can you fully reset the scraper and clear old data?" |