Hướng dẫn sử dụng “Quét SĐT Web BĐS”

Công cụ Chrome Extension hỗ trợ quét tên & số điện thoại công khai từ các trang bất động sản theo khu vực, tự động chuyển trang, chống trùng (de-dupe), lưu trữ cục bộ và xuất CSV.

Phiên bản hiện tại: v0.0.1
Tải gói extension (zip) để giải nén và cài đặt dạng Load unpacked.
Tải extension v0.0.1 (.zip)

Cài đặt extension (Load unpacked)

Extension được phân phối dưới dạng thư mục (chưa đóng gói qua Chrome Web Store), cần cài bằng chế độ Developer mode trong Chrome (Load unpacked).

Mở trang quản lý Extensions

Bấm vào menu 3 chấm ở góc trên bên phải Chrome, chọn Extensions → Manage Extensions.

Chrome Menu - Extensions → Manage Extensions
Menu Chrome → Extensions → Manage Extensions

Bật Developer mode

Trên trang Extensions, bật công tắc Developer mode ở góc trên bên phải.

Chrome Extensions - bật Developer mode
Bật Developer mode ở góc trên bên phải trang Extensions

Load unpacked extension

Sau khi bật Developer mode, Chrome hiển thị các nút Load unpacked, Pack extension, Update. Tải file quet-sdt-web-bds-v0.0.1.zip (v0.0.1) ở trên, giải nén, rồi bấm Load unpacked và chọn thư mục đã giải nén (thư mục chứa file manifest.json của extension “Quét SĐT Web BĐS”).

Sau khi cài, ghim extension lên thanh công cụ nếu cần và mở trang web được hỗ trợ để sử dụng (xem các bước bên dưới).

Danh sách website hỗ trợ

WebsiteKhu vựcCách lấy dữ liệuGhi chú
batdongsan.vn Hà Nội, Đà Nẵng, TP.HCM (theo danh mục bán nhà / bán đất) Duyệt danh sách tin, tự mở ngầm trang chi tiết từng tin để lấy SĐT (thuộc tính hiển thị số) và tên liên hệ công khai; tự chuyển trang /pN. Hỗ trợ chính, cào theo nhánh khu vực/loại tin.
alonhadat.com.vn Hà Nội, Đà Nẵng, TP.HCM (4 nhóm bán: nhà, biệt thự/NLK, đất thổ cư, đất nền/dự án) Lấy SĐT/tên công khai từ thẻ tin (và trang chi tiết nếu cần), tự chuyển trang /trang-N. Site có thể yêu cầu xác minh (captcha). Khi phát hiện, công cụ tạm dừng CAPTCHA_WAIT và tự tiếp tục sau khi bạn xác minh xong.

Mở rộng: Để bổ sung website muốn quét, gửi yêu cầu Team IT MKT (ghi chú này cũng hiển thị trên giao diện công cụ).

Các bước sử dụng

Chọn khu vực và bắt đầu quét

Chọn Khu vực (Hà Nội / Đà Nẵng / TP.HCM) rồi bấm Bắt đầu cào. Công cụ tự điều hướng tới danh sách đúng khu vực/nhánh, tự nhận diện vùng tin, quét lần lượt và tự chuyển trang/nhánh tiếp theo cho tới khi hết dữ liệu (hoặc bạn dừng).

Quét SĐT Web BĐS
Ẩn
Để bổ sung website muốn quét, gửi yêu cầu Team IT MKT.
Site: batdongsan
Khu vực:
Sẵn sàng quét: Đà Nẵng (tự chuyển trang/nhánh)
0
Đã quét
0
Số điện thoại
0
Trùng
0
Bỏ qua
0
Lỗi
1
Trang
Bắt đầu càoPauseResumeStopXuất CSVBắt đầu lại
1
Khu vực: chọn HN / Đà Nẵng / TP.HCM.
2
Bắt đầu cào: khởi chạy tự động theo khu vực đã chọn.
3
Thống kê: Đã quét, Số điện thoại (unique), Trùng, Bỏ qua, Lỗi, Trang.

Theo dõi tiến trình và danh sách thu được

Trong lúc chạy (RUNNING), panel cập nhật realtime: bộ đếm, trang hiện tại, log thao tác và danh sách lead (tên + SĐT). SĐT trùng được tự động gộp (de-dupe), chỉ tăng bộ đếm trùng.

