AI Lead Generation Automation · Free · Open Source
This AI lead researcher got me
2,000 leads over one weekend!
Not a demo, not a waitlist — and completely free. This is the open-source worker that fills SpielOS's own sales pipeline. Tell it your target and who counts as a lead; it researches real people on the public web, qualifies each one against your ICP, and keeps going until the number is met.
Runs inside your AI coding tool. Your data never leaves your machine.
The same worker pattern that runs SpielOS's own outbound pipeline.
One worker. One job. One number.
Lead Researcher is a small open-source repo that turns any AI coding assistant into a persistent sales-research employee.
A target that survives restarts
"Find me 2000 leads" is stored on disk, not in chat memory. Close your laptop, come back tomorrow, say "continue" — it picks up exactly where it left off.
A quality gate that can't be sweet-talked
Every lead must cite your ICP file as evidence and score above your bar. Duplicates, guessed emails, and vague fits are rejected by the engine — not by trust.
An ICP you edit in plain English
Who counts as a lead lives in one human-readable file. Edit it yourself, or tell your agent "update my ICP" — every future decision follows the new rules.
It already did the work. Here's the receipt.
Live totals from SpielOS's own outbound runtime — powered by this exact worker.
3,098
Qualified leads researched
2,000
Leads in its first weekend
1,093
Emails sent from the pool
534
Opened
298 Clicked
Install your AI lead researcher now, and get qualified leads right away.
1 · Open your AI tool — Claude Code, Codex CLI, or OpenCode — in any empty folder.
2 · Paste this prompt
Install https://github.com/ShayanSpiel/Lead-Researcher following its AGENTS.md, then help me write my icp.md, and start finding leads until we hit my target.
Copied!
3 · Then just talk to it.
Prefer the terminal? One command does it all:
curl -fsSL https://raw.githubusercontent.com/ShayanSpiel/Lead-Researcher/main/install.sh | bash
Then just talk to it.
After install, the worker understands plain instructions:
"Continue finding leads until the target is met."
Resumes from saved progress and keeps working.
"How many leads so far?"
A progress report against your target.
"Update my ICP: we also sell to Series B fintech ops leaders."
Rewrites your ICP file, confirms with you, continues under the new rules.
"Export my leads."
Writes leads.csv — ready for Excel, Sheets, or your CRM.
No AI needed to check progress: python3 lr.py status
Just need leads?
Take the worker. Free, open source, MIT licensed — no account, no server, no strings.
Get Lead Researcher on GitHubWant every department running like this?
Lead research is one worker in one department of a SpielOS-run company. We build these systems around your business — you see the scope before you pay.
Free review · No required call · See the scope before you pay