Skip to content

Atum246/keelead

BranchesTags

Repository files navigation

KeeLead Logo

⚡ KeeLead

Find leads. Verify emails. Research companies. Close deals.

A free, open-source, self-hosted lead generation platform powered by AI with 62 data sources.

Features • Quick Start • Data Sources • Configuration • API Keys Guide • Docker • Architecture • Contributing

🆓 Why KeeLead?

Problem KeeLead Solution
💰 ZoomInfo costs $15K+/yr, Apollo $49-149/mo 100% Free — MIT licensed, use forever
🔒 Closed source, vendor lock-in Open source — full code, modify anything
🚫 Rate limits, artificial caps Self-hosted — your data, your limits
🤷 No AI integration AI-native — MCP server, function calling
📊 Need 5+ tools for lead gen All-in-one — 62 sources in one tool

✨ Features

🔍 62 Data Sources

  • 35 FREE sources — No API key required, works out of the box!
  • 27 premium sources — Optional API keys for enhanced data
  • Categories: Search, Professional, Company, Local Business, Social Media, Developer, Startup, Government, Education, Email, Events

💬 AI Chat Interface

  • ChatGPT/Claude-style natural language interface
  • Ask: "Find me 50 SaaS founders in San Francisco"
  • Multi-provider: OpenAI, Claude, Ollama, Groq, Mistral, NVIDIA, OpenRouter
  • Streaming responses with markdown, tables, and code blocks

📧 10-Layer Email Verification

  • Syntax validation (RFC 5322)
  • Domain existence & MX record verification
  • Disposable email detection (10K+ domain blocklist)
  • SMTP verification, catch-all detection, spam trap detection
  • Score 0-100 with detailed breakdown

🗺️ OpenStreetMap Local Business Search

  • FREE worldwide coverage — no API key needed!
  • Search: "restaurants in London", "dentists in Tokyo", "plumbers near Berlin"
  • 40+ business type mappings
  • Extracts: names, phones, emails, addresses, hours

🤖 Browser Automation

  • Playwright-powered headless browser
  • Scrape JavaScript-heavy sites
  • Form filling, screenshots, infinite scroll
  • Utility functions for tables, lists, cards

📊 Dashboard & Management

  • 15+ pages with full dark theme
  • Lead management with AI scoring (0-100)
  • Kanban pipeline board
  • Campaign management with drip sequences
  • Analytics & reporting
  • Export in 7 formats (CSV, JSON, Excel, vCard, PDF, XML, YAML)

🛡️ Compliance

  • GDPR tools, CAN-SPAM compliance
  • Do-Not-Contact list management
  • Audit logs, consent management

🚀 Quick Start

# Clone the repository
git clone https://github.com/Atum246/keelead.git
cd keelead

# Install dependencies
npm install

# Set up database
npx prisma db push

# Seed with demo data (optional)
npx tsx prisma/seed.ts

# Start development server
npm run dev

Open http://localhost:3000 🎉

What Works Immediately (No API Keys!)

  • ✅ 35 free data sources (OpenStreetMap, SEC EDGAR, GitHub, Reddit, etc.)
  • ✅ Email verification (DNS, MX, SMTP checks)
  • ✅ Full dashboard & lead management
  • ✅ Export in 7 formats
  • ✅ Compliance tools

What Needs API Keys

  • 🤖 AI chat (at least one provider needed)
  • 🔍 Premium search (Google, Bing, Brave)
  • 📱 Social media (Twitter, Instagram, etc.)
  • 💼 Premium data (Crunchbase, Hunter.io, etc.)

📦 Data Sources (62 Total)

✅ FREE Sources (35) — No API Key Required

🔍 Search (2)

Source API Description
DuckDuckGo api.duckduckgo.com Instant Answer API, company info
SearXNG 7 public instances Meta search (Google + Bing + DuckDuckGo)

💼 Professional (1)

Source API Description
LinkedIn Google search proxy Profile discovery via search engines

🏢 Company (4)

Source API Description
SEC EDGAR efts.sec.gov US public company filings, officers
OpenCorporates api.opencorporates.com 140+ country company registries
Companies House UK gov API UK company registry
Builtin Scraping Tech company directory

📍 Local Business (4)

Source API Description
OpenStreetMap overpass-api.de FREE worldwide business data!
Yellow Pages Scraping US business directory
BBB Scraping Business ratings & reviews
Chamber of Commerce Scraping Local business directories

📱 Social (2)

Source API Description
GitHub api.github.com Developer profiles (60 req/hr free)
Reddit reddit.com/search.json User profiles & communities

👨‍💻 Developer (5)

Source API Description
NPM registry.npmjs.org Package authors & maintainers
PyPI pypi.org/pypi Python package authors
Docker Hub hub.docker.com/v2 Container image publishers
Dev.to dev.to/api Developer community profiles
Stack Overflow api.stackexchange.com Developer Q&A profiles
GitHub Orgs api.github.com Company organizations

