Google Maps Scraper skill
A skill for collecting business data from Google Maps: the agent plans queries, runs a local scraper and helps with the results
- 8,013 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs a local scraper and accesses the network
- Scraping requires respecting the source terms
Install
- Works in
Manual install
npx skills add gosom/google-maps-scraperAdds the skill to a compatible agent. Docker and Node.js are then required.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a local scraper and accesses the network
- Scraping requires respecting the source terms
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.
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.
Discussion
No questions or reviews yet.
Related
SkillsHasData Agent Skills: scraping and SERP API
HasData Agent Skills
Two HasData skills teach an agent to call the Google SERP, Amazon, Zillow and Maps APIs without guessing endpoints
Web Access
web-access
A web access skill that picks between search, page fetch and driving your own browser over CDP
Plugin with live web data: search, scraping and ready workflows for competitor intel, SEO and company research.
A web research skill: SearXNG searches, Camofox reads pages and CloakBrowser opens sites that check their visitors
A skill for web search, X search and page fetching for models without web access: no signup or key, the answer is JSON with source links
Two small skills: web search through your own browser with no paid API, and a preflight risk check before a meaningful change.
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.
README badge
Original 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.