🛍️ 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

1{
2  "searchType": "compare",
3  "keyword": "iPhone 14 Pro Max",
4  "category": "electronics",
5  "maxItems": 20,
6  "condition": "new"
7}

Output Structure

Smart Search Mode

1{
2  "products": [
3    {
4      "title": "Product Title",
5      "price": "$999.99",
6      "priceNumeric": 999.99,
7      "condition": "New",
8      "shipping": "Free Shipping",
9      "location": "US",
10      "seller": {
11        "name": "Seller Name",
12        "feedback": "99.8%"
13      },
14      "features": {
15        "freeShipping": true,
16        "fastShipping": true,
17        "returns": true
18      },
19      "attractiveness": 85
20    }
21  ]
22}

Price Comparison Mode

1{
2  "analysis": {
3    "marketInsights": {
4      "averagePrice": "999.99",
5      "priceRange": "$899.99 - $1299.99",
6      "distribution": {
7        "low": "20%",
8        "medium": "60%",
9        "high": "20%"
10      }
11    },
12    "bestDeals": [
13      {
14        "title": "Product Title",
15        "price": "$899.99",
16        "dealScore": "92.5",
17        "savings": "25%"
18      }
19    ]
20  }
21}

🎯 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:

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

📊 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.