Skip to content

Ripple Lead Finder v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@agrajeet-builds agrajeet-builds released this 30 Jul 00:01
v1.0.0
0e62fe7

Ripple Lead Finder helps freelancers and small agencies find their next website client — local businesses anywhere in the world that have no website, complete with contact details and a ready-to-send pitch. It runs entirely on your own machine: no cloud, no account, and no API key required to start.

Install (two steps)

macOS

  1. Download Ripple-Lead-Finder-v1.0.0.zip below and unzip it (e.g. to your Desktop).
  2. Double-click start.command. First run only: right-click → Open → Open to get past the "unidentified developer" prompt.

Windows

  1. Download Ripple-Lead-Finder-v1.0.0.zip below and unzip it (e.g. to your Desktop).
  2. Double-click start.bat. If Python isn't installed, get it from python.org and tick "Add python.exe to PATH".

Flask installs itself on first run, and your browser opens automatically to http://127.0.0.1:5000. Requires Python 3.8+. Leave the launcher window open while using the app.

Highlights

  • 108 business categories across 111 countries (India intentionally excluded and enforced server-side).
  • Instant, offline town lists for major markets (US, UK, Germany, France, Italy, Spain, Canada, Australia, Ireland, New Zealand, Netherlands, UAE); any other country is fetched live once, then cached.
  • Three search modes — no website at all / dead, insecure, parked or non-mobile site / both.
  • Permanently-closed shops filtered out; owner/operator name and a data-freshness signal surfaced where available.
  • Live link verification of Instagram, Facebook and website links (✓ live / ✗ broken / unverified).
  • Lead scoring by how easily you can actually reach a business.
  • Four ready-to-send messages per lead — social DM, cold email, cold-call script with objection handling, and a follow-up — with prices auto-adjusted by country.
  • Optional AI rewrite (bring your own OpenAI or Anthropic key, pasted in-app) with silent template fallback.
  • Business Brief in quick (local) or AI mode, ending in a paste-ready prompt for any AI website builder.
  • Shortlist + pipeline (New → Contacted → Replied → Won / Lost), rich filters, and CSV export. Everything persists in a local SQLite leads.db.

Why OpenStreetMap, not Google scraping

Google's Terms prohibit automated scraping and its CAPTCHAs kill such scrapers in real use. OpenStreetMap is free, legal to reuse (ODbL), globally covered, and — crucially — structured, so "has no website" is an exact filter rather than a guess.

Privacy

Runs locally. The only outbound calls are to OpenStreetMap and — only if you add a key — your chosen AI provider. No telemetry, no accounts; config.json and leads.db never leave your machine.

Code: MIT License · © 2026 Agrajeet Verma
Map data: © OpenStreetMap contributors, ODbL
Document - leadfinder.ripplecheck.io/docs.html

Assets 3
Loading