Skip to content

ashmitb95/gmaps-leadgen

Repository files navigation

WhiskerScout

Google Maps lead generation tool. Searches for businesses by category and location, identifies those without a website, and exports them as leads for cold outreach.

How it works

  1. Enter a business type (e.g., "dentists") and location (e.g., "Hauz Khas, Delhi")
  2. WhiskerScout queries Google Places API and fetches up to 60 results
  3. Businesses without a website are flagged as leads
  4. Export leads to CSV with name, phone, address, rating, and Google Maps link
  5. All searches are saved to a database for quick reload

Tech stack

  • Next.js 16 (App Router, TypeScript)
  • Google Places API (New) for business data
  • Turso (libSQL) for persisting searches and leads
  • Drizzle ORM for type-safe database access
  • Tailwind CSS + shadcn/ui for the frontend

Setup

1. Clone and install

git clone https://github.com/ashmitb95/gmaps-leadgen.git
cd gmaps-leadgen
npm install

2. Configure environment

Create a .env.local file:

APP_PASSWORD=your_password_here
GOOGLE_API_KEY=your_google_api_key
TURSO_DATABASE_URL=libsql://your-db.turso.io
TURSO_AUTH_TOKEN=your_turso_token

Google API key: Create a project in Google Cloud Console, enable "Places API (New)", and generate an API key. Google provides $200/month free credit (~76k business lookups).

Turso: Create a free database at turso.tech.

3. Push database schema

npx drizzle-kit push

4. Run

npm run dev

Opens on http://localhost:3003.

Deploy to Vercel

  1. Push to GitHub
  2. Import the repo in Vercel
  3. Add the four environment variables from .env.local
  4. Deploy

API costs

Google Places API (New) with Contact fields: ~$0.05 per request. Each search uses 1-3 requests depending on result count. The $200/month free credit covers ~3,800 searches. WhiskerScout tracks usage in the header bar.

About

Lead search tool for Branding and Website Development agencies, to quickly find businesses in an area without online presence

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors