73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
# eBay Deep Scan Dashboard
|
|
|
|
A professional eBay scanning and price monitoring tool. It automates searching for products across international eBay marketplaces, filters for the best deals based on target prices, and uses AI to verify product authenticity and seller reputation.
|
|
|
|
## 🚀 Key Features
|
|
|
|
- **Profile Management**: Create and manage different scan profiles (e.g., RAM, SSD, CPUs) with individual target prices and price ratios.
|
|
- **International Search**: Automatically scans eBay US, UK, AU, CA, and DE marketplaces.
|
|
- **Smart Filtering**:
|
|
- Skips **Group Products** (multi-variation listings) that lack deterministic logic.
|
|
- Filters out **defective/broken** items and listings from **China (CN)**.
|
|
- Advanced **Quantity Extraction**: Intelligently parses quantities (e.g., `4x256GB`, `Lot of 10`) while avoiding technical specs (e.g., `NVMe x4`, `PCIe x16`).
|
|
- **AI-Powered Analysis**: Uses **OpenAI GPT-4o-mini** to analyze listings for "fake" red flags, seller credibility, and technical spec matches.
|
|
- **Real-time Dashboard**:
|
|
- **Progress Bar**: Monitor scan progress in real-time.
|
|
- **Enriched Details**: View high-res images, full descriptions, and calculated profit margins.
|
|
- **Usage Tracking**: Summarizes total "Quote Requests" and AI tokens consumed at the end of each process.
|
|
- **Persistence**: Powered by SQLite for reliable data storage of profiles, keywords, and found items.
|
|
|
|
## 🛠 Setup & Installation
|
|
|
|
1. **Install Dependencies**:
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
2. **Configure Environment Variables**:
|
|
Copy `.env.example` to `.env` and fill in your credentials:
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
Required keys:
|
|
- `EBAY_CLIENT_ID` & `EBAY_CLIENT_SECRET`: From your eBay Developer account.
|
|
- `OPENAI_API_KEY`: From OpenAI.
|
|
|
|
3. **Database Initialization**:
|
|
The database (`data/ebay_items.db`) is automatically initialized on the first run.
|
|
|
|
## 🏃 Getting Started
|
|
|
|
1. **Start the Server**:
|
|
```bash
|
|
npm start
|
|
# or
|
|
node server.js
|
|
```
|
|
|
|
2. **Access the Web UI**:
|
|
Open your browser and navigate to: `http://localhost:4000`
|
|
|
|
3. **Usage Workflow**:
|
|
- **Create a Profile**: Go to "Manage Profiles" to add a new category.
|
|
- **Add Keywords**: Use the "Manage Keywords" button to add part numbers and search terms for a profile (supports bulk import).
|
|
- **Run Scan**: Click "Start Scan" to begin searching eBay. The progress bar will show real-time status.
|
|
- **Review Items**: Review items that passed the price filter (PASS status). Click on an item title to see AI analysis, high-res images, and available quantity.
|
|
|
|
## 📂 Project Structure
|
|
|
|
- `server.js`: Express API and web server.
|
|
- `scanner.js`: Core scanning engine (eBay API integration, filtering, and quantity logic).
|
|
- `db.js`: Database layer (SQLite using `better-sqlite3`).
|
|
- `ai.js`: AI analysis layer (OpenAI integration).
|
|
- `public/`: Frontend dashboard (HTML/CSS/JS).
|
|
|
|
## 📊 Monitoring
|
|
|
|
At the end of every scan, the system provides a **Usage Summary** in the logs:
|
|
- **Total Quote Requests**: Number of items successfully enriched with details.
|
|
- **Total AI Tokens**: Total consumption of OpenAI tokens.
|
|
|
|
---
|
|
*Developed for professional eBay asset recovery and price monitoring.*
|