LinkedIn & X Lead Research Automation · Free · Open Source
Qualified prospects on LinkedIn & X.
Your AI finds them. Nonstop.
This open-source worker researches real people from public profiles and posts, checks each against your ICP, captures the recent signal that makes them hot, and records only the ones that pass the gate — batch after batch until your target is met. It never sends messages. You decide who to contact.
Runs inside your AI coding tool. Your prospect data never leaves your machine.
The same worker pattern that runs SpielOS's own outbound department right now.
One worker. One job. One number.
Social Lead Researcher turns any AI coding assistant into a persistent social-selling research employee.
Hot, not scraped
Every prospect must carry a recent public signal — a post, comment, launch, or hiring moment from the last ~90 days. That single rule separates a warm outreach list from a cold database.
Research only. Contact is yours.
The engine has no send capability at all. It reads public information and records people with evidence. Who to contact, when, and how — always your decision.
A quality gate that can't be sweet-talked
Score above your bar, cite your ICP file, provide a real profile URL and a recent signal — or the engine refuses to count it toward the target.
Install your social prospecting researcher now, and build a warm list 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/Social-Lead-Researcher following its AGENTS.md, then help me write my icp.md, and start finding social prospects on LinkedIn and X until we hit my target.
Copied!
3 · Then just talk to it.
Works with
Prefer the terminal? One command does it all:
curl -fsSL https://raw.githubusercontent.com/ShayanSpiel/Social-Lead-Researcher/main/install.sh | bash
Then just talk to it.
After install, the worker understands plain instructions:
"Continue finding prospects until the target is met."
Resumes from saved progress and keeps working.
"How many prospects so far?"
A progress report with the LinkedIn / X split.
"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 prospects."
Writes prospects.csv sorted by score — signals intact, ready for outreach.
No AI needed to check progress: python3 sr.py status
Just need prospects?
Take the worker. Free, open source, MIT licensed — no account, no server, no strings.
Get Social Lead Researcher on GitHubWant the whole outbound department running like this?
Social prospecting 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