Leadlantern
a lead finder for agencies, on your own server.
Leadlantern helps a small agency find local businesses, look at their public website, see which ones could use the service the agency sells, and write a first message that a person reads and sends. It runs as one Node.js program with one SQLite database on your own server. Read these pages in order the first time; after that, press / and search.
01What you bought
In plain words: you tell Leadlantern "dentists in Leeds". It lists the dentists it finds in OpenStreetMap (or in Google Places with your own key), opens each one's public website when you ask, writes down what the site has and what it lacks, and gives each business a score for the service you sell, with the reasons in plain sentences. From those reasons it drafts a first e-mail or a call script. You read it, change it and send it, one message at a time.
- Find local businesses of one type in one area (Finding businesses).
- Check a business's public website: secure connection, phone layout, booking, statistics, speed.
robots.txtis respected (The website check). - Score the business for the service you sell, with reasons (Scoring).
- Write a first e-mail or call script from those reasons, by template or with your own AI key (Writing and sending).
- Send one message per click, with your name, your postal address and an unsubscribe link (Send rules).
- Follow the business through the pipeline to a signed client (Pipeline).
Leadlantern is not a map scraper and not a bulk e-mail tool. There are no sequences, no automatic follow-ups, no warm-up and no mailbox rotation. Every e-mail is one person's click, checked by the server first.
02What is in the package
| Part | Folder | What it is |
|---|---|---|
| Server | src/ | Node.js and TypeScript (Hono web framework). Searches, website checks, scoring, drafts, sending, the report and unsubscribe pages. pnpm build compiles it to dist/. |
| Console pages | src/web/, public/ | Today, Find businesses, Leads, Pipeline, Messages, Do not contact. |
| Operator console | packages/admin-kit/ | Settings, write-only keys, team and roles, audit log, status checks, export and import (the MIKODES Admin Kit, part of this item). |
| Tests | test/ | pnpm test runs offline and needs no keys. |
| Configuration template | .env.example | Copied to .env (every variable). |
| Text guides | README.md, docs/installation.md, CHANGELOG.md | Short versions of these pages, inside the source. |
03Pick your path
04What you provide
A server with a domain and https. Optional services you connect yourself bill you directly under their own terms: Google Places API, Google PageSpeed Insights API, an AI provider and Resend for e-mail. OpenStreetMap needs no account, but its public servers are shared by everyone (Third-party services). No key ships with this code.
Leadlantern adds your name, your postal address and an unsubscribe link to every e-mail and enforces sending limits, but the rules for writing to businesses differ by country. These pages are not legal advice. Check the rules where you and the businesses are.
05One agency per installation
One installation serves one agency and its team. There are no tenants, no client accounts and no billing of clients inside Leadlantern. The interface is in English.