Quét SĐT Web BĐS
Ẩn
Site: batdongsan | KV: Đà Nẵng
126
Đã quét
45
Số điện thoại
12
Trùng
69
Bỏ qua
0
Lỗi
4
Trang
Trạng thái: RUNNING - Đang tự cào
Bắt đầu càoPauseResumeStopXuất CSVBắt đầu lại
Chuyển trang tiếp: 4 Đã lưu SĐT: 09xxxxxxx ...
0912345678
Nguyễn Văn A
0987654321
Trần Thị B
1
Trạng thái & log: biết đang ở trang nào, đang chạy hay tạm dừng.
2
Danh sách lead: hiển thị SĐT và tên (không hiển thị link bài); tự de-dupe.

Tạm dừng, tiếp tục, dừng, bắt đầu lại

Các nút điều khiển cho phép can thiệp bất kỳ lúc nào. Tiến trình/điểm quét được lưu lại nên có thể tiếp tục hoặc khởi động lại theo nhu cầu.

Ý nghĩa nút

  • Pause: tạm dừng quét (giữ nguyên tiến độ, trạng thái PAUSED).
  • Resume: tiếp tục từ vị trí đã lưu.
  • Stop: dừng phiên quét hiện tại.
  • Bắt đầu lại: đặt lại tiến trình/phiên (tùy chọn giữ hoặc xóa dữ liệu lead đã thu thập) để quét lại từ đầu.
  • Xuất CSV: tải file CSV bất kỳ lúc nào (kể cả khi đang dừng/tạm dừng).

Mẹo vận hành

  • Nếu chuyển trang/tải lại, công cụ sẽ tự khôi phục phiên tự động (khi đang chạy) theo dữ liệu đã lưu.
  • Nếu gặp lỗi/kẹt trạng thái bất thường, dùng Bắt đầu lại để tạo phiên mới sạch.
  • Bộ đếm Số điện thoại là số SĐT duy nhất (unique) đã thu thập.

Xử lý xác minh (captcha) – tự tiếp tục

Một số website (đặc biệt alonhadat.com.vn) có thể yêu cầu xác minh. Khi phát hiện challenge, công cụ chuyển sang CAPTCHA_WAIT và tạm dừng quét. Sau khi bạn hoàn tất xác minh trên trang, công cụ tự phát hiện và tự tiếp tục quét — không cần bấm Resume thủ công.

Quét SĐT Web BĐS
Ẩn
Site: alonhadat | KV: Đà Nẵng
Trạng thái: CAPTCHA_WAIT - Đang chờ bạn giải captcha, sẽ tự tiếp tục...
Phát hiện CAPTCHA/chặn. Tạm dừng, vui lòng giải captcha... (Sau khi xác minh xong, công cụ sẽ tự tiếp tục)
Bắt đầu càoPauseResumeStopXuất CSVBắt đầu lại
1
CAPTCHA_WAIT: công cụ đang chờ bạn xác minh trên trang.
2
Sau khi xác minh xong, trạng thái tự về RUNNING và tiếp tục từ vị trí đang dở.

Xuất CSV và xem dữ liệu

Bấm Xuất CSV để tải file dữ liệu tại thời điểm hiện tại (dùng được cả khi đang chạy, tạm dừng hoặc đã dừng). File CSV chỉ gồm 2 cột: phone, name (mã hóa UTF-8 BOM, đọc tốt trên Excel) và chứa các SĐT đã được de-dupe.

Quét SĐT Web BĐS
Ẩn
260
Đã quét
45
Số điện thoại
—
...
Bắt đầu càoPauseResumeStopXuất CSVBắt đầu lại
Xuất CSV: bds_leads_batdongsan_YYYYMMDD_HHMM.csv (45 lead)
1
Xuất CSV: xuất toàn bộ lead duy nhất hiện có (phone, name).
2
Log: xác nhận tên file và số lượng lead đã xuất.
  • (1) Có thể xuất nhiều lần; mỗi lần phản ánh dữ liệu hiện tại trong bộ nhớ cục bộ.
  • (2) Nếu số dòng khác kỳ vọng, kiểm tra bạn đang mở đúng file vừa tải (tên file có mốc thời gian).

Lưu ý & xử lý sự cố nhanh

Quét SĐT Web BĐS — tài liệu hướng dẫn sử dụng. Cần bổ sung website hỗ trợ: gửi yêu cầu Team IT MKT.