git404hub

what is prospect-collector fr?

percie1/prospect-collector — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · pm founderComplexity · 2/5Setup · moderate

tl;dr

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.

vibe map

mindmap
  root((repo))
    What it does
      Searches Google Maps by keyword
      Scrapes contact emails
      Exports CSV
    Tech stack
      Python
      Google Places API
      Playwright
      BeautifulSoup
    Use cases
      Sales lead lists
      Marketing outreach
      Local business research
    Audience
      Founders
      Sales teams
      Marketers
    Setup
      API key version
      No-API Playwright version

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Build a list of local business leads for a specific city and industry to reach out to for sales.

VIBE 2

Generate a CSV of business contacts for a marketing outreach campaign.

VIBE 3

Find publicly listed email addresses for businesses matching a Google Maps search term.

what's the stack?

PythonGoogle Places APIPlaywrightBeautifulSoup

how it stacks up fr

percie1/prospect-collector0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencepm foundergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

The API version needs a Google Places API key, the no-API version needs Playwright and a Chromium install.

in plain english

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.

prompts (copy fr)

prompt 1
Help me edit the SEARCH_QUERIES list in prospect_builder.py to search for restaurants in Nairobi instead of the default cities.
prompt 2
Show me how to get a Google Places API key so I can run prospect_builder.py.
prompt 3
Walk me through installing Playwright and Chromium so I can run prospect_builder_playwright.py without an API key.
prompt 4
Explain the columns in the CSV output from this tool and how I would import them into a spreadsheet.

Frequently asked questions

what is prospect-collector fr?

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.

What language is prospect-collector written in?

Mainly Python. The stack also includes Python, Google Places API, Playwright.

How hard is prospect-collector to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is prospect-collector for?

Mainly pm founder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.