Skip to content
rafath11Public

About

One line per lead, a monthly report by source — simple lead tracking for small businesses. Zero-dependency Python.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

leadlog

A tiny lead-source tracker for small businesses. Your ad dashboard says you got zero leads last week — but you booked two jobs from that very ad. The person answering the phone knows the truth. leadlog makes capturing it take ten seconds, and turns it into a monthly report you can trust.

Built for a moving-company owner who asked his customers "how did you find me?" after every call and wrote the answers in a notebook. This is that notebook, minus the paper.

What it does

  • Log one lead in one line: source, booked or not, job value, a note.
  • Monthly report by source: leads, bookings, booking rate, booked dollars.
  • Your data stays in a plain CSV file (leads.csv) that you own. No account, no subscription, no platform.

Quick start

# Someone calls from your Facebook ad and books a $450 job:
python3 leadlog.py add --source "Facebook ad" --booked yes --value 450

# A Google caller who doesn't book:
python3 leadlog.py add --source "Google search" --booked no

# End of month — where did customers actually come from?
python3 leadlog.py report
python3 leadlog.py report --month 2026-10

Example report:

Lead report — 2026-11
Source                    Leads  Booked   Booked $
--------------------------------------------------
Facebook ad                   2       1     450.00
Google search                 1       1     300.00
--------------------------------------------------
TOTAL                         3       2     750.00
Booking rate: 67%  (2 of 3 leads)

Compare this with what your ad dashboard claims. The phone log wins.

Requirements

Python 3.8+. Zero dependencies — nothing to install.

Why

Ad platforms measure what they can see. They can't see the customer who saw your ad, closed the app, and called you directly — so they report zero while your schedule fills up. Ten seconds of logging per call gives you the ground truth to judge every marketing dollar against.

License

MIT — free to use, copy, and adapt.

About

One line per lead, a monthly report by source — simple lead tracking for small businesses. Zero-dependency Python.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages