A powerful, fully cloud-based Google Maps Lead Scraper with a user-friendly web interface. Scrape targeted B2B leads (Business Name, Phone, Website, Address, and Maps Link) directly via GitHub Actions—without burning your own PC's RAM or CPU!
- ☁️ 100% Cloud-Based: The actual scraping process (Puppeteer/Browser automation) runs on GitHub's cloud servers, meaning zero lag on your local computer.
- 🔗 Direct Map Links: No need to manually create CSV files. Just copy and paste one or multiple Google Maps search URLs directly into the text box.
- 🎯 Smart Filtering: Keep only specific business categories and automatically exclude unwanted major franchise domains (e.g.,
servpro.com,pauldavis.com). - 🔄 Auto-De-duplication: Automatically filters out duplicate business listings or phone numbers before exporting.
- ⏳ Live Status Tracking: Watch the progress live on the web panel without ever needing to log into GitHub.
- 📥 One-Click Direct Download: Once the scraping is finished, a download button appears directly on your web panel.
To deploy your own instance of this panel, follow these quick steps:
Before starting, you MUST fork this repository to your own GitHub account:
- Click the "Fork" button at the top right of this page to create a copy under your account.
- After forking, go to the Actions tab of your new repository and click the green button that says "I understand my workflows, go ahead and enable them". (Crucial step!)
- Go to your GitHub Account Settings > Developer Settings > Personal Access Tokens > Tokens (classic).
- Click Generate new token (classic).
- Give it a note (e.g.,
Maps-Scraper). - Select the following scopes:
repoandworkflow. - Click generate, and copy the token safely. (Treat it like a password!)
- Go to your repository's Settings > Pages tab.
- Under Build and deployment, set the Source to
Deploy from a branch. - Choose your branch as
mainand the folder as/ (root), then click Save. - Within 1–2 minutes, GitHub will give you a live URL (e.g.,
https://yourusername.github.io/your-repo-name/).
- Open your GitHub Pages Live URL.
- Paste your GitHub Personal Access Token into the token field.
- Enter your Repository path (Format:
your-github-username/your-repo-name). - Step 1: Paste your Google Maps search links (one per line) into the box. (Alternatively, you can still upload a traditional
input.csvfile). - Step 2 & 3: Enter the categories you want to include and domains you want to exclude (one per line).
- Click the "🚀 Run Scraper" button.
- Keep the tab open. The panel will track the cloud progress live. Once completed, a green "📥 Download File" button will dynamically appear. Click it to download your fresh leads!
- Client-Side Security: Your GitHub Personal Access Token is saved only in your local browser storage (
LocalStorage). It is never sent to any third-party server or database. - Private Repo Friendly: You can keep this repository completely Private to protect your code and scraped data; the GitHub Pages panel will still work perfectly for you.
💡 Maintained by Sanjudev