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.

What it is

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.

Real numbers, not promises

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

Install your AI lead researcher now, and get qualified leads right away.

1

1 · Open your AI tool — Claude Code, Codex CLI, or OpenCode — in any empty folder.

2

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

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

Daily use

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

Read the full method

Just need leads?

Take the worker. Free, open source, MIT licensed — no account, no server, no strings.

Get Lead Researcher on GitHub

Want 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.

Apply — Free Review

Free review · No required call · See the scope before you pay