GMScraper Pro 🚀

A professional, open-source Google Maps scraping desktop application built with Electron.js and Playwright.

Developed with ❤️ by ZQ DEVELOPERS

---

🌟 Features

• No API Key Needed: Uses Playwright to scrape directly from Google Maps.
• Real-time Console: Live progress tracking and log console.
• Data Management: Search, filter, and view results within the app.
• Rich Export Options: Easily export scraped data to CSV and Excel.
• Proxy Support: Built-in proxy manager with optional rotation for safe scraping.
• Cross-Platform: Ready to use on Windows and macOS.
• Modern UI: Sleek, dark-themed, and responsive interface.
• Built-in Keygen: Comes with a full license key server and GUI generator for commercial adaptation.

---

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/zqdevelopers/gmscraper-pro.git
cd gmscraper-pro

2. Install Dependencies

# Install main application packages
npm install

# Install Playwright browser binaries
npx playwright install chromium

3. Run in Development

npm run dev

---

📦 Building Executables

We've automated the build process using GitHub Actions!

GitHub Actions (Easiest)

Whenever you push to the main branch, GitHub Actions will automatically compile the latest .exe for Windows and .dmg for macOS.

1. Go to the Actions tab on this repository.
2. Click the latest workflow run.
3. Download your artifacts from the bottom of the page.

Local Builds

If you prefer to build it locally on your machine:

# Windows
npm run build:win

# macOS
npm run build:mac

---

🛠 Tech Stack

Component	Technology
Desktop Shell	Electron
Web Scraper	Playwright (Chromium)
Local Database	better-sqlite3 / sql.js
Data Export	csv-writer, ExcelJS
UI Styling	Vanilla CSS (Dark Theme)

---

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

This project is open-sourced and maintained by ZQ DEVELOPERS. Please refer to the LICENSE file for more details.

---

If you find this project helpful, please give it a ⭐️ on GitHub!