Metadata-Version: 2.2
Name: google-map-scraper
Version: 1.0.1
Summary: A fast business scraper for Google Maps using Selenium
Home-page: https://github.com/mukhtar-ul-islam88/google_map_scraper
Author: Mukhtar ul Islam
Author-email: Mukhtarulislam88@hotmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: selenium==4.31.0
Requires-Dist: selenium-wire==5.1.0
Requires-Dist: webdriver-manager==4.0.2
Requires-Dist: blinker==1.7.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🗺️ Google Maps Business Scraper Appication

This project is a **Web application** that allows users to scrape business information from Google Maps based on a search keyword. The extracted data includes the business name, website, Google Maps link, phone number, and ratings. The results are downloadable in both **JSON** and **CSV** formats.

---

## 🚀 Features

- 🔍 Input any business search keyword (e.g., `restaurant in India`)
- 🧠 Automatically scrapes:
  - Business Name
  - Website
  - Google Maps Link
  - Phone Number
  - Rating & Review Count
- 📁 Downloadable output in both:
  - `results.json`
  - `results.csv`
- ✅ Clean and simple
- 🕵️ Built-in support for scrolling Google Maps listings

---

## Prerequisites

Before running this project, ensure you have the following installed:
- Python (3.6 or higher recommended)
- pip (usually comes with Python)

## 🛠 Installation

1. **Clone this repository**

   ```bash
   git clone https://github.com/mukhtar-ul-islam88/google_map_scraper.git
   
   ```

2. **create the environment**
   ```bash
        python -m venv venv
        source venv/bin/activate  # On Windows: venv\Scripts\activate      
    ```
3. **Navigate to the project directory:**
   ```bash
   cd google_map_scraper
   ```
4. **Install the dependencies:**
   ```bash
   pip install -r requirements.txt
   ```



## ✨ Usage Instructions
Type your search keyword (e.g., restaurant India) in the input box.




```bash
from google_map_scraper.scraper import GoogleMapsScraper

scraper = GoogleMapsScraper()
results = scraper.scrape("CA in Hyderabad India")

```

## 📁 Output
-  results.json — full list of businesses

-  results.csv — same in spreadsheet form


## 🧪 Testing
```bash
python tests/test_scraper.py

```

# ❗ Notes
- The scraper uses Selenium with ChromeDriver, make sure Google Chrome is installed.

- Google Maps may temporarily block access if too many requests are made in a short time.

- The scraping process scrolls through Google Maps listings and collects visible information only.
