Bestsy - Bestseller Tracker

Hướng dẫn sử dụng Bestsy

Hướng dẫn cài đặt Etsy API key & Telegram bot (chi tiết từng bước) nằm ở trang riêng: Hướng dẫn cài đặt. Trang này giải thích toàn bộ hệ thống — từ đăng ký tới dùng từng tính năng trên extension.

Mục lục

1. Tổng quan hệ thống

Bestsy gồm 2 phần hoạt động cùng nhau:

API key Etsy chỉ lưu trong trình duyệt của bạn, không bao giờ gửi lên server của chúng tôi — extension gọi thẳng Etsy bằng key đó từ máy bạn.

2. Bắt đầu (5 bước)

  1. Đăng ký tài khoản tại Đăng ký — tự động có 1 gói dùng thử.
  2. Cài extension: bấm Tải extension trên đầu trang, xem chi tiết ở Hướng dẫn cài đặt.
  3. Lấy license code: vào Bảng điều khiển sau khi đăng nhập, copy license code trong mục "License codes".
  4. Kích hoạt trong extension: mở popup extension → tab License → dán code vào ô → bấm "Save & verify."
  5. Nhập Etsy API key: tab Keys trong popup → dán Keystring + Shared secret (xem cách lấy 2 giá trị này ở Hướng dẫn cài đặt).

Xong 5 bước trên là extension đã hoạt động đầy đủ — không cần thao tác gì thêm để bắt đầu quét.

3. Trang quản lý tài khoản (Dashboard)

Gói hiện tại: hiển thị tên gói, số ngày dùng thử còn lại (nếu đang trial), và "Số shop đang theo dõi" — con số này do extension tự báo cáo lên mỗi khi check-in, mang tính thông tin tham khảo, hệ thống không tự chặn nếu bạn theo dõi vượt số này.

License codes: mỗi license code = 1 thiết bị/trình duyệt được phép dùng extension. Số lượng license code tối đa phụ thuộc gói đang dùng (khác với giới hạn số shop).

Lưu ý phân biệt: "giới hạn shop" (bao nhiêu shop đối thủ được theo dõi cùng lúc) và "số license code" (bao nhiêu thiết bị) là 2 giới hạn khác nhau của cùng 1 gói.

5. Các bảng hiển thị ngay trên trang Etsy

Trang kết quả tìm kiếm: dưới mỗi sản phẩm hiện 1 khối chỉ số nhỏ (lượt xem, lượt xem/ngày, lượt thích, ngày tạo/cập nhật, ước tính đã bán & doanh thu) kèm nút "📋 Copy tags". Sản phẩm đạt ngưỡng Highlight sẽ được viền màu nổi bật.

Trang shop: nút nổi "📊 Shop Tracker" ở góc dưới phải mở 1 panel trượt ra, hiển thị số liệu tổng quan (Active listings, Sales, Reviews, Listing Favs) kèm mũi tên tăng/giảm so với lần quét trước, biểu đồ "Daily Sold" & "Sold (cumulative)" (cần ≥2 lần quét mới có), danh sách "Top sellers" và "New listings" của shop đó, và nút "☆ Watch this shop" để thêm vào watchlist.

Trang listing: nút nổi "🔍 Check Listing" mở panel hiển thị đầy đủ chỉ số, nút "☆ Watch" và "💾 Save", cùng phần kiểm tra SEO: đếm ký tự tiêu đề (giới hạn 140), mô tả, và từng tag (giới hạn 20 ký tự/tag, tối đa 13 tag) — kèm nút copy nhanh từng phần.

Nếu license chưa hợp lệ, các panel trên sẽ hiện thông báo khóa (🔒) thay vì số liệu — xem mục 9 để khắc phục.

6. Điểm Bestseller & Highlight nghĩa là gì

Composite Bestseller Score kết hợp 4 tín hiệu trong cửa sổ 14 ngày gần nhất: 40% tốc độ bán ước tính (so với các listing khác cùng từ khóa), 20% tín hiệu "hết hàng & tự renew", 20% tốc độ tăng lượt thích, 20% thứ hạng tìm kiếm hiện tại. Cần ít nhất 2 lần quét mới tính được — chưa đủ dữ liệu sẽ hiện "not enough data".

Highlight chỉ đơn giản là viền nổi bật những sản phẩm đạt ngưỡng bạn tự đặt ở tab Highlight (lượt xem/ngày tối thiểu + tuổi listing tối đa) — không liên quan tới điểm số ở trên, đây là 1 công cụ độc lập để "bắt mắt" nhanh khi lướt trang tìm kiếm/shop.

7. Cảnh báo & báo cáo Telegram

Sau mỗi lần quét nền, extension tự động gửi báo cáo cho mọi thứ đang theo dõi — không cần tự mở popup hay mở lại trang Etsy để xem:

