onewave-ai

contact-hunter

31
6
# Install this skill:
npx skills add OneWave-AI/claude-skills --skill "contact-hunter"

Install specific skill from multi-skill repository

# 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.

# SKILL.md


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:
  2. Person search: Find specific individual
  3. Company search: Find people at a company
  4. Role search: Find people with specific job title
  5. Email verification: Validate and enrich existing email
  6. Bulk enrichment: Enrich list of contacts

  7. Gather Search Parameters:

  8. Person name (first, last)
  9. Company name
  10. Job title / role
  11. Location (city, state, country)
  12. Industry
  13. LinkedIn URL (if available)
  14. Email domain
  15. Any other identifying information

  16. 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

  1. 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
```

  1. 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

  1. 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
```

  1. Data Enrichment:

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

  1. Export Formats:

  2. CSV: For CRM import

  3. JSON: For API integration
  4. vCard: For contact managers
  5. Salesforce CSV: Pre-formatted for SFDC
  6. 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.

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.