Ayyouboss0011

Ayyouboss0011 / SherlockMaps

Public

Powerful Google Maps scraping tool with REST API, Docker support & multi-format export

browser-automation data-extraction docker google google-maps
14
1
69% credibility
Found May 17, 2026 at 18 stars 3x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

SherlockMaps is an open-source tool that automatically searches Google Maps to find and collect detailed information about businesses. You tell it what to search for (like 'restaurants in Berlin'), and it visits Google Maps, scrolls through results, clicks on each business listing, and gathers details like names, addresses, phone numbers, websites, ratings, and opening hours. The tool removes duplicates and validates website links, then delivers the results in your preferred format—either as a saved file, through a simple web dashboard, or directly to your screen. It can run as a standalone program, as a web service, or be integrated into other projects.

How It Works

1
💡 You discover a way to find business information

You hear about a tool that can automatically search Google Maps and collect details about businesses like restaurants, shops, or services in any area.

2
🚀 You get everything running in minutes

With one simple command, the tool launches and is ready to work. Docker handles all the technical setup automatically so you don't have to worry about installing anything.

3
🔍 You tell it what to search for

You type in what you're looking for, like 'pizza restaurants in Berlin' or 'plumbers in Munich'. The tool remembers your search and prepares to explore Google Maps.

4
🌐 The tool explores Google Maps for you

Behind the scenes, the tool opens Google Maps, searches for your term, and scrolls through all the results it finds, collecting links to each business listing.

5
📋 It visits each business and gathers details

For every business found, the tool clicks through to learn more: the name, address, phone number, website, star rating, reviews, and even opening hours.

6
You choose how to receive your results
📄
As a file you can open later

The results are saved as a file on your computer, ready to open in any spreadsheet or data tool.

🌐
Through a web dashboard

The results are available through a simple web interface where you can check status and download data anytime.

💻
Directly to your screen

The data appears right in your terminal in a clean, readable format.

✅ You have a complete list of businesses

The tool has cleaned up any duplicates and verified that websites are valid. You now have a neat list of businesses with all their contact information, ready to use for research, building a directory, or whatever you need.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 18 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is SherlockMaps?

SherlockMaps is a Python-based web crawler that extracts business information from Google Maps. It uses Playwright for browser automation and outputs company data in multiple formats including JSON and CSV. You can run it via command line, as a REST API server, or import it directly as a Python library.

Why is it gaining traction?

The project combines several capabilities that developers typically need to cobble together separately: browser automation, data extraction, deduplication, and multi-format export. The Docker support makes deployment straightforward, while the REST API with job queuing allows you to submit crawl jobs and retrieve results asynchronously. The Chrome profile persistence is a practical touch that helps maintain sessions across runs.

Who should use this?

Researchers building datasets of local businesses will find the CLI mode useful for one-off searches. Teams needing programmatic access to Google Maps data can use the REST API for integration into existing workflows. Lead generation services and market research tools are natural fits. If you need to extract contact information, ratings, or business hours at scale without building the scraping infrastructure yourself, this handles the heavy lifting.

Verdict

This is a functional tool with a well-documented API and Docker deployment. The credibility score of 0.7% reflects the early stage -- only 14 stars and limited community history. The hardcoded German localization and reliance on CSS selectors that Google can change at any time are real maintenance concerns. For production use, budget time for selector updates when Google inevitably changes their UI. Start with Docker to evaluate the output quality before committing to a larger integration.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.