apollo-core-workflow-a — Claude Code skill: what it does, install
apollo-core-workflow-a builds an Apollo.io lead generation pipeline in Claude Code to search prospects and enrich qualified contacts with verified emails and phone numbers.
MIT 1 installs ★ 2,935 updated 2026-10-29
npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a claude-codeWhat apollo-core-workflow-a does
This skill sets up a prospecting workflow using official Apollo API endpoints. It separates prospect discovery from enrichment: searches through POST /mixed_people/api_search and POST /mixed_companies/search are free and consume zero credits, returning candidate profiles without direct contact details.
To retrieve verified emails and phone numbers, the workflow routes qualified leads to POST /people/match at one credit per person or batches up to 10 records via POST /people/bulk_match. A built-in scoring function ranks prospects by seniority and profile completeness before triggering paid calls.
Running this integration requires a valid APOLLO_API_KEY environment variable with search and enrichment scopes enabled. The API will reject calls if the key lacks required permissions.
What it helps with
- search decision makers across specified organization domains
- enrich prospect profiles with direct phone numbers and email addresses
- filter target companies by employee count, industry, and revenue
- batch enrich up to 10 Apollo records in a single API call
- score prospects prior to enrichment to minimize Apollo credit spend
Example prompts for the agent
- Search Apollo contacts for VP and director roles at example.com
- Find leads in Apollo and enrich the top scored candidates with emails
- Run apollo lead search to filter target companies by revenue and employee headcount
How to install apollo-core-workflow-a
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a claude-code2Manually: put the files in place
~/.claude/skills/apollo-core-workflow-a/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apollo-core-workflow-a/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a codex2Manually: put the files in place
.agents/skills/apollo-core-workflow-a/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a cursor2Manually: put the files in place
.cursor/skills/apollo-core-workflow-a/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/apollo-core-workflow-a2Manually: put the files in place
.github/skills/apollo-core-workflow-a/SKILL.md1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a gemini-cli2Platform CLI
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/apollo-core-workflow-aManually: put the files in place
.devin/skills/apollo-core-workflow-a/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about apollo-core-workflow-a
How to install apollo-core-workflow-a in Claude Code?
Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill apollo-core-workflow-a -a claude-code in your terminal.
Does searching for prospects consume Apollo credits?
No, search calls to /mixed_people/api_search and /mixed_companies/search are free. Apollo charges credits only when you call the single or bulk enrichment endpoints.
What prerequisites are required before using this workflow?
You need an active APOLLO_API_KEY environment variable with search and enrichment permissions, along with criteria defining your Ideal Customer Profile.
Source text
SKILL.md · MIT
--- name: apollo-core-workflow-a description: 'Implement Apollo.io lead search and enrichment workflow. Use when building lead generation features, searching for contacts, or enriching prospect data from Apollo. Trigger with phrases like "apollo lead search", "search apollo contacts", "find leads in apollo", "apollo people search", "enrich contacts apollo". ' allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep version: 1.13.0 license: MIT author: Jeremy Longshore <[email protected]> tags: - saas - apollo - workflow compatibility: Designed for Claude Code --- # Apollo Core Workflow A: Lead Search & Enrichment ## Overview Build the core Apollo.io prospecting pipeline: search for people and organizations, then enrich the best leads. Key distinction — **search is free** (no credits), **enrichment costs credits**. This skill uses the correct endpoints and `x-api-key` header authentication. ## Prerequisites - Completed `apollo-install-auth` setup - Valid Apollo API key with search + enrichment permissions - Understanding of your Ideal Customer Profile (ICP) ## Instructions ### Step 1: Search for People (Free — No Credits) The People API Search endpoint (`POST /mixed_people/api_search`) searches Apollo's 275M+ database. It does **not** return emails or phone numbers — use enrichment for that. ```typescript // src/workflows/lead-search.ts import axios from 'axios'; const client = axios.create({ baseURL: 'https://api.apollo.io/api/v1', headers: { 'Content-Type': 'application/json', 'x-api-key': process.env.APOLLO_API_KEY! }, }); interface PersonSearchParams { domains: string[]; titles?: string[]; seniorities?: string[]; // "c_suite", "vp", "director", "manager", "senior" locations?: string[]; // "United States", "San Francisco, California" page?: number; perPage?: number; } export async function searchPeople(params: PersonSearchParams) { const { data } = await client.post('/mixed_people/api_search', { q_organization_domains_list: params.domains, person_titles: params.titles, person_seniorities: params.seniorities, person_locations: params.locations, include_similar_titles: true, page: params.page ?? 1, per_page: params.perPage ?? 25, }); return { people: data.people, total: data.pagination.total_entries, totalPages: data.pagination.total_pages, page: data.pagination.page, }; } ``` ### Step 2: Search for Organizations (Free) ```typescript // src/workflows/org-search.ts interface OrgSearchParams { keywords?: string; locations?: string[]; employeeRanges?: string[]; // ["1,10", "11,50", "51,200", "201,500"] industries?: string[]; revenueRanges?: string[]; // ["0,1000000", "1000000,10000000"] } export async function searchOrganizations(params: OrgSearchParams) { const { data } = await client.post('/mixed_companies/search', { q_organization_keyword_tags: params.keywords ? [params.keywords] : undefined, organization_locations: params.locations, organization_num_employees_ranges: params.employeeRanges, organization_industry_tag_ids: params.industries, organization_revenue_ranges: params.revenueRanges, page: 1, per_page: 25, }); return data.organizations.map((org: any) => ({ id: org.id, name: org.name, domain: org.primary_domain, industry: org.industry, employees: org.estimated_num_employees, revenue: org.annual_revenue_printed, city: org.city, state: org.state, })); } ``` ### Step 3: Enrich a Single Person (1 Credit) ```typescript // src/workflows/enrich.ts export async function enrichPerson(params: { email?: string; linkedinUrl?: string; firstName?: string; lastName?: string; domain?: string; }) { const { data } = await client.post('/people/match', { email: params.email, linkedin_url: params.linkedinUrl, first_name: params.firstName, last_name: params.lastName, organization_domain: params.domain, reveal_personal_emails: false, reveal_phone_number: true, }); if (!data.person) return null; const p = data.person; return { id: p.id, name: p.name, title: p.title, email: p.email, phone: p.phone_numbers?.[0]?.sanitized_number, company: p.organization?.name, companyDomain: p.organization?.primary_domain, linkedinUrl: p.linkedin_url, seniority: p.seniority, city: p.city, state: p.state, }; } ``` ### Step 4: Bulk Enrich People (Up to 10 per Call) ```typescript export async function bulkEnrichPeople(details: Array<{ email?: string; linkedin_url?: string; first_name?: string; last_name?: string; organization_domain?: string; }>) { const { data } = await client.post('/people/bulk_match', { details, reveal_personal_emails: false, reveal_phone_number: false, }); return (data.matches ?? []).map((match: any) => ({ id: match.id, name: match.name, email: match.email, title: match.title, company: match.organization?.name, })); } ``` ### Step 5: Build a Combined Lead Pipeline ```typescript export async function buildLeadPipeline(targetDomains: string[]) { const leads: any[] = []; for (const domain of targetDomains) { // Step A: Search for decision-makers (free) const { people } = await searchPeople({ domains: [domain], seniorities: ['vp', 'director', 'c_suite'], }); // Step B: Score leads before enriching (save credits) const worthEnriching = people.filter((p: any) => scoreLead(p) >= 50); // Step C: Bulk enrich top leads (costs credits) if (worthEnriching.length > 0) { const enriched = await bulkEnrichPeople( worthEnriching.map((p: any) => ({ first_name: p.first_name, last_name: p.last_name, organization_domain: domain, })), ); leads.push(...enriched); } } return leads.sort((a, b) => scoreLead(b) - scoreLead(a)); } function scoreLead(person: any): number { let score = 0; if (person.email) score += 30; if (person.phone_numbers?.length) score += 20; if (['c_suite', 'vp', 'founder', 'owner'].includes(person.seniority)) score += 30; else if (['director'].includes(person.seniority)) score += 20; if (person.linkedin_url) score += 10; if (person.city) score += 10; return score; } ``` ## Output - People search via `POST /mixed_people/api_search` (free, no credits) - Organization search via `POST /mixed_companies/search` (free) - Single person enrichment via `POST /people/match` (1 credit) - Bulk enrichment via `POST /people/bulk_match` (up to 10 per call) - Lead scoring to minimize credit spend before enriching ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | Empty `people` array | Too narrow criteria | Broaden seniority levels, add `include_similar_titles: true` | | `null` from enrichment | Person not in Apollo database | Try enriching via LinkedIn URL instead of name+domain | | 429 Rate Limited | Too many requests/minute | Batch requests with 500ms delays between calls | | 403 Forbidden | Standard key used for enrichment | Upgrade to master API key in Apollo dashboard | ## Examples ### Quick ICP Search ```typescript // Find Series B SaaS companies with 50-500 employees const companies = await searchOrganizations({ keywords: 'SaaS', employeeRanges: ['51,200', '201,500'], locations: ['United States'], }); // Find VPs of Sales at those companies for (const company of companies.slice(0, 10)) { const { people, total } = await searchPeople({ domains: [company.domain], titles: ['VP Sales', 'Head of Sales', 'VP Revenue'], }); console.log(`${company.name} (${company.domain}): ${total} contacts`); } ``` ## Resources - [People API Search](https://docs.apollo.io/reference/people-api-search) - [Organization Search](https://docs.apollo.io/reference/organization-search) - [People Enrichment](https://docs.apollo.io/reference/people-enrichment) - [Bulk People Enrichment](https://docs.apollo.io/reference/bulk-people-enrichment) - [Find People Using Filters](https://docs.apollo.io/docs/find-people-using-filters) ## Next Steps Proceed to `apollo-core-workflow-b` for email sequences and outreach.
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace