🛍️ eBay Smart Shopper

Advanced eBay product data collector with smart price analysis and deal scoring.

✨ Features

• Smart Search: Find the best deals with intelligent scoring
• Price Comparison: Analyze market prices and find outliers
• Deal Scoring: Evaluate deals based on multiple factors
• Market Analysis: Get insights about price distribution
• Batch Processing: Efficient data collection with memory optimization

🚀 Getting Started

Prerequisites

• Node.js >= 18.0.0
• Apify account

Installation

1. Clone this repository
2. Install dependencies:

$npm install

Usage

Input Parameters

• Search Type:

  • search: Smart search with deal scoring
  • compare: Price comparison and market analysis

• Basic Parameters:

  • keyword: Search term (required)
  • category: Product category
  • maxItems: Maximum number of items to analyze (default: 10)
  • sortBy: Sorting method (best_match, price_asc, price_desc, newest)

• Price Filters:

  • minPrice: Minimum price in USD
  • maxPrice: Maximum price in USD
  • condition: Product condition (all, new, used)

Example Input

{
  "searchType": "compare",
  "keyword": "iPhone 14 Pro Max",
  "category": "electronics",
  "maxItems": 20,
  "condition": "new"
}

Output Structure

Smart Search Mode

{
  "products": [
    {
      "title": "Product Title",
      "price": "$999.99",
      "priceNumeric": 999.99,
      "condition": "New",
      "shipping": "Free Shipping",
      "location": "US",
      "seller": {
        "name": "Seller Name",
        "feedback": "99.8%"
      },
      "features": {
        "freeShipping": true,
        "fastShipping": true,
        "returns": true
      },
      "attractiveness": 85
    }
  ]
}

Price Comparison Mode

{
  "analysis": {
    "marketInsights": {
      "averagePrice": "999.99",
      "priceRange": "$899.99 - $1299.99",
      "distribution": {
        "low": "20%",
        "medium": "60%",
        "high": "20%"
      }
    },
    "bestDeals": [
      {
        "title": "Product Title",
        "price": "$899.99",
        "dealScore": "92.5",
        "savings": "25%"
      }
    ]
  }
}

🎯 Deal Score Calculation

The deal score (0-100) is calculated based on:

• 40% - Price compared to market average
• 20% - Seller rating and feedback
• 20% - Shipping options and cost
• 20% - Product condition

⚙️ Configuration

Key configurations in src/main.js:

const CONFIG = {
  RATE_LIMIT: 1000, // Delay between requests
  MAX_RETRIES: 3, // Max retry attempts
  BATCH_SIZE: 5, // Items per batch
  PRICE_ANALYSIS: {
    OUTLIER_THRESHOLD: 2, // Standard deviations for outlier detection
  },
};

📊 Market Analysis Features

• Price distribution analysis
• Outlier detection
• Best deals identification
• Savings calculation
• Seller reliability assessment

🔒 Rate Limiting

The actor implements rate limiting to comply with eBay's guidelines:

• 1 second delay between requests
• Batch processing of 5 items
• Maximum 3 retry attempts

📝 Notes

• Price outliers are detected using 2 standard deviations from the mean
• Deal scores above 70 are considered good deals
• The actor automatically handles pagination and memory management

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the ISC License.