# Gmaps Scraper

> Google Maps scraper: async Python library, CLI & MCP server for business data (emails, phones, reviews, leads) over pure HTTP — no API key, no browser.

- **Type:** MCP server
- **Install:** `agentstack add mcp-nick-choudhary-gmaps-scraper`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nick-choudhary](https://agentstack.voostack.com/s/nick-choudhary)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nick-choudhary](https://github.com/nick-choudhary)
- **Source:** https://github.com/nick-choudhary/gmaps-scraper

## Install

```sh
agentstack add mcp-nick-choudhary-gmaps-scraper
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# gmaps-scraper

**Turn any place into a spreadsheet of local businesses.**

`gmaps-scraper` pulls business listings from Google Maps — names, addresses, phone
numbers, websites, ratings, reviews, categories, and opening hours — and can also find
**emails and social profiles** so you can build lead lists. Export to **JSON or CSV**
with a single command.

No API key. No sign-up. No browser to install. Just `pip install` and run.

---

## What you get for each business

- Name, full address, and neighborhood
- Phone number and website
- Star rating and review count
- Category (e.g. "Chiropractor", "Coffee shop")
- Opening hours *(with `--enrich`)*
- Emails and social profiles — Facebook, Instagram, LinkedIn, and more *(with `--contacts`)*

## Install

```bash
pip install gmaps-scraper
```

That's the whole setup. (Requires Python 3.10 or newer.)

## Quick start

Search an area in plain English:

```bash
gmaps search "coffee shops in Austin, Texas"
```

Save the results as a CSV (opens in Excel or Google Sheets) or JSON:

```bash
gmaps search "coffee shops in Austin, Texas" --format csv -o coffee.csv
gmaps search "coffee shops in Austin, Texas" --format json -o coffee.json
```

## Collect an entire city (recommended)

A single search returns about 20 businesses. To cover a whole city or region
comprehensively — automatically, with duplicates removed — use `collect`:

```bash
gmaps collect "chiropractors" --location "Nashville, Tennessee" -o chiropractors.json
```

You get one clean file with every business found, plus a short report telling you
whether the run captured the full area. If a long run is interrupted, add `--resume`
to pick up exactly where it stopped — nothing is lost.

### Build a lead list (emails + socials)

```bash
gmaps collect "chiropractors" --location "Nashville, Tennessee" \
  --enrich --contacts --max-contacts 50 -o leads.json
```

- `--enrich` adds opening hours and extra details.
- `--contacts` visits each business's website and extracts emails and social profiles.
- `--max-contacts 50` caps how many websites to visit, so runs stay fast and focused.

### Common options

| Option | What it does |
|---|---|
| `--location "City, State"` | The area to cover, in plain English |
| `-o results.json` | Where to save the output |
| `--format csv` \| `json` | Output format (see below) |
| `--enrich` | Add opening hours and detailed fields |
| `--contacts` | Add emails and social profiles |
| `--max-contacts N` | Limit how many websites to check |
| `-n 500` | Maximum number of businesses to collect |
| `--resume` | Continue an interrupted collection |

Run `gmaps --help` (or `gmaps collect --help`) to see everything.

## Output formats

- **JSON** *(default)* — a clean list of businesses with all fields. Best for feeding
  into other tools or scripts.
- **CSV** — open directly in Excel or Google Sheets: add `--format csv -o file.csv`.
- Large `collect` runs also stream results to disk as they're found, so a long job is
  always safe to stop and `--resume`.

*More export options (Excel and direct database output) are on the way.*

## Use it from Python

```python
import asyncio
from gmaps import GMapsClient

async def main():
    async with GMapsClient() as client:
        result = await client.search.places(query="dentists in Miami", max_results=20)
        for business in result.places:
            print(business.name, business.phone, business.website)

asyncio.run(main())
```

## Use it with AI assistants

`gmaps-scraper` ships with a built-in server (MCP) so AI assistants like Claude can
search Google Maps and build business lists for you on request. Point your assistant's
tool configuration at the `gmaps` MCP server and ask it, for example, to "collect all
dentists in Miami with contact details."

## License

MIT — free for personal and commercial use.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nick-choudhary](https://github.com/nick-choudhary)
- **Source:** [nick-choudhary/gmaps-scraper](https://github.com/nick-choudhary/gmaps-scraper)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nick-choudhary-gmaps-scraper
- Seller: https://agentstack.voostack.com/s/nick-choudhary
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.