🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Contact Finder
πŸ¦€ ClawHub

Contact Finder

by @mrnsmh

Find professional emails and contacts from a name + company/domain using SerpAPI + OpenAI GPT-4o-mini.

Versionv0.1.0
Downloads644
#seo#legal#automation#communication
TERMINAL
clawhub install openclaw-skill-contact-finder

πŸ“– About This Skill

name: contact-finder description: Find professional emails and contacts from a name + company/domain using SerpAPI + OpenAI GPT-4o-mini. license: MIT metadata: author: Jack2 version: 1.0.0 tags: prospecting, email, contacts, serpapi, openai, lead-generation

contact-finder

Find professional emails and contacts from a name + company/domain. Combines SerpAPI (Google Search) and OpenAI GPT-4o-mini to search, extract, and validate contacts.

Usage

python3 scripts/find_contacts.py --company "Acme Corp" --domain "acme.com" --name "John Doe"
python3 scripts/find_contacts.py --company "Stripe" --domain "stripe.com"
python3 scripts/find_contacts.py --company "OpenAI" --domain "openai.com" --name "Sam Altman" --output json

Options

| Flag | Description | Required | |------|-------------|----------| | --company | Company name | βœ… | | --domain | Email domain (e.g. acme.com) | βœ… | | --name | Full name to search (optional) | ❌ | | --output | Output format: table (default) or json | ❌ |

Output

Returns a list of contacts with:

  • email β€” Found or guessed email address
  • linkedin β€” LinkedIn profile URL (if found)
  • title β€” Job title (if found)
  • confidence β€” high / medium / low

    • Setup

    pip3 install openai requests

    Set credentials in environment or edit scripts/find_contacts.py:

  • SERPAPI_KEY
  • OPENAI_API_KEY

    • How It Works

    1. Search Google via SerpAPI: "name" site:domain email, LinkedIn profiles 2. Generate common email format guesses (firstname@, f.lastname@, firstname.lastname@...) 3. Use GPT-4o-mini to extract/validate emails from search snippets 4. Score confidence based on source (direct find = high, pattern guess = low/medium)

    References

    See references/patterns.md for email pattern documentation and sources.

    πŸ’‘ Examples

    python3 scripts/find_contacts.py --company "Acme Corp" --domain "acme.com" --name "John Doe"
python3 scripts/find_contacts.py --company "Stripe" --domain "stripe.com"
python3 scripts/find_contacts.py --company "OpenAI" --domain "openai.com" --name "Sam Altman" --output json

    βš™οΈ Configuration

    | Flag | Description | Required | |------|-------------|----------| | --company | Company name | βœ… | | --domain | Email domain (e.g. acme.com) | βœ… | | --name | Full name to search (optional) | ❌ | | --output | Output format: table (default) or json | ❌ |