local-prospect

Zero-cost local business lead finder & website auditor CLI in Go.
Powered by OpenStreetMap Overpass API & concurrent goroutine site checks.

Installation • Usage • Lead Tiers • Docs

---

🚀 Features

• 100% Free & Open Source: Powered by OpenStreetMap Overpass API (no Google Places or SerpAPI keys needed).
• Concurrent Audit Engine: Uses Go goroutines & channels with configurable worker pool concurrency (--concurrency).
• Automated Web Checks:
  • HTTP Reachability & Status (5s deadline).
  • SSL Certificate Verification.
  • Mobile Responsiveness (<meta name="viewport"> detection).
  • Tech Stack Signature Detection (WordPress, Wix, Squarespace, Shopify, Weebly, Webflow).
• 4 Sales Priority Tiers:
  • 🔴 TIER 1 (NO WEBSITE): Business has no website in registry (Highest value prospect).
  • 🟠 TIER 1 (BROKEN SITE): Site listed but returned 4xx/5xx or timed out.
  • 🟡 TIER 2 (NO SSL / MOBILE): Site works, but lacks HTTPS/SSL or lacks mobile viewport.
  • ⚪ TIER 3 (EXISTING SITE): Active, secure, mobile-friendly website.
• Dual Exporter & Lipgloss UI: Exports sorted leads to both .json and .csv files alongside a styled terminal summary box.

---

📦 Installation & Building

Install via Go

go install github.com/spencer-life/local-prospect@latest

Install AI Agent Skill (Cross-Agent)

npx skills add spencer-life/local-prospect

---

🛠️ CLI Usage

local-prospect --location "<City, State>" [flags]

Options & Flags

Flag	Short	Description	Default
--location	-l	Target city/town name (e.g. "Fountain Hills, AZ")	Required
--category	-c	Business category filter (plumber, restaurant, hairdresser, car_repair, all)	"all"
--output	-o	Output file path (generates both .json and .csv)	"./leads.json"
--concurrency	-n	Max concurrent website audit workers	15

---

💡 Usage Examples

Find all plumbers in Fountain Hills, AZ

local-prospect --location "Fountain Hills, AZ" --category plumber --output ./fountain_hills_plumbers.json

Find all restaurants in Scottsdale with 25 concurrent workers

local-prospect --location "Scottsdale, AZ" --category restaurant --concurrency 25 --output ./scottsdale_restaurants.json

---

📄 Documentation

For full visual architecture walkthrough, inspect docs.html in this repository.

🧪 Testing

Run the full Go test suite:

go test -v ./...