---
name: google-maps-scraper
description: "Scrape lokasi dari Google Maps — coffee shop, restoran, tempat wisata. Trigger: 'scrape google maps', 'cari coffee shop', 'cari tempat makan'"
---

# 🗺️ Google Maps Scraper

Scrape data lokasi dari Google Maps tanpa API key. Pakai Playwright untuk bypass bot detection.

## Dependencies

```bash
pip install playwright
python -m playwright install chromium
```

Kalau headless server/VPS, butuh extra deps:
```bash
sudo apt install -y libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libgbm1 libasound2
```

## Cara Pakai

### CLI (direct)
```bash
python gmaps_scraper.py "coffee shop" "Yogyakarta" --max 20
python gmaps_scraper.py "restoran" "Jakarta Selatan" --max 10 -o hasil.csv
python gmaps_scraper.py "tempat wisata" "Bali" --max 15
```

### Via AI Agent
```
"Cari coffee shop di Jogja dari Google Maps"
"Scrape restoran di Jakarta Selatan rating >4.5"
"Tempat wisata di Bali yang buka 24 jam"
```

## Arguments

| Arg | Default | Description |
|-----|---------|-------------|
| `query` | required | Search query (e.g. "coffee shop") |
| `location` | required | Location (e.g. "Yogyakarta") |
| `--max` | 50 | Max results |
| `--output, -o` | auto | Output CSV path |
| `--headless` | True | Run without browser UI |
| `--no-headless` | - | Show browser (debug) |
| `--delay` | 1.5 | Scroll delay (seconds) |

## Output Format

CSV/JSON dengan fields:

| Field | Contoh |
|-------|--------|
| Name | Kopi Kultur |
| Rating | 4.8 |
| Reviews | 1234 |
| Price_range | Rp 25–50 rb |
| Category | Kedai Kopi |
| Address | Jl. Kaliurang KM 5 |
| Phone | 0812-xxxx-xxxx |
| Website | kopikultur.com |
| Hours | Buka · Tutup pukul 22.00 |

## Teknis

1. Buka Google Maps search URL
2. Scroll results panel untuk load lebih banyak listing
3. Klik setiap card → extract data dari detail panel
4. Parse: Name, Rating, Reviews, Price, Category, Address, Phone, Website, Hours
5. Save ke CSV + JSON

## Limitasi

- Tanpa login Google: max ~20 results per search
- Rate limit: jangan scrape terlalu cepat (default delay 1.5s)
- Data bisa berubah sewaktu-waktu (Google update struktur)
- CSS selectors mungkin perlu update kalau Google Maps redesign

## Troubleshooting

| Problem | Fix |
|---------|-----|
| `playwright not found` | `pip install playwright && python -m playwright install chromium` |
| `chromium failed to launch` | `sudo apt install libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libgbm1 libasound2` |
| `timeout` | Google Maps loading lambat, coba tambah timeout atau cek network |
| `no results` | Coba query yang lebih spesifik |
| `0 data / CSS selector error` | Google Maps pakai `button` bukan `a` — sudah di-fix (auto-detect) |
| `redirect ke detail page` | Auto-retry dengan coordinate URL + search box fallback |

## Changelog

### 2026-04-16 — Robust Selector + Redirect Fix
- **Fix**: Selector `a[class*="hfpxzc"]` → auto-detect `button` (new) / `a` (old) / aria-label fallback
- **Fix**: Handle redirect ke detail page → auto-retry dengan coordinate URL + search box
- **New**: `get_listing_cards()` — unified card detection
- **New**: `is_detail_page()` — detect if redirected to single listing
- **New**: Debug screenshot saved if no cards found

### 2026-04-16 — URL-Based Extraction (v2)
- **Fix**: Click-based extraction only got 7 results (DOM breaks after clicking)
- **New**: `get_card_links()` — collect all place URLs first, then visit one-by-one
- **New**: `extract_from_detail()` — extract data when already on a place URL
- **New**: `extract_listings_click()` — fallback click-based approach
- **Result**: 7 → 45+ results per search
- **Default**: `--max` changed from 20 to 50

---
*Made with ❤️ by @bungkust*