shopee-seller

🏪 Shopee Seller & Store Intelligence (shopee-seller)

Thuộc Plugin: shopee-research

Overview

shopee-seller là kỹ năng chuyên sâu để nghiên cứu và thẩm định chất lượng các Gian hàng / Nhà bán hàng trên Shopee (Shopee Mall, Shop Yêu Thích+):

1. Store Profile Audit: Trích xuất toàn bộ chỉ số vận hành của Shop: Số lượng Follower, Số lượng sản phẩm đang bán, Đánh giá trung bình sao (4.x/5.0), Tỷ lệ phản hồi chat & tốc độ trả lời khách hàng, Thời gian hoạt động (năm tham gia).
2. Shop Health Score (Chỉ số Sức khỏe Gian hàng): Thuật toán chấm điểm độ tin cậy của Shop từ 0 đến 100 điểm dựa trên 4 trụ cột: Chất lượng đánh giá (35đ), Dịch vụ CSKH (25đ), Danh hiệu Mall/Yêu thích (20đ), và Quy mô gian hàng (20đ).
3. Voucher & Khuyến Mãi: Bóc tách danh sách mã giảm giá, voucher độc quyền của shop để đưa vào lời kêu gọi hành động (CTA) trong video tiếp thị liên kết.
4. Top Best-Sellers: Thống kê danh sách các sản phẩm bán chạy nhất của gian hàng để tìm kiếm cơ hội bán kèm (Cross-sell / Bundle).
5. Lưu trữ Cấu trúc SQLite: Lưu trực tiếp vào các bảng shops, shop_vouchers, shop_rating_analytics trong database products.db.

---

🎯 Khi Nào Sử Dụng (Triggers)

• Khi người dùng yêu cầu: "Research shop này trên Shopee", "Đánh giá gian hàng Ugreen có uy tín không", "Xem shop này có voucher gì và sản phẩm nào bán chạy nhất".
• Khi vừa chạy shopee-search và cần thẩm định độ uy tín của các gian hàng đứng đầu kết quả tìm kiếm trước khi chọn làm tiếp thị liên kết.
• Khi cần kiểm tra thông tin bảo hành, độ tin cậy để bổ sung vào kịch bản review.

---

🏗️ Quy Trình Thẩm Định 3 Bước

flowchart TD
    A[Shop URL / Shop ID / Username] --> B[1. Store Metrics Extraction\nFollowers + Rating + Response Rate + Vouchers]
    B --> C[2. AI Seller Health Calculation\nThang điểm 100 theo 4 trụ cột uy tín]
    C --> D[3. Persist to SQLite & Link to Products\nLưu shops & shop_vouchers]

Bước 1: Trích xuất chỉ số gian hàng

python3 scripts/seller_auditor.py