---

name: apify-lead-generation description: Generates B2B/B2C leads by scraping Google Maps, websites, Instagram, TikTok, Facebook, LinkedIn, YouTube, and Google Search. Use when user asks to find leads, prospects, businesses, build lead lists, enrich contacts, or scrape profiles for sales outreach.

Lead Generation

Scrape leads from multiple platforms using Apify Actors.

Prerequisites

• .env file with APIFY_TOKEN
• Python 3.9+ and uv

Workflow

Copy this checklist and track progress:

CopyTask Progress:
- [ ] Step 1: Determine lead source (select Actor)
- [ ] Step 2: Read Actor schema from reference docs
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the lead finder script
- [ ] Step 5: Summarize results

Step 1: Determine Lead Source

Select the appropriate Actor based on user needs:

Step 2: Read Actor Schema

Read the corresponding reference doc from the table above to understand:

• Required and optional input parameters
• Output fields available
• Actor-specific requirements

Step 3: Ask User Preferences

Before running, ask:

1. Output format:
   • Quick answer - Display top 5 results in chat (no file saved)
   • CSV (all data) - Full export with all fields
   • CSV (basic fields) - Export with essential fields only
   • JSON (all data) - Full export in JSON format
2. Output filename (if file output selected): Suggest descriptive name based on search

Step 4: Run the Script

Quick answer (display in chat, no file):

Copyuv run --with python-dotenv --with requests \
  ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.py \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV (all data):

Copyuv run --with python-dotenv --with requests \
  ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.py \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output OUTPUT_FILE.csv \
  --format csv

CSV (basic fields):

Copyuv run --with python-dotenv --with requests \
  ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.py \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output OUTPUT_FILE.csv \
  --format csv \
  --fields basic

JSON (all data):

Copyuv run --with python-dotenv --with requests \
  ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.py \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output OUTPUT_FILE.json \
  --format json

The script handles:

• Loading APIFY_TOKEN from .env
• Starting and polling the Actor run
• Downloading results in requested format (or displaying in chat)
• Reporting record count and file size

Step 5: Summarize Results

After completion, report:

• Number of leads found
• File location
• Key fields available
• Suggested next steps (filtering, enrichment)

Quick Examples

Quick answer - display top 5 in chat:

Copyuv run --with python-dotenv --with requests \
  ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.py \
  --actor "compass/crawler-google-places" \
  --input '{"searchStringsArray": ["coffee shops"], "locationQuery": "Seattle, USA", "maxCrawledPlacesPerSearch": 50}'

Google Maps - CSV with basic fields:

Copyuv run --with python-dotenv --with requests \
  ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.py \
  --actor "compass/crawler-google-places" \
  --input '{"searchStringsArray": ["coffee shops"], "locationQuery": "Seattle, USA", "maxCrawledPlacesPerSearch": 50}' \
  --output coffee-shops-seattle.csv \
  --format csv \
  --fields basic

Contact enrichment - full JSON export:

Copyuv run --with python-dotenv --with requests \
  ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.py \
  --actor "vdrmota/contact-info-scraper" \
  --input '{"startUrls": [{"url": "https://example.com"}], "maxRequestsPerStartUrl": 20}' \
  --output contacts.json \
  --format json

See reference/workflows.md for detailed step-by-step guides for each use case.

Error Handling