Skill: vokaplok/generect (version 1.0.1)

--- name: generect-api description: Search B2B leads and companies, find/validate emails via Generect Live API. Use when the user needs to find people by job title/company/industry, search companies by ICP, generate business emails from name+domain, or validate email addresses. Covers lead generation, prospecting, enrichment, and email discovery workflows. --- # Generect Live API Real-time B2B data from LinkedIn, Crunchbase, and AI-powered email discovery. **Base URL:** `https://api.generect.com` **Auth:** `Authorization: Token <GENERECT_API_KEY>` **Docs:** https://liveapi.generect.com ## Setup Requires `GENERECT_API_KEY` environment variable. Get a key at https://beta.generect.com ## Endpoints ### Search Leads by ICP `POST /api/linkedin/leads/by_icp/` Find people by ICP filters. Returns enriched LinkedIn profiles with job history, education, skills. ```json { "job_title": ["CEO", "CTO"], "location": ["United States"], "industry": ["Software Development"], "company_headcount_range": ["11-50", "51-200"], "page": 1, "per_page": 10 } ``` Key filters: `job_title`, `location`, `industry`, `company_headcount_range`, `seniority_level`, `job_function` (arrays). `company_name` is a **string** (not array). At least one of `company_name`, `company_link`, or `company_id` is required. > **Note:** This endpoint queries LinkedIn in real-time and can take 15-60+ seconds to respond. Response: `{ "amount": N, "leads": [...] }` — each lead has `full_name`, `headline`, `job_title`, `company_name`, `company_website`, `linkedin_url`, `jobs[]`, `educations[]`, `skills[]`. ### Count Leads by ICP `POST /api/linkedin/leads/count/` Estimate the number of leads matching ICP filters (same body as search, no results returned). ### Search Companies by ICP `POST /api/linkedin/companies/by_icp/` Find companies by ICP. Returns company profiles with headcount, industry, location, funding. ```json { "industry": ["Software Development"], "location": ["San Francisco"], "headcount_range": ["51-200"], "page": 1, "per_page": 10 } ``` Key filters: `industry`, `location`, `headcount_range`, `company_type`, `founded_year_min`, `founded_year_max`, `keyword`. Response: `{ "amount": N, "companies": [...] }` — each has `name`, `domain`, `industry`, `headcount_range`, `headcount_exact`, `location`, `description`, `linkedin_link`, `website`, `founded_year`. ### Count Companies by ICP `POST /api/linkedin/companies/count/` Estimate the number of companies matching ICP filters. ### Get Lead by LinkedIn URL `POST /api/linkedin/leads/by_link/` ```json { "url": "https://www.linkedin.com/in/username/" } ``` Returns full enriched profile for a specific LinkedIn URL. ### Get Company by LinkedIn URL `POST /api/linkedin/companies/by_link/` ```json { "url": "https://www.linkedin.com/company/company-name/" } ``` Returns full company profile for a specific LinkedIn company URL. ### Email Finder (Generate Email) `POST /api/linkedin/email_finder/` AI-powered email discovery from name + domain. Generated emails are automatically validated. ```json [ { "first_name": "John", "last_name": "Doe", "domain": "example.com" } ] ``` Response: `{ "email": "...", "result": "valid|risky|invalid", "catch_all": bool, "valid_email": "...", "source": "...", "mx_domain": "..." }` ### Email Validator `POST /api/linkedin/email_validator/` ```json [{ "email": "[REDACTED_SECRET]" }] ``` Response: `{ "result": "valid|invalid|risky", "catch_all": bool, "mx_domain": "...", "exist": "yes|no" }` ### Get User Info `GET /api/linkedin/user/me/` Returns current user info and balance. ### Get Transactions `GET /api/linkedin/transactions/` Returns list of API usage transactions. ## Usage via curl ```bash curl -X POST https://api.generect.com/api/linkedin/leads/by_icp/ \ -H "Authorization: Token $GENERECT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"job_title":["VP Sales"],"location":["United States"],"per_page":5}' ``` ## MCP Server (Alternative) Generect also provides an MCP server for AI tool integrations: - Remote: `mcp-remote https://mcp.generect.com/mcp --header "Authorization: Bearer Token API_KEY"` - Local: `npx -y generect-ultimate-mcp@latest` with env `GENERECT_API_KEY` Tools: `search_leads`, `search_companies`, `generate_email`, `get_lead_by_url`, `health` ## Tips - `amount: -1` in response means exact count unavailable; iterate pages until empty - Leads endpoint is live — each request queries LinkedIn in real-time (may take 5-15s) - Email finder uses AI permutations + validation; `valid` results are safe to send - Combine lead search → email generation for full prospecting pipeline - Rate limits apply per API key tier


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)