percie1/prospect-collector — explained in plain English
Analysis updated 2026-05-18
Build a list of local business leads for a specific city and industry to reach out to for sales.
Generate a CSV of business contacts for a marketing outreach campaign.
Find publicly listed email addresses for businesses matching a Google Maps search term.
| percie1/prospect-collector | 0xallam/my-recipe | 0xhassaan/nn-from-scratch | |
|---|---|---|---|
| Stars | 0 | — | 0 |
| Language | Python | Python | Python |
| Last pushed | — | 2022-11-22 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 2/5 | 2/5 | 4/5 |
| Audience | pm founder | general | developer |
Figures from each repo's GitHub metadata at analysis time.
The API version needs a Google Places API key, the no-API version needs Playwright and a Chromium install.
Prospect Collector is a Python tool built for finding business contact information at scale. It searches Google Maps for businesses matching a keyword, like "construction company Lagos" or "private hospital Abuja," then visits each business website and pulls out any publicly listed email addresses from their contact pages. The end result is a clean CSV file you can use for sales or marketing outreach. The tool collects five pieces of information for each business it finds: the business name, address, phone number, website, and any public email addresses found on the site. It works for any city and any type of business, so you can point it at a specific industry and location and get a list back. There are two ways to run it. The first uses the Google Places API, which needs an API key from Google and is the recommended option. The second version uses Playwright to control a Chromium browser directly, which avoids the need for an API key but requires installing the Playwright browser automation library first. To customize what the tool searches for, you open either script and edit a list of search queries near the top of the file. Each entry is a plain text search term, the kind you would normally type into Google Maps yourself, so no special syntax is needed. The output is a CSV spreadsheet with columns for name, address, phone, website, emails, the original search query, and a notes field. The author notes that the tool only collects contact information that is already publicly visible on business websites, nothing private or hidden. The project's git configuration is already set up so an API key or collected CSV files do not get committed by accident. This is a small, single-purpose script rather than a large application, built by a cybersecurity consultant based in Lagos, Nigeria.
A Python tool that searches Google Maps for businesses by keyword, then scrapes their websites for public contact emails and exports everything to a CSV for outreach.
Mainly Python. The stack also includes Python, Google Places API, Playwright.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly pm founder.
This repo across BitVibe Labs
double-check against the repo, no cap.