Lensmor Contact Finder

Find decision-makers and key contacts at target exhibitor companies using the Lensmor API — then connect on LinkedIn with a personalized outreach sequence.

When this skill triggers:

• Run the API key check (Step 1) before any API call
• Collect the target company name and optional role/function filter
• Call the contacts search endpoint and return a prioritized contact table
• Hand off to trade-show-linkedin-templates for outreach copy

Use Cases

• Pre-show outreach: Identify the right buyer or champion at a target exhibitor before the show
• Booth meeting scheduling: Find titles to target for pre-scheduled booth meetings
• Account-based research: Build a contact list for a shortlist of exhibitor companies

Important: Email Not Available

The Lensmor contacts API does not return email addresses. LinkedIn is the primary contact channel. All outreach recommendations in this skill assume LinkedIn messaging.

Workflow

Step 1: API Key Check

Before making any API call, verify the key is configured:

[ -n "$LENSMOR_API_KEY" ] && echo "ok" || echo "missing"

If the result is missing, stop and respond:

> The LENSMOR_API_KEY environment variable is not set. This skill requires a Lensmor API key to search contacts.

> Contact hello@lensmor.com to purchase access, then set the key:

> export LENSMOR_API_KEY=your_key_here

Do not proceed to any API call until the key is confirmed present.

Step 2: Collect Inputs

Required:

• company_name — Full or partial company name (1–200 characters), e.g. OperaOps

Optional:

• role — Role or function filter. Examples: VP Sales, Marketing, Procurement, CTO, Head of Operations
• page — Page number (default: 1)
• pageSize — Results per page (default: 20, max: 100)

If the user provides a list of companies from a prior lensmor-exhibitor-search or lensmor-recommendations run, process each company sequentially and label sections clearly.

Role filter guidance: use broad department terms (Marketing, Operations, Engineering) for wide coverage, or specific titles (VP Sales, Head of Procurement) for precision targeting.

Step 3: Call the API

Endpoint: GET https://platform.lensmor.com/external/contacts/search

Authentication: Authorization: Bearer $LENSMOR_API_KEY

Query parameters:

Step 4: Interpret the Response

Response envelope:

{
  "items": [...],
  "total": 18,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1
}

Item field reference:

Outreach priority signals:

Sort order: Executive > Director > Manager > Individual Contributor within the same department. Within the same seniority, prioritize by department match to the user's target buyer function.

Step 5: Format the Output

Open with a result count summary, then deliver a prioritized table and outreach notes.

## Contacts at [Company Name]

Found [total] contacts. Showing [pageSize] on page [page] of [totalPages].

Role filter: [role or "all"] | Note: email addresses are not available — LinkedIn is the primary outreach channel.

| Priority | Name | Title | Department | Seniority | LinkedIn |
|----------|------|-------|------------|-----------|----------|
| 1 | Sarah Chen | VP Procurement | Procurement | Director | [LinkedIn](https://linkedin.com/in/sarahchen) |
| 2 | Marcus Webb | Head of Operations | Operations | Director | [LinkedIn](https://linkedin.com/in/marcuswebb) |
| 3 | Priya Rao | Procurement Manager | Procurement | Manager | [LinkedIn](https://linkedin.com/in/priyarao) |

### Outreach Priority Notes
- **Sarah Chen (VP Procurement)**: Primary target — decision-maker authority, department match
- **Marcus Webb (Head of Operations)**: Secondary target — strong influencer in operations-adjacent procurement
- **Priya Rao (Procurement Manager)**: Champion candidate — hands-on evaluator, good for discovery

**Suggested next step**: Use `trade-show-linkedin-templates` to draft personalized outreach for each seniority tier.

Error Handling

Follow-up Routing

Skill Coordination

Upstream — who feeds this skill:

• lensmor-exhibitor-search — produces the list of target companies
• lensmor-recommendations — produces AI-ranked companies for ICP match

Downstream — where contacts go next:

• trade-show-linkedin-templates — generates personalized LinkedIn outreach messages for each contact tier

Typical pre-show workflow:

1. lensmor-recommendations → find matching exhibitors
2. lensmor-contact-finder (this skill) → find decision-makers at each company
3. trade-show-linkedin-templates → draft personalized messages per seniority tier

Output Rules

1. All URLs formatted as text — never bare links
2. Never output the value of LENSMOR_API_KEY
3. Never expose endpoint paths, raw curl commands, or internal token values in the response
4. Employee counts above 1,000 shown as "1.2K"; above 1,000,000 as "1.2M"
5. Empty results: report honestly, suggest broadening role filter — never fabricate contacts
6. End every response with 1–3 contextual follow-up suggestions
7. Never imply email availability — explicitly note that only LinkedIn profiles are returned
8. When totalPages > 1, prompt: "There are more contacts — say 'next page' to continue."
9. If API key is missing, direct user to hello@lensmor.com — do not just say "please configure"
10. Open every response with "Found X contacts, showing Y."

Quality Checks

Before delivering:

• Do not invent contacts or titles; use only what the API returns
• If linkedinUrl is null, note that no LinkedIn profile is available and recommend manual search via LinkedIn Sales Navigator
• If user asks for email addresses, explicitly state the API does not provide them
• Seniority priority is a guideline; surface the closest available match if target title differs
• For multi-company batch requests, process each company separately and label sections clearly

Contact data sourced from the Lensmor platform. For AI-powered exhibitor discovery, decision-maker identification, and pre-show outreach sequencing, see Lensmor.