home / skills / onewave-ai / claude-skills / contact-hunter

contact-hunter skill

/contact-hunter

This skill helps you find and enrich contact details across sources, boosting prospect lists with verified emails, phones, and LinkedIn profiles.

npx playbooks add skill onewave-ai/claude-skills --skill contact-hunter

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
9.9 KB
---
name: contact-hunter
description: Search and extract contact information for people or companies including names, phone numbers, emails, job titles, and LinkedIn profiles. Aggregates data from multiple sources and provides enriched contact details. Use when users need to find contact information, build prospect lists, or enrich existing contact data.
---

# Contact Hunter

Find and enrich contact information from multiple sources with detailed attribution.

## Instructions

When a user needs to find contact information:

1. **Identify Search Type**:
   - **Person search**: Find specific individual
   - **Company search**: Find people at a company
   - **Role search**: Find people with specific job title
   - **Email verification**: Validate and enrich existing email
   - **Bulk enrichment**: Enrich list of contacts

2. **Gather Search Parameters**:
   - Person name (first, last)
   - Company name
   - Job title / role
   - Location (city, state, country)
   - Industry
   - LinkedIn URL (if available)
   - Email domain
   - Any other identifying information

3. **Search Strategy**:

   **Sources to Check** (suggest to user):
   - LinkedIn (manual search with user's account)
   - Company website (About, Team, Contact pages)
   - GitHub (for developers)
   - Twitter/X profiles
   - Professional directories
   - Public databases
   - ZoomInfo (if user has access)
   - Apollo.io (if user has access)
   - Hunter.io (if user has access)
   - RocketReach (if user has access)

   **⚠️ Important**: This skill GUIDES the search process. It doesn't directly access paid APIs. Instead, it:
   - Provides structured search queries
   - Suggests where to look
   - Helps organize found information
   - Validates and formats results

4. **Search Instructions Format**:
   ```
   🔍 CONTACT SEARCH: [Name/Company]

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   📋 SEARCH PARAMETERS
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   Target: John Smith
   Company: Acme Corp
   Title: VP of Engineering
   Location: San Francisco, CA

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   🎯 RECOMMENDED SEARCH QUERIES
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   LinkedIn:
   1. Search: "John Smith VP Engineering Acme Corp"
   2. Use company filter: "Acme Corp"
   3. Use title filter: "VP of Engineering"
   4. Location: "San Francisco Bay Area"

   Google:
   1. "John Smith" "VP of Engineering" "Acme Corp"
   2. "John Smith" "Acme Corp" email
   3. site:linkedin.com/in "John Smith" "Acme"
   4. site:acme.com "John Smith"

   Company Website:
   1. Check: https://acme.com/about
   2. Check: https://acme.com/team
   3. Check: https://acme.com/leadership
   4. Check: https://acme.com/contact

   Email Pattern Guessing:
   Common patterns at acme.com:
   • [email protected][email protected][email protected][email protected][email protected]

   GitHub (for technical roles):
   • Search: "John Smith Acme"
   • Look for company in bio

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   📝 DATA COLLECTION TEMPLATE
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   Once you find the information, fill this template:

   Full Name: [First Last]
   Job Title: [Exact title]
   Company: [Company name]
   Email: [[email protected]]
   Phone: [(xxx) xxx-xxxx]
   LinkedIn: [linkedin.com/in/username]
   Location: [City, State/Country]
   Department: [Engineering, Sales, etc.]

   Additional Info:
   • Reports to: [Manager name]
   • Team size: [Number]
   • Start date: [When they joined]
   • Previous companies: [List]
   • Education: [Degree, School]

   Data Sources:
   • [LinkedIn profile URL]
   • [Company website URL]
   • [Other sources]

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   ✅ VERIFICATION STEPS
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   1. Cross-reference multiple sources
   2. Check LinkedIn profile matches company
   3. Verify email format matches company pattern
   4. Validate phone number format
   5. Confirm job title is current
   6. Check for recent company changes

   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   ⚠️ COMPLIANCE & ETHICS
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   • Only use publicly available information
   • Respect privacy and GDPR regulations
   • Don't scrape private databases
   • Honor do-not-contact preferences
   • Use for legitimate business purposes only
   • Keep CAN-SPAM compliance for cold outreach
   ```

5. **Organize Results**:

   **Individual Contact Card**:
   ```
   ┌─────────────────────────────────────────┐
   │ JOHN SMITH                              │
   │ VP of Engineering @ Acme Corp           │
   ├─────────────────────────────────────────┤
   │ 📧 [email protected]                  │
   │ 📱 (415) 555-0123                       │
   │ 💼 linkedin.com/in/johnsmith            │
   │ 📍 San Francisco, CA                    │
   ├─────────────────────────────────────────┤
   │ Department: Engineering                 │
   │ Reports to: Sarah Chen (CTO)            │
   │ Team size: ~45 engineers                │
   │ Tenure: 2+ years at Acme                │
   ├─────────────────────────────────────────┤
   │ 🔍 Sources:                             │
   │ • LinkedIn (verified)                   │
   │ • Company website                       │
   │ • Verified: 2024-01-15                  │
   └─────────────────────────────────────────┘
   ```

   **Bulk Results** (CSV/Excel format):
   ```csv
   Name,Title,Company,Email,Phone,LinkedIn,Location,Source,Verified
   John Smith,VP Engineering,Acme Corp,[email protected],(415) 555-0123,linkedin.com/in/johnsmith,San Francisco,LinkedIn,2024-01-15
   Jane Doe,Director Marketing,Acme Corp,[email protected],(415) 555-0124,linkedin.com/in/janedoe,San Francisco,Company Website,2024-01-15
   ```

6. **Email Pattern Detection**:

   When searching company contacts, detect email patterns:
   ```
   🔍 DETECTED EMAIL PATTERN: Acme Corp

   Confirmed Emails Found:
   • [email protected][email protected][email protected]

   Detected Pattern: [email protected]

   Confidence: 95%

   Alternative Patterns (if primary fails):
   • [email protected][email protected][email protected]

   To Verify Unknown Email:
   1. Use email verification tool
   2. Check for bounce/invalid
   3. Look for SMTP response
   4. Verify on LinkedIn
   ```

7. **Data Enrichment**:

   For existing contacts, enrich with:
   - Current job title
   - Company changes
   - Updated contact info
   - Social profiles
   - Company information
   - Reporting structure
   - Recent activity/posts

8. **Export Formats**:

   - **CSV**: For CRM import
   - **JSON**: For API integration
   - **vCard**: For contact managers
   - **Salesforce CSV**: Pre-formatted for SFDC
   - **HubSpot CSV**: Pre-formatted for HubSpot

## Search Strategies

**For Company Employees**:
```
site:linkedin.com/in "[Company Name]"
OR
site:[company-domain.com] "team" OR "about" OR "leadership"
```

**For Specific Roles**:
```
"[Job Title]" "[Company]" email
OR
"[Job Title]" site:linkedin.com "[Company]"
```

**For Email Validation**:
- Check company website for email format
- Use email verification services
- Look for pattern in existing emails
- Test with email finder tools

**For Phone Numbers**:
- Company website contact page
- LinkedIn profile (sometimes public)
- Professional directories
- Industry associations

## Example Triggers

- "Find the VP of Sales at Acme Corp"
- "Get contact info for John Smith at Microsoft"
- "Find engineering managers at Stripe"
- "Enrich this list of contacts with emails"
- "What's the email pattern at Google?"
- "Find the marketing team at HubSpot"

## Compliance Guidelines

**What's Allowed**:
- Publicly available information
- Business contact information
- LinkedIn public profiles
- Company websites
- Professional directories
- Published contact lists

**What's NOT Allowed**:
- Scraping private databases
- Purchasing questionable contact lists
- Bypassing email verification
- Ignoring opt-out requests
- Violating GDPR/CCPA
- Harassing contacts

**Best Practices**:
- Always cite data sources
- Respect privacy preferences
- Use for legitimate business purposes
- Keep data up to date
- Provide opt-out mechanisms
- Follow CAN-SPAM for outreach
- Comply with data protection laws

## Output Quality

Ensure contact information:
- Includes all available fields
- Cites data sources
- Has confidence/verification level
- Follows data privacy laws
- Is formatted consistently
- Includes contact preferences
- Notes data freshness
- Provides context (tenure, role, team)
- Flags any uncertainties
- Suggests verification steps

Provide structured, ethically-sourced contact information with full transparency.

Overview

This skill finds and enriches contact information for people and companies, including names, emails, phone numbers, job titles, and LinkedIn profiles. It aggregates public sources, suggests structured search queries, and returns verifiable contact cards or bulk exports for CRM import. Use it to build prospect lists, validate contacts, or enrich existing records while respecting privacy and compliance.

How this skill works

The skill guides a step‑by‑step search: identify whether you need a person, company, role, or bulk enrichment and collect search parameters (name, company, title, location, domain). It recommends specific queries for LinkedIn, company sites, GitHub, Google, and professional directories, suggests email pattern guesses, and provides verification steps. Results are organized into individual contact cards or CSV/JSON/vCard exports and include source attribution and confidence levels.

When to use it

  • You need a single person’s verified business contact details
  • You want to find employees at a specific company or in a specific role
  • You need to enrich or validate a bulk contact list before CRM import
  • You want to infer a company email pattern or verify an email
  • You need structured output (CSV/JSON/vCard) with sources and verification notes

Best practices

  • Start with precise search parameters: full name, company, title, and location when available
  • Cross‑reference at least two public sources before marking a contact verified
  • Record source URLs and a confidence score for each field
  • Respect privacy, follow GDPR/CCPA, and honor do‑not‑contact preferences
  • Use recommended verification tools for emails and avoid scraping private or paid databases without authorization

Example use cases

  • Find the VP of Sales at a target account and export a Salesforce‑ready CSV
  • Enrich an internal lead list with current titles, company changes, and LinkedIn URLs
  • Detect the dominant email pattern for a company to generate likely addresses
  • Assemble a list of engineering managers at startups in a region for outreach
  • Verify and normalize phone numbers and emails before importing into HubSpot

FAQ

Does the skill access paid databases like ZoomInfo or Hunter.io directly?

No. The skill does not directly access paid APIs. It provides structured queries, source recommendations, and verification guidance for tools you have access to.

How do you ensure data complies with privacy laws?

The process uses only publicly available sources, records source attribution, recommends honoring opt‑out requests, and advises following GDPR/CCPA and CAN‑SPAM for outreach.

What export formats are supported?

Outputs are formatted for CSV (CRM), JSON (API), vCard (contact managers), and pre‑formatted CSVs for Salesforce or HubSpot.