Google Maps Scraper
A skill for collecting business data from Google Maps: the agent plans queries, runs a local scraper and helps with the results
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Runs a local scraper and accesses the network
- Scraping requires respecting the source terms
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/google-maps-scraperDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .claude/skills
cp -R "$tmp/skills/google-maps-scraper" .claude/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .agents/skills
cp -R "$tmp/skills/google-maps-scraper" .agents/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .github/skills
cp -R "$tmp/skills/google-maps-scraper" .github/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .agents/skills
cp -R "$tmp/skills/google-maps-scraper" .agents/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .agents/skills
cp -R "$tmp/skills/google-maps-scraper" .agents/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .devin/skills
cp -R "$tmp/skills/google-maps-scraper" .devin/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .cline/skills
cp -R "$tmp/skills/google-maps-scraper" .cline/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .roo/skills
cp -R "$tmp/skills/google-maps-scraper" .roo/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add gosom/google-maps-scraper --skill google-maps-scraper -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit d0b51bc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .agents/skills
cp -R "$tmp/skills/google-maps-scraper" .agents/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .agents/skills
cp -R "$tmp/skills/google-maps-scraper" .agents/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/google-maps-scraper/
git -C "$tmp" checkout d0b51bcf3cd56d9a3f71e049cb6e226554e24162
mkdir -p .agents/skills
cp -R "$tmp/skills/google-maps-scraper" .agents/skills/google-maps-scraperCommands for macOS and Linux, on Windows run them in Git Bash.
Install the skill with npx skills add gosom/google-maps-scraper, then follow SKILL.md: clarify niche and city, validate on a small sample and run the local crawl in Docker.
Other ways from the author
npx skills add gosom/google-maps-scraperAdds the skill to a compatible agent. Docker and Node.js are then required.
This is third-party code. Review the repository files before installing.
What it does
The skill turns a natural-language request like find dentists in Berlin into a set of Google Maps queries and runs the open-source scraper locally through Docker. It collects name, address, phone, website, rating, review count, coordinates, and optionally email and the reviews themselves. The agent validates the run on a small sample, monitors the full crawl and helps you work with the export. It supports proxies and adjustable depth so you do not overload the source.
Who it is for. For anyone collecting leads and local contacts: sales, marketing, business owners, marketplace sellers.
Good fit when
- You need a list of businesses by niche and city with contacts
- You need to collect reviews and ratings for a place
- You need a CSV lead export without manual copying
Not a fit when
- You cannot run Docker locally
- You need data from a source other than Google Maps
- Scraping would violate the source terms in your case
Example request
Collect coffee shops in downtown Kazan with phones and websites, export to CSVLimitations
Requires Docker and Node.js on macOS, Linux or Windows via WSL. Speed and completeness depend on depth, region and whether a proxy is used. Compliance with Google terms and data laws is on the user.
How to disable. Remove the google-maps-scraper skill folder from the agent skills directory and stop the Docker containers.
Security check
- Runs a local scraper and accesses the network
- Scraping requires respecting the source terms
README in short
gosom/google-maps-scraper is a Go tool that scrapes place data from Google Maps with CLI, web UI and REST API. A dedicated skill lets a nontechnical user drive the crawl through an AI agent: the agent builds queries, runs Docker, monitors progress and helps with the export. The README covers installing the skill via npx skills add, running through Docker and a provision script, and configuring proxies. MIT licensed.
SKILL.md
--- name: google-maps-scraper description: > Find businesses, leads, emails, reviews, ratings, and contact details from Google Maps. Use for requests such as "find dentists in Berlin", "scrape Google Maps", "get local business leads", or "collect Google Maps reviews". Runs the open-source scraper locally with Docker and guides nontechnical users through setup, monitoring, and results. license: MIT compatibility: "Requires Docker and Node.js on macOS, Linux, or Windows through WSL." --- # Google Maps Scraper Turn a natural-language lead request into a validated local Google Maps crawl, monitor it, and help the user work with the results.
FAQ
Do I need a proxy?
No, small volumes work without one. The skill suggests a proxy only for large runs and does not require it every time.
Where do results go?
To local files, CSV by default. The data stays on your machine.
Related
CLI, skill and Python library for browser control: the agent clicks, fills forms and reads pages over CDP
A skill that gathers the last 30 days of discussion on a topic from Reddit, X, YouTube, HN, Polymarket and GitHub into one brief
The Chrome DevTools team's official MCP server: the agent drives a live Chrome, reads network and console, and records performance traces
A fast Rust CLI for agent browser automation: accessibility snapshots with element refs, an MCP server and skills