🚀 Startup (2)

Source API Description
Indie Hackers Scraping Indie founder profiles
Beta List Scraping Startup directory

🏛️ Government (6)

Source API Description
USASpending api.usaspending.gov Federal contractors & spending
US Census api.census.gov Business patterns by industry
EU Register Scraping EU transparency register
SAM.gov US gov API Government contractors
USPTO Patents api.patentsview.org Patent inventors & holders
USPTO Trademarks developer.uspto.gov Trademark owners

🎓 Education (4)

Source API Description
Google Scholar Scraping Academic researchers & papers
ResearchGate Scraping Researcher profiles
ORCID pub.orcid.org Researcher IDs & affiliations
Academia.edu Scraping Academic profiles

📧 Email/Domain (3)

Source API Description
DNS Lookup dns.google/resolve MX records, email provider detection
SSL Certificate crt.sh Certificate Transparency logs
WHOIS rdap.org Domain registration data

🎤 Events (1)

Source API Description
Conference Speakers PaperCall + Sessionize Speaker profiles & talks

💰 Premium Sources (27) — API Keys Required

🔍 Search (3)

Source Free Tier Get Key
Google Custom Search 100/day Google Cloud Console
Bing Web Search 1,000/month Azure Portal
Brave Search 2,000/month Brave Search API

📱 Social Media (7)

Source Free Tier Get Key
Twitter/X Very limited Developer Portal
Instagram Requires app review Meta for Developers
Facebook Requires app review Meta for Developers
TikTok Requires approval TikTok for Developers
YouTube 10,000 units/day Google Cloud Console
Pinterest Requires approval Pinterest Developers

💼 Professional (3)

Source Free Tier Get Key
Crunchbase Limited Crunchbase API
AngelList Restricted Wellfound API
Xing Partner only Xing Developer

🏢 Company (3)

Source Free Tier Get Key
Glassdoor No public API N/A
Indeed No public API N/A
G2 No public API N/A

📍 Local Business (5)

Source Free Tier Get Key
Google Maps $200/month credit Google Cloud Console
Yelp 5,000/day Yelp Fusion
Foursquare 100K free Foursquare Developer
Thumbtack No public API N/A
HomeAdvisor No public API N/A

📧 Email (2)

Source Free Tier Get Key
Hunter.io 25/month Hunter.io
Clearbit Limited Clearbit

🚀 Startup (3)

Source Free Tier Get Key
Product Hunt GraphQL API Product Hunt API
F6S API available F6S API
Gust Partner access Gust API

🎤 Events (3)

Source Free Tier Get Key
Eventbrite Free tier Eventbrite API
Meetup GraphQL API Meetup API
Luma API available Luma API

⚙️ Configuration

Environment Variables

Copy .env.example to .env and configure:

cp .env.example .env

🤖 AI Providers (At Least One Required for Chat)

# OpenAI — Best overall quality
OPENAI_API_KEY=sk-...

# Anthropic Claude — Great for analysis
ANTHROPIC_API_KEY=sk-ant-...

# OpenRouter — Access to ALL models with one key
OPENROUTER_API_KEY=sk-or-...

# Ollama — FREE local AI (no API key!)
OLLAMA_BASE_URL=http://localhost:11434

# NVIDIA NIM — Free tier available
NVIDIA_API_KEY=nvapi-...

# Groq — Ultra-fast inference
GROQ_API_KEY=gsk_...

# Mistral — European AI
MISTRAL_API_KEY=...

🔍 Search APIs (Optional — Enhances Search Results)

GOOGLE_SEARCH_API_KEY=...
GOOGLE_SEARCH_CX=...
BING_SEARCH_API_KEY=...
BRAVE_SEARCH_API_KEY=...

📧 Email & Data Enrichment (Optional)

HUNTER_API_KEY=...
CLEARBIT_API_KEY=...

🔔 Notifications (Optional)

SLACK_WEBHOOK_URL=...
DISCORD_WEBHOOK_URL=...

🔑 API Keys Guide

Tier 1: Start Here (Free & Essential)

  1. Ollama (FREE local AI)

    # Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# Pull a model
ollama pull llama3.1
# KeeLead auto-detects it at http://localhost:11434

  2. OpenRouter (Access to 100+ models, pay-as-you-go)

    • Go to openrouter.ai
    • Create account → Get API key
    • Add to .env: OPENROUTER_API_KEY=sk-or-...

Tier 2: Enhance Search (Optional)

  1. Google Custom Search (100 free/day)

  2. Brave Search (2,000 free/month)

Tier 3: Premium Data (Optional)

  1. Hunter.io (25 free/month)

    • Go to hunter.io
    • Create account → Get API key
    • Add to .env: HUNTER_API_KEY=...

  2. Yelp Fusion (5,000 free/day)

    • Go to fusion.yelp.com
    • Create app → Get API key
    • Add to .env: YELP_API_KEY=...

  3. Google Maps ($200 free credit/month)

🐳 Docker

Quick Start

docker-compose up -d

Manual Build

docker build -t keelead .
docker run -p 3000:3000 keelead

With Environment Variables

docker run -p 3000:3000 \
  -e OPENAI_API_KEY=sk-... \
  -e DATABASE_URL=file:./prisma/keelead.db \
  keelead

🏗️ Architecture

keelead/
├── app/                    # Next.js App Router
│   ├── api/               # API routes
│   │   ├── chat/          # AI chat endpoint
│   │   ├── leads/         # Lead CRUD
│   │   ├── verify/        # Email verification
│   │   ├── sources/       # Data source management
│   │   ├── export/        # Export endpoints
│   │   └── ...
│   ├── chat/              # Chat UI
│   └── dashboard/         # Dashboard pages
├── lib/
│   ├── sources/           # 62 data source plugins
│   │   ├── search/        # Search engines
│   │   ├── professional/  # LinkedIn, Crunchbase, etc.
│   │   ├── company/       # SEC EDGAR, OpenCorporates, etc.
│   │   ├── local/         # OpenStreetMap, Yelp, etc.
│   │   ├── social/        # GitHub, Reddit, etc.
│   │   ├── developer/     # NPM, PyPI, Stack Overflow, etc.
│   │   ├── startup/       # Indie Hackers, Beta List, etc.
│   │   ├── government/    # USASpending, Census, Patents, etc.
│   │   ├── education/     # Google Scholar, ORCID, etc.
│   │   ├── email/         # DNS, WHOIS, SSL, etc.
│   │   ├── events/        # Conference speakers, etc.
│   │   ├── base.ts        # Base source class
│   │   ├── types.ts       # Type definitions
│   │   └── index.ts       # Source manager
│   ├── browser/           # Playwright browser automation
│   │   ├── index.ts       # BrowserAutomation class
│   │   └── scraping-utils.ts
│   ├── ai/                # AI provider abstraction
│   ├── agent/             # AI agent & function calling
│   ├── email/             # Email verification engine
│   └── ...
├── prisma/                # Database schema
├── mcp/                   # MCP server
├── cli/                   # CLI tool
└── components/            # React components

Tech Stack

  • Frontend: Next.js 14, React, TypeScript, Tailwind CSS
  • Backend: Next.js API Routes, Prisma ORM
  • Database: SQLite (easily switch to PostgreSQL)
  • AI: Multi-provider (OpenAI, Claude, Ollama, Groq, etc.)
  • Browser: Playwright for automation
  • License: MIT

🤖 AI Agent Integration

MCP Server

KeeLead includes a built-in MCP (Model Context Protocol) server for AI agent integration.

# Start MCP server
npm run mcp

Function Calling

AI agents can use these tools:

  • keelead_search_leads — Search across 62 data sources
  • keelead_verify_email — 10-layer email verification
  • keelead_research_company — Deep company research
  • keelead_find_contact — Find contact information
  • keelead_enrich_lead — Enrich lead data

📤 Export Formats

Export leads in 7 formats:

  • CSV — Spreadsheet compatible
  • JSON — Developer-friendly
  • Excel (XLSX) — Microsoft Excel
  • vCard — Contact import
  • PDF — Reports & presentations
  • XML — Enterprise integration
  • YAML — Configuration-friendly

🛡️ Security

  • All API keys stored encrypted
  • Self-hosted — your data never leaves your server
  • No telemetry or tracking
  • GDPR & CAN-SPAM compliant tools
  • Audit logging for all actions

🗺️ Roadmap

v2.0 ✅ (Current)

  • 62 data sources (35 free + 27 premium)
  • AI chat interface with multi-provider support
  • 10-layer email verification
  • OpenStreetMap local business search
  • Browser automation with Playwright
  • Dashboard with 15+ pages
  • Campaign management
  • Pipeline (Kanban)
  • Export in 7 formats
  • Compliance tools

v2.1 (Next)

  • Browser extension (Chrome/Firefox)
  • Real-time collaboration
  • Voice interface (speech-to-text)
  • Mobile app (React Native)
  • CRM integrations (HubSpot, Salesforce)
  • Webhook triggers
  • Plugin marketplace

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Adding a New Data Source

  1. Create a file in lib/sources/{category}/your-source.ts
  2. Extend BaseSource class
  3. Implement search(), optionally getCompany() and getContact()
  4. Register in lib/sources/index.ts
  5. Submit a PR!

📄 License

MIT License — see LICENSE

🙏 Acknowledgments

Made with ⚡ by the KeeLead community

About

⚡ KeeLead - Open Source AI-Powered Lead Generation Engine. 62 data sources, ChatGPT-style interface, email verification, company research, MCP server for AI agents. Free forever.

Topics

open-source sales automation typescript ai mcp nextjs b2b email-verification lead-generation data-enrichment tailwindcss prospecting chatgpt company-research

Resources

Readme

License

MIT license

Contributing

Contributing
Activity

Stars

5 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages