heylead 0.1.0__tar.gz

heylead-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# HeyLead local data (never commit user data)
+.heylead/
+
+# Environment / secrets
+.env
+.env.*
+*.enc
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Distribution
+*.tar.gz
+*.zip

heylead-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HeyLead
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

heylead-0.1.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: heylead
+Version: 0.1.0
+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[cli]>=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
+# Install
+pip install heylead
+
+# Add to Claude Code
+claude mcp add heylead -- uvx heylead
+
+# Then ask Claude:
+# "Set up my LinkedIn profile"
+# "Find me CTOs at fintech startups"
+# "How's my outreach?"
+```
+
+## 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/heylead-ai/mcp-server/issues)
+- 💬 Discord (coming soon)
+
+## License
+
+MIT (code) — see [LICENSE](LICENSE)
+
+Knowledge base and prompt configurations are proprietary.

heylead-0.1.0/README.md

@@ -0,0 +1,78 @@
+# 🎯 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
+# Install
+pip install heylead
+
+# Add to Claude Code
+claude mcp add heylead -- uvx heylead
+
+# Then ask Claude:
+# "Set up my LinkedIn profile"
+# "Find me CTOs at fintech startups"
+# "How's my outreach?"
+```
+
+## 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/heylead-ai/mcp-server/issues)
+- 💬 Discord (coming soon)
+
+## License
+
+MIT (code) — see [LICENSE](LICENSE)
+
+Knowledge base and prompt configurations are proprietary.

heylead-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "heylead"
+version = "0.1.0"
+description = "MCP-native autonomous LinkedIn SDR. Your AI sales rep, one command to fill your pipeline."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "HeyLead", email = "hello@heylead.dev" },
+]
+keywords = ["mcp", "linkedin", "outreach", "sdr", "leads", "sales", "ai"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business",
+]
+dependencies = [
+    "mcp[cli]>=1.2.0",
+    "httpx>=0.24.0",
+    "cryptography>=41.0.0",
+    "click>=8.0.0",
+]
+
+[project.scripts]
+heylead = "heylead.server:main"
+
+[project.urls]
+Homepage = "https://github.com/D4umak/heylead"
+Repository = "https://github.com/D4umak/heylead"
+Issues = "https://github.com/D4umak/heylead/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/heylead"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

heylead-0.1.0/src/heylead/__init__.py

@@ -0,0 +1,3 @@
+"""HeyLead — MCP-native autonomous LinkedIn SDR."""
+
+__version__ = "0.1.0"

heylead-0.1.0/src/heylead/__main__.py

@@ -0,0 +1,97 @@
+"""HeyLead CLI entry point.
+
+This module allows running HeyLead as:
+    python -m heylead          # Start MCP server
+    python -m heylead init     # First-time setup
+    python -m heylead version  # Show version
+    python -m heylead reset    # Delete all data
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+def main() -> None:
+    """CLI router — simple arg parsing without pulling in click for MCP mode."""
+    args = sys.argv[1:]
+
+    if not args:
+        # Default: start MCP server
+        from .server import main as serve
+        serve()
+        return
+
+    cmd = args[0].lower()
+
+    if cmd == "version" or cmd == "--version" or cmd == "-v":
+        from . import __version__
+        print(f"HeyLead v{__version__}")
+
+    elif cmd == "init":
+        from . import config
+        config.ensure_dirs()
+        cfg = config.load_config()
+        print("✅ HeyLead initialized!")
+        print(f"   Config: {config.config_path()}")
+        print(f"   Database: {config.db_path()}")
+        print(f"   Logs: {config.log_path()}")
+        print()
+        print("Next steps:")
+        print("1. Add your credentials to ~/.heylead/config.json:")
+        print('   "unipile_api_url": "https://apiXX.unipile.com:XXXXX"')
+        print('   "unipile_api_key": "YOUR_UNIPILE_API_KEY"')
+        print('   "api_keys": { "gemini": "YOUR_GEMINI_KEY" }')
+        print("   (Get a free Gemini key at: https://aistudio.google.com/apikey)")
+        print("2. Add HeyLead to Claude Code:")
+        print("   claude mcp add heylead -- python -m heylead")
+        print("3. Then ask Claude: 'Set up my LinkedIn profile'")
+
+    elif cmd == "reset":
+        confirm = input("⚠️  This will delete ALL HeyLead data. Continue? (yes/no): ")
+        if confirm.strip().lower() == "yes":
+            from . import config
+            from .db.schema import reset_db
+            import shutil
+
+            reset_db()
+
+            # Remove legacy cookie file if it exists
+            cookie_path = config.cookie_path()
+            if cookie_path.exists():
+                cookie_path.unlink()
+
+            # Remove config
+            cfg_path = config.config_path()
+            if cfg_path.exists():
+                cfg_path.unlink()
+
+            # Remove logs
+            log_dir = config._heylead_home() / "logs"
+            if log_dir.exists():
+                shutil.rmtree(log_dir)
+
+            print("✅ All HeyLead data deleted.")
+        else:
+            print("Cancelled.")
+
+    elif cmd == "help" or cmd == "--help" or cmd == "-h":
+        print("HeyLead — MCP-native autonomous LinkedIn SDR")
+        print()
+        print("Usage:")
+        print("  heylead            Start the MCP server (stdio transport)")
+        print("  heylead init       Initialize HeyLead (create config + dirs)")
+        print("  heylead version    Show version")
+        print("  heylead reset      Delete all data")
+        print()
+        print("Add to Claude Code:")
+        print("  claude mcp add heylead -- python -m heylead")
+
+    else:
+        print(f"Unknown command: {cmd}")
+        print("Run 'heylead help' for usage.")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

heylead-0.1.0/src/heylead/ai/__init__.py

@@ -0,0 +1 @@
+"""HeyLead AI layer — LLM clients, voice analysis, message generation."""

heylead-0.1.0/src/heylead/ai/icp_generator.py

@@ -0,0 +1,136 @@
+"""ICP (Ideal Customer Profile) generator.
+
+Takes a natural language target description like "fintech CTOs" and
+generates a structured ICP with LinkedIn search parameters.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+from typing import Any
+
+from .llm import LLMClient
+
+logger = logging.getLogger(__name__)
+
+ICP_SYSTEM = """You are an expert B2B sales strategist. You convert natural language descriptions of target customers into structured Ideal Customer Profiles (ICPs) with LinkedIn search parameters.
+
+You are precise and output structured JSON only."""
+
+ICP_PROMPT = """Convert this target description into a structured ICP with LinkedIn search parameters.
+
+## TARGET DESCRIPTION
+"{target_description}"
+
+## USER CONTEXT (their profile)
+Name: {user_name}
+Title: {user_title}
+Company: {user_company}
+Expertise: {user_expertise}
+
+## TASK
+Generate a structured ICP that can be used to search LinkedIn. Include:
+
+1. **ICP Summary**: One-line description of the ideal customer
+2. **Search Parameters**: LinkedIn search filters
+3. **Segments**: 1-3 target segments (from most to least specific)
+4. **Relevance Hook**: Why the user (above) would be credible reaching out to this audience
+5. **Campaign Name**: Auto-generate a short campaign name if not provided
+
+Each segment should have:
+- `keywords`: LinkedIn search keywords (comma-separated)
+- `titles`: Job titles to target (list)
+- `seniority`: Seniority levels (list from: owner, partner, cxo, vp, director, manager, senior, entry)
+- `industries`: LinkedIn industries (list)
+- `company_size`: Company sizes (list from: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+)
+- `geography`: Regions/countries (list, or empty for global)
+- `estimated_results`: Rough estimate of how many LinkedIn results this would yield
+
+## RESPONSE FORMAT
+Return ONLY valid JSON (no markdown, no explanation):
+{{
+    "summary": "...",
+    "campaign_name": "...",
+    "relevance_hook": "...",
+    "segments": [
+        {{
+            "name": "Primary",
+            "keywords": "...",
+            "titles": ["CTO", "VP Engineering"],
+            "seniority": ["cxo", "vp", "director"],
+            "industries": ["Financial Services", "Fintech"],
+            "company_size": ["11-50", "51-200"],
+            "geography": [],
+            "estimated_results": "200-500"
+        }}
+    ]
+}}"""
+
+
+async def generate_icp(
+    target_description: str,
+    user_profile: dict[str, Any] | None = None,
+) -> dict[str, Any]:
+    """Generate an ICP from a natural language target description.
+
+    Args:
+        target_description: e.g., "CTOs at fintech startups", "yoga studio owners in California"
+        user_profile: The user's own profile data (for relevance hook)
+
+    Returns:
+        Structured ICP dict with search parameters.
+    """
+    user_name = ""
+    user_title = ""
+    user_company = ""
+    user_expertise = ""
+
+    if user_profile:
+        user_name = user_profile.get("name", "")
+        user_title = user_profile.get("title", "")
+        user_company = user_profile.get("company", "")
+        user_expertise = user_profile.get("core", user_profile.get("headline", ""))
+
+    prompt = ICP_PROMPT.format(
+        target_description=target_description,
+        user_name=user_name or "Unknown",
+        user_title=user_title or "Founder",
+        user_company=user_company or "Unknown",
+        user_expertise=user_expertise or "Not specified",
+    )
+
+    client = LLMClient()
+    raw = await client.generate(prompt, system=ICP_SYSTEM, temperature=0.4)
+
+    # Parse JSON
+    cleaned = raw.strip()
+    if cleaned.startswith("```"):
+        lines = cleaned.split("\n")
+        cleaned = "\n".join(
+            line for line in lines if not line.strip().startswith("```")
+        )
+
+    try:
+        result = json.loads(cleaned)
+    except json.JSONDecodeError:
+        logger.warning("Failed to parse ICP JSON, building minimal structure")
+        result = {
+            "summary": f"Target: {target_description}",
+            "campaign_name": target_description[:30],
+            "relevance_hook": "",
+            "segments": [
+                {
+                    "name": "Primary",
+                    "keywords": target_description,
+                    "titles": [],
+                    "seniority": [],
+                    "industries": [],
+                    "company_size": [],
+                    "geography": [],
+                    "estimated_results": "Unknown",
+                }
+            ],
+        }
+
+    return result