Appearance
📖 Tham Chiếu Lệnh CLI
Tài liệu đầy đủ tất cả các lệnh CLI của GBS Crawler. Mỗi lệnh kèm bảng tham số và ví dụ thực tế.
Tổng Quan
GBS Crawler cung cấp CLI thông qua thư viện click. Có 2 cách gọi:
bash
# Cách 1: Dùng lệnh tắt (khuyến nghị)
gbs <command> [options]
# Cách 2: Chạy trực tiếp qua uv
uv run main.py <command> [options]gbs login — Đăng Nhập Vào Sàn TMĐT
Mở trình duyệt Chrome để người dùng đăng nhập tay. Cookie/Session sẽ được tự động lưu vào thư mục profiles/.
Tham số
| Cờ | Viết tắt | Bắt buộc | Mô tả | Ví dụ |
|---|---|---|---|---|
--customer | -c | ✅ | ID khách hàng (phải tồn tại trong customers.csv) | vita_dairy |
--marketplace | -m | ✅ | Tên sàn TMĐT | shopee, tiktok, lazada |
Ví dụ
bash
# Đăng nhập Shopee cho Vita Dairy
gbs login -c vita_dairy -m shopee
# Đăng nhập TikTok cho Dutch Lady
gbs login -c dutch_lady -m tiktokQuy trình thực tế
- Chạy lệnh → Trình duyệt Chrome mở lên trang Seller Center
- Nhập tài khoản/mật khẩu → Giải OTP/Captcha nếu có
- Khi thấy Dashboard Seller Center → Đóng trình duyệt hoặc
Ctrl+C - Terminal hiện:
✅ Session saved successfully!
gbs crawl — Chạy Tải Báo Cáo
Thực thi các job tải báo cáo theo cấu hình crawl_jobs.csv. Hỗ trợ lọc theo khách hàng, sàn, loại báo cáo.
Tham số
| Cờ | Viết tắt | Bắt buộc | Mô tả | Ví dụ |
|---|---|---|---|---|
--customer | -c | ❌ | Lọc theo ID khách hàng | vita_dairy |
--marketplace | -m | ❌ | Lọc theo sàn | shopee |
--report | -r | ❌ | Lọc theo loại báo cáo | income |
--frequency | -f | ❌ | Lọc theo tần suất | daily, monthly |
--headless / --no-headless | — | ❌ | Ẩn/hiện trình duyệt (mặc định: --no-headless) | — |
--dry-run | — | ❌ | Chỉ liệt kê job, không chạy thật | — |
Ví dụ
bash
# Chạy tất cả job đang bật
gbs crawl
# Chỉ chạy cho 1 khách hàng
gbs crawl -c vita_dairy
# Chỉ chạy Shopee
gbs crawl -c vita_dairy -m shopee
# Chỉ chạy báo cáo thu nhập
gbs crawl -r income
# Chỉ chạy báo cáo hàng ngày
gbs crawl -f daily
# Xem trước danh sách job (không chạy thật)
gbs crawl --dry-run
# Chạy hiện trình duyệt (để debug)
gbs crawl --no-headless -c vita_dairy -m shopee
# Kết hợp nhiều bộ lọc
gbs crawl -c vita_dairy -m shopee -r incomeCơ chế Retry
- Nếu job bị Timeout, hệ thống tự động thử lại 1 lần sau 2 giây
- Nếu job gặp CrawlerException (lỗi nghiệp vụ), hệ thống gửi cảnh báo Telegram và tiếp tục job tiếp theo
gbs status — Xem Trạng Thái Hệ Thống
Hiển thị danh sách Chrome Profile và trạng thái session, cùng danh sách crawler đã đăng ký.
Tham số
| Cờ | Viết tắt | Bắt buộc | Mô tả | Ví dụ |
|---|---|---|---|---|
--customer | -c | ❌ | Lọc theo ID khách hàng | vita_dairy |
Ví dụ
bash
# Xem tất cả
gbs status
# Chỉ xem 1 khách hàng
gbs status -c vita_dairygbs schedule — Chạy Tự Động Hằng Ngày
Khởi chạy scheduler daemon (APScheduler). Hệ thống sẽ chạy nền và tự động tải báo cáo vào thời gian cấu hình (mặc định: 02:00 sáng mỗi ngày).
Tham số
| Cờ | Viết tắt | Bắt buộc | Mô tả |
|---|---|---|---|
--headless / --no-headless | — | ❌ | Mặc định --headless. Dùng --no-headless để debug |
Ví dụ
bash
# Bật scheduler (chạy ẩn)
gbs schedule
# Bật scheduler + hiện trình duyệt (debug)
gbs schedule --no-headlessLưu ý
- Phải giữ terminal mở hoặc dùng
tmux/screen/systemd - Scheduler tự reload cấu hình mỗi lần chạy → thêm job vào CSV là có hiệu lực
Ctrl+Cđể dừng scheduler
CLI Quản Lý (scripts/gbs_ops.py)
Công cụ phụ trợ để quản lý khách hàng và tìm kiếm file báo cáo nhanh.
Cú pháp chung
bash
uv run scripts/gbs_ops.py <command> <subcommand> [options]Lệnh client add
bash
uv run scripts/gbs_ops.py client add --name "Tên Khách Hàng"Tạo thư mục profile mới: profiles/Tên Khách Hàng/ và thư mục Variations/.
Lệnh client remove
bash
uv run scripts/gbs_ops.py client remove --name "Tên Khách Hàng"Xóa thư mục profile. Cẩn thận: Không thể hoàn tác.
Lệnh report get
bash
uv run scripts/gbs_ops.py report get --client "Tên Khách Hàng"Tìm và liệt kê 5 file báo cáo mới nhất cho khách hàng đó. Hỗ trợ tìm kiếm tên gần đúng (fuzzy match).
📌 Xem thêm: Cấu hình chi tiết | Hướng dẫn sử dụng hằng ngày