Playwright Lead Research

---
name: playwright-lead-research
description: Gives an agent the ability to browse websites, search Google Maps, extract structured lead data, and compile research reports.
inputs:
  - search_query: What to search for (e.g., "AI agencies in Mexico City")
  - source_urls: Optional list of specific websites to analyze
  - max_results: Maximum number of leads to collect
outputs:
  - lead_list: Structured leads with name, contact, website, social profiles
  - company_profiles: Enriched company info per lead
  - research_report: Summary of findings
tools:
  - playwright: Browser automation and data extraction
  - openai: Content analysis and enrichment
  - google_maps: Location-based lead discovery
safety:
  - Respect robots.txt and website terms of service
  - Set reasonable delays between requests (2-5 seconds)
  - Do not bypass login walls or CAPTCHAs
  - Never store passwords or session tokens
---

# Playwright Lead Research Skill

Browse websites, search business directories, and extract structured lead data using Playwright browser automation guided by AI.

## When to Use

- You need to find leads in a specific industry or location
- You want to research companies and extract contact info
- You need competitive intelligence from websites
- You're building a lead list for outbound sales

## How It Works

1. **Plan**: AI breaks the research task into browser steps
2. **Navigate**: Playwright visits each URL or search result
3. **Extract**: Pull structured data (name, phone, email, address)
4. **Enrich**: AI analyzes page content for company details
5. **Compile**: Results are formatted as a structured lead list

## Safety Notes

- Always check robots.txt before scraping
- Add 2-5 second delays between requests
- Do not attempt to bypass authentication
- Respect rate limits and terms of service

## Example Prompt

"Research digital marketing agencies in Guadalajara. Find their websites, extract contact info and services offered, and compile a lead list."

## Related

- Recipe: /recipes/lead-scraper-to-crm