Riêng cảnh báo bán hết & tự động renew không theo lịch quét — báo ngay khi phát hiện, và chỉ báo đúng 1 lần cho mỗi sự kiện (không lặp lại ở các lần quét sau):

🔥 Sold out & renewed: <tên listing>
"Sold out and automatically renewed after N.N days." kèm link listing.

Ví dụ tin nhắn thật

Đây là 3 loại tin nhắn phổ biến nhất, rút gọn cho dễ đọc — chữ thật sẽ có link bấm được vào listing/shop:

📊 Top 15 — "cat mom sweatshirt"
1. Cat Mom Sweatshirt Funny Cat Lover Gift — 87 pts · ≈23 sold
2. Cute Cat Mom Hoodie Pet Owner Shirt — 81 pts · ≈19 sold
3. Crazy Cat Lady Sweatshirt Cat Mama Tee — 76 pts · ≈15 sold
… (tối đa 15 dòng)
📦 Listing update: Cat Mom Sweatshirt Funny Cat Lover Gift
Sold: +3 since last scan · Views: +58 (412 total) · Favorites: +7 (96 total) · Reviews: +2 (214 total)
https://www.etsy.com/listing/123456789
🏪 Shop update: CatMomCrafts
Active: 142 (▲3) · Sales: 8,204 (▲41) · Reviews: 3,912 (▲12) · Listing Favs: 22,105 (▲310)

🔥 Top sellers:
1. Cat Mom Sweatshirt Funny Cat Lover Gift — ≈2.1/day
2. Custom Cat Portrait Ornament — ≈1.4/day

🆕 New listings:
1. Cat Dad Coffee Mug Funny Pet Gift

https://www.etsy.com/shop/CatMomCrafts

Theo dõi càng nhiều từ khóa/listing/shop, số tin nhắn mỗi lần quét càng nhiều — cân nhắc dùng 1 nhóm Telegram riêng nếu thấy dồn dập.

Cách thiết lập (Bot token + Chat ID) xem chi tiết từng bước tại Hướng dẫn cài đặt — mục Telegram.

8. Xuất dữ liệu (CSV)

Trong tab Saved, bấm "⬇ Export CSV" để tải toàn bộ danh sách đã lưu (không phải toàn bộ watchlist) ra file .csv gồm: Title, URL, Type, Views, Daily Views, Favorites, Saved At. File có BOM UTF-8 nên mở bằng Excel không bị lỗi font tiếng Việt.

9. Câu hỏi thường gặp / Khắc phục sự cố

Thu hồi license nhưng thiết bị vẫn dùng được? Bình thường — extension chỉ xác nhận lại license khi mở popup, trước mỗi lần quét nền, hoặc khi bấm "Scan Now". Thu hồi có hiệu lực ở lần xác nhận kế tiếp, không phải ngay lập tức.

Mất mạng tạm thời có bị khóa extension không? Không — nếu lần xác nhận license thất bại do lỗi mạng (không phải do server trả lời "không hợp lệ"), extension giữ nguyên trạng thái hợp lệ gần nhất, tránh khóa nhầm người đang trả phí.

"API key is invalid or has expired": kiểm tra lại đã copy đúng cả Keystring và Shared secret chưa (không dính khoảng trắng thừa).

"The Etsy API is rate-limiting requests (429)": Etsy giới hạn khoảng 10 request/giây, 10.000 request/ngày cho mỗi key — chờ vài phút rồi thử lại.

Panel shop hiện "—" ở ô Sales? Số liệu này đọc trực tiếp từ giao diện trang shop Etsy — nếu Etsy đổi giao diện, số này có thể tạm thời không đọc được; các chỉ số khác không bị ảnh hưởng.

Tab Top không hiện điểm số nào? Sau khi chọn từ khóa (hoặc để "All keywords"), bạn phải bấm nút "View" — điểm số không tự tính khi mở tab. Nếu vẫn hiện "not enough data" thì cần thêm ít nhất 2 lần quét cách nhau vài ngày cho từ khóa đó.

Bật Telegram bị Chrome hỏi thêm quyền truy cập api.telegram.org? Bình thường — extension chỉ xin quyền này đúng lúc bạn bật toggle (không xin sẵn khi cài đặt) để hạn chế quyền truy cập ở mức tối thiểu cần thiết. Bấm "Allow" là xong; nếu lỡ bấm "Block", chỉ cần tắt rồi bật lại toggle để Chrome hỏi lại.

Thanh toán PayPal/Pingpong bao lâu thì được kích hoạt? Đây là quy trình thủ công — sau khi bấm "Tôi đã thanh toán," đội ngũ xác minh và kích hoạt trong vài giờ, không phải tức thì như thanh toán thẻ.

Vẫn còn thắc mắc? Xem thêm ở Hướng dẫn cài đặt, hoặc liên hệ hỗ trợ qua support@bestsy.app hay Telegram.