Metadata-Version: 2.4
Name: heylead
Version: 0.1.1
Summary: MCP-native autonomous LinkedIn SDR. Your AI sales rep, one command to fill your pipeline.
Project-URL: Homepage, https://github.com/D4umak/heylead
Project-URL: Repository, https://github.com/D4umak/heylead
Project-URL: Issues, https://github.com/D4umak/heylead/issues
Author-email: HeyLead <hello@heylead.dev>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,leads,linkedin,mcp,outreach,sales,sdr
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Requires-Dist: click>=8.0.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: mcp<2.0.0,>=1.2.0
Description-Content-Type: text/markdown

# 🎯 HeyLead

**Your AI sales rep. One command to fill your pipeline.**

HeyLead is an MCP-native autonomous LinkedIn SDR that runs in your terminal. No dashboard. No web app. Just chat.

> ⚠️ **Alpha** — Under active development. `setup_profile` is live. Other tools coming soon.

## Quick Start

```bash
# Add to Claude Code (recommended — runs in isolated environment)
claude mcp add heylead -- uvx heylead

# Or add to Cursor (isolated environment)
# Settings → MCP → Add: command "uvx heylead"

# Then ask your AI assistant:
# "Set up my LinkedIn profile"
# "Find me CTOs at fintech startups"
# "How's my outreach?"
```

> **Note:** Use `uvx heylead` (recommended) or `pipx install heylead` for an isolated install.
> Direct `pip install heylead` may conflict with existing FastAPI installations due to starlette version requirements.

## What It Does

HeyLead gives you 5 tools in your AI assistant:

| Tool | What it does |
|------|-------------|
| `setup_profile` | Analyzes YOUR LinkedIn profile and creates a voice signature — so messages sound like you |
| `create_campaign` | Takes "find me fintech CTOs" and creates a targeted outreach campaign |
| `generate_and_send` | Generates personalized invitations and sends them (or queues for your review) |
| `check_replies` | Checks for new replies, classifies sentiment, surfaces hot leads 🔥 |
| `show_status` | Your dashboard — stats, acceptance rates, hot leads, account health |

## How It Works

1. **You describe your target** → "Find me freelance consultants who need scheduling tools"
2. **HeyLead finds them** → Searches LinkedIn, scores prospects, builds a campaign
3. **AI writes personalized messages** → Sounds like YOU (voice matching), not a bot
4. **Copilot mode** → Review first 10 messages, then switch to Autopilot
5. **You get replies** → HeyLead surfaces hot leads: "🔥 Sarah Chen said: Let's chat!"

## Requirements

- Python 3.10+
- Claude Code or Cursor (any MCP-compatible AI assistant)
- LinkedIn account (free tier works)
- Gemini API key (free at [aistudio.google.com](https://aistudio.google.com/apikey))

## Pricing

| Plan | Price | What you get |
|------|-------|-------------|
| **Free** | $0 | 50 invitations/mo, 1 campaign, cookie auth |
| **Pro** | $29/mo | Unlimited, Unipile auth, follow-ups, RAG knowledge base |

## Privacy

All your data stays on YOUR machine:
- Contacts → local SQLite
- Messages → local SQLite
- LinkedIn cookie → encrypted locally (AES-256)
- AI processing → goes directly to your LLM provider
- We receive → nothing

## Links

- 🌐 [heylead.dev](https://heylead.dev)
- 📦 [PyPI](https://pypi.org/project/heylead/)
- 🐛 [Issues](https://github.com/D4umak/heylead/issues)
- 💬 Discord (coming soon)

## License

MIT (code) — see [LICENSE](LICENSE)

Knowledge base and prompt configurations are proprietary.
