joseph
/
ebayDeepScan
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ebayDeepScan/HUONG_DAN.md

3.1 KiB
Raw Permalink Blame History

Hướng Dẫn Sử Dụng - eBay Deep Scan

Công cụ này giúp bạn tìm kiếm, lọc và phân tích các mặt hàng trên eBay dựa trên các bộ từ khóa và cấu hình linh hoạt.

1. Cấu Hình Ban Đầu

Trước khi bắt đầu, bạn cần thiết lập các thông số môi trường trong file .env:

  1. Copy .env.example thành .env.
  2. Điền các mã API của eBay (EBAY_CLIENT_ID, EBAY_CLIENT_SECRET).
  3. Điền OPENAI_API_KEY để sử dụng tính năng phân tích bằng AI.

2. Quản Lý Hồ Sơ Thu Quét (Scan Profiles)

Mỗi "Profile" đại diện cho một nhóm mặt hàng (ví dụ: SSD, RAM, GPU).

  1. Truy cập Dashboard (thông qua http://localhost:4000).
  2. Nhấn Manage Profiles.
  3. Thêm Profile mới: Điền tên và Price Ratio (tỷ lệ giá mục tiêu so với giá thị trường, ví dụ 0.85).
  4. Common Keywords (Keyword Chung): Đây là những từ khóa sẽ được nối vào cuối mọi truy vấn tìm kiếm trong profile đó (ví dụ -cable -adapter để loại bỏ dây cáp và đầu chuyển).

3. Nhập Từ Khóa (Import Keywords)

Bạn có thể nhập từ khóa theo phương pháp Bulk Import (nhập hàng loạt).

  1. Chọn Profile bạn muốn làm việc.
  2. Nhấn Bulk Import.
  3. Định dạng nhập: Mã Sản Phẩm | Từ Khóa 1, Từ Khóa 2 | Giá Mục Tiêu
    • Ví dụ: "SSDSC2BX200" | "200GB", "2.5" | 14.00
    • Lưu ý: Nếu bạn để mã sản phẩm trong ngoặc kép "Mã", hệ thống sẽ tìm kiếm chính xác mã đó trên eBay.

4. Thực Hiện Quét (Scanning)

  1. Nhấn nút Deep Scan ở góc trên bên phải Dashboard.
  2. Một thanh tiến trình (Progress Bar) sẽ hiện ra cho biết hệ thống đang tìm kiếm từ khóa nào và hoàn thành được bao nhiêu phần trăm.
  3. Kết quả sẽ được tự động lưu vào database và hiển thị trên bảng.

5. Xem Kết Quả và Phân Tích AI

  • Bảng Kết Quả: Các mặt hàng có giá tốt (vượt qua bộ lọc giá) sẽ hiện lên trên dashboard.
  • AI Analysis: Hệ thống tự động gửi thông tin chi tiết của các mặt hàng "PASS" lên AI để phân tích xem sản phẩm đó có đúng là món hời hay có rủi ro gì không.
  • Popup Chi Tiết: Nhấn vào tên sản phẩm để xem ảnh phóng to, mô tả đầy đủ, thông tin người bán và các chỉ số giá (Avg Price/Unit).

6. Các Phím Tắt và Tiện Ích

  • ESC: Đóng các cửa sổ popup.
  • Dọn dẹp database: Nếu muốn xóa sạch danh sách mặt hàng đã quét, hãy chạy lệnh: 
    node truncate_items.js

7. Lưu Ý

  • Hệ thống tự động bỏ qua các mặt hàng từ Trung Quốc (CN) và các sản phẩm bị lỗi/hỏng (defective).
  • Các mặt hàng được đấu giá (Auction) cũng được hỗ trợ nhưng sẽ được phân tích dựa trên giá hiện tại cộng phí ship.

Chúc bạn săn được những món hời nhất trên eBay!