Tài liệuTrình duyệt và CrawlAgent BrowserBắt đầu

Bắt đầu

Lấy API Key của bạn

Truy cập bảng điều khiển Agent Browser và lấy API key của bạn trong tab cài đặt. Chúng ta sẽ sử dụng API key này trong các bước tiếp theo.

get-api-key.png

Tham số

Tên tham sốKiểuMô tả
tokenstringAPI key được tạo trong bảng điều khiển.
sessionTTLnumberKiểm soát thời lượng phiên và tự động đóng phiên bản trình duyệt sau khi hết thời gian. Đo bằng giây (s), mặc định là 180 giây (3 phút), có thể tùy chỉnh trong khoảng từ 60 giây (1 phút) đến 900 giây (khuyến nghị tối đa 15 phút, nhưng có thể đặt thời gian dài hơn). Khi đạt đến TTL được chỉ định, phiên sẽ hết hạn và Agent Browser sẽ đóng phiên bản trình duyệt để giải phóng tài nguyên.
sessionNamestringĐặt tên cho phiên của bạn để thuận tiện cho việc tìm kiếm và xem trong danh sách phiên lịch sử.
sessionRecordingbooleanCó bật ghi lại phiên hay không. Khi được bật, toàn bộ quá trình thực thi phiên trình duyệt sẽ được tự động ghi lại, và sau khi phiên hoàn tất, có thể phát lại và xem trong chi tiết danh sách phiên lịch sử. Mặc định là false.
proxyURLstringDùng để đặt URL proxy của trình duyệt, ví dụ: http://user:pass@ip:port. Nếu tham số này được đặt, tất cả các tham số proxy_* khác sẽ bị bỏ qua.

💡Chức năng proxy tùy chỉnh hiện chỉ khả dụng cho người đăng ký. Nâng cấp tại đây
proxyCountrystringChỉ định quốc gia/khu vực mục tiêu cho việc định tuyến proxy, dẫn các yêu cầu qua các địa chỉ IP từ vị trí đã chọn. Chấp nhận mã quốc gia ISO (ví dụ: US cho Hoa Kỳ, GB cho Vương quốc Anh, ANY để chọn ngẫu nhiên). Hỗ trợ 195+ quốc gia và vùng lãnh thổ. Khi kết hợp với proxyState và proxyCity, cho phép nhắm mục tiêu địa lý chính xác đến cấp thành phố.
proxyStatestring(Tùy chọn) Chỉ định bang/tỉnh mục tiêu trong quốc gia đã chọn để định tuyến proxy chi tiết hơn. Phải được sử dụng kết hợp với proxyCountry. Chấp nhận mã bang (ví dụ: CA cho California, NY cho New York). Khả dụng cho các quốc gia được chọn có phân chia bang/tỉnh xác định. tìm hiểu thêm
proxyCitystring(Tùy chọn) Chỉ định thành phố mục tiêu trong bang/tỉnh đã chọn để định tuyến proxy ở cấp thành phố. Phải được sử dụng kết hợp với proxyCountry và proxyState. Cung cấp khả năng nhắm mục tiêu địa lý chính xác nhất. Tính khả dụng phụ thuộc vào hạ tầng proxy ở các thành phố cụ thể. tìm hiểu thêm
extensionIdsstringthiết lập tiện ích mở rộng trình duyệt theo id tiện ích, phân tách bằng dấu phẩy cho nhiều tiện ích
fingerprintstringDấu vân tay trình duyệt là một “dấu vân tay số” gần như duy nhất được tạo bằng thông tin cấu hình trình duyệt và thiết bị của bạn, có thể được sử dụng để theo dõi hoạt động trực tuyến của bạn ngay cả khi không có cookie. May mắn thay, việc cấu hình dấu vân tay trong Agent Browser là tùy chọn. Chúng tôi cung cấp khả năng tùy chỉnh sâu dấu vân tay trình duyệt, chẳng hạn như các tham số cốt lõi như user agent của trình duyệt, múi giờ, ngôn ngữ và độ phân giải màn hình, và hỗ trợ mở rộng chức năng thông qua các tham số khởi chạy tùy chỉnh. Phù hợp cho các kịch bản quản lý nhiều tài khoản, thu thập dữ liệu và bảo vệ quyền riêng tư, việc sử dụng trình duyệt Chromium riêng của scrapeless hoàn toàn tránh được sự phát hiện. Theo mặc định, dịch vụ Agent Browser của chúng tôi tạo một dấu vân tay ngẫu nhiên cho mỗi phiên. Tham khảo

Ví dụ về một URL kết nối WebSocket Agent Browser hoàn chỉnh:

wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=ANY
wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=US&proxyState=CA&proxyCity=Los%20Angeles
wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyURL=proxyURL

Lưu ý: Khi proxyURL được chỉ định, nó được ưu tiên, và các tham số liên quan đến proxy khác (proxyCountry, proxyState, proxyCity) sẽ bị bỏ qua. Các tham số proxy địa lý phải được sử dụng cùng nhau: proxyState yêu cầu proxyCountry, và proxyCity yêu cầu cả proxyCountry và proxyState.