Shopify Medical Device Lead Generator

This project scrapes Shopify stores to identify businesses selling medical devices for consumer use.

Three Ways to Run

1. 🌐 Web App (Easiest!) - Beautiful web interface, no coding required!

   • Just run: npm run webapp or double-click start.sh / start.bat
   • Open http://localhost:3000 in your browser
   • See START_WEBAPP.md
   • 👉 RECOMMENDED FOR NON-CODERS

2. 🏠 Command Line (Local) - For developers comfortable with terminal

   • See LOCAL_SETUP.md
   • Best for: Testing, small batches (<50 stores)

3. ☁️ Apify (Cloud) - Professional scraping platform

   • See DEPLOYMENT.md
   • Best for: Production, large scale (100+ stores)

Overview

The lead generator targets Shopify stores selling:

• Home medical devices (blood pressure monitors, thermometers, pulse oximeters)
• Mobility aids (wheelchairs, walkers, canes)
• Diabetic supplies (glucose monitors, insulin pumps)
• Respiratory equipment (nebulizers, CPAP machines, oxygen concentrators)
• First aid and wound care products
• Diagnostic equipment for home use
• Health monitoring wearables
• Medical supplies and consumables

Features

• Automated Discovery: Finds Shopify stores through Google search and product listings
• Medical Device Filtering: Identifies stores selling medical devices using keyword matching
• Store Validation: Verifies stores are active and selling to consumers
• Contact Extraction: Captures store contact information and social media links
• Product Analysis: Extracts product categories, pricing, and inventory data
• Lead Scoring: Ranks stores based on product variety and engagement metrics

Architecture

┌─────────────────┐
│  Search Engine  │ → Find Shopify stores with medical keywords
└────────┬────────┘
         │
┌────────▼────────┐
│  Store Scraper  │ → Extract store details and product data
└────────┬────────┘
         │
┌────────▼────────┐
│ Medical Filter  │ → Identify medical device stores
└────────┬────────┘
         │
┌────────▼────────┐
│  Lead Database  │ → Store qualified leads
└─────────────────┘

Quick Start

Standalone (Local - No Apify)

# 1. Install minimal dependencies
npm install axios cheerio

# 2. Run it!
npm run standalone

# Results saved to results/ folder

See LOCAL_SETUP.md for full details.

Apify Platform (Cloud)

# 1. Install Apify CLI
npm install -g apify-cli

# 2. Login and deploy
apify login
apify push

# 3. Run on Apify platform

See DEPLOYMENT.md for full details.

Usage

Running on Apify Platform

1. Upload the actor to Apify
2. Configure the input JSON (see input-examples/)
3. Run the actor and collect results

Input Configuration

{
  "proxy": {
    "useApifyProxy": true
  },
  "searchKeywords": [
    "medical devices",
    "home healthcare",
    "medical supplies"
  ],
  "maxStores": 100,
  "extractProducts": true,
  "minProductsPerStore": 5
}

Output Format

{
  "storeName": "Example Medical Supply",
  "storeUrl": "https://example.myshopify.com",
  "email": "contact@example.com",
  "phone": "+1-555-0123",
  "products": [
    {
      "name": "Digital Blood Pressure Monitor",
      "price": "$49.99",
      "category": "Diagnostic Equipment"
    }
  ],
  "socialMedia": {
    "facebook": "https://facebook.com/example",
    "instagram": "https://instagram.com/example"
  },
  "leadScore": 85
}

Medical Device Categories

The scraper identifies stores based on these categories:

• Diagnostic & Monitoring
• Mobility & Accessibility
• Respiratory Care
• Diabetes Management
• Wound Care & First Aid
• Home Medical Equipment
• Personal Protective Equipment
• Medical Consumables

Contributing

Contributions are welcome! Please submit pull requests or open issues for improvements.

License

MIT License