Trình duyệt Headless Oxylabs
Hướng dẫn Claude kết nối tới trình duyệt headless từ xa của Oxylabs qua CDP bằng Playwright/Puppeteer để cào dữ liệu các trang chặn bot.
Web · APITrung cấp★ 874⑂ 2Điểm AI 8/10Cập nhật lần cuối: 24 thg 9, 2026
Làm được gì
- Đưa ra quy tắc chính xác để dựng URL
wss://USER:PASS@hb.oxylabs.iovà kết nối bằng PlaywrightconnectOverCDPhoặc Puppeteerconnect(kể cả bẫy khiến lỗi 401 khi mã hoá mật khẩu quanew URL()). - Phân loại lỗi nên retry (429, 5xx,
CDP_BAD_PROXY...) và lỗi phải sửa ngay (400/401/403), kèm backoff luỹ thừa, che mật khẩu trong log, luônbrowser.close()trongfinally. - Bảng giới hạn phiên, đồng thời, profile, bản ghi hình và cách dùng đúng
session_name,o_profile,proxy_resi_ses_id. - Thang leo thang khi bị DataDome/Cloudflare/Akamai chặn: phiên mới → nới vùng địa lý → thiết bị mobile → chậm lại → xem trực tiếp qua VNC → đề xuất profile bền vững cho người dùng.
- Danh sách nhóm trang bị chặn mặc định (streaming, ngân hàng, chính phủ, vé...) trả về lỗi
1337 Invalid target.
Phù hợp với ai
- Kỹ sư thu thập dữ liệu đã có tài khoản Oxylabs Headless Browser / Web Unblocker.
- Người cần trình duyệt thật vì trang render bằng JavaScript và
WebFetchkhông đủ. - Nhóm muốn Claude viết script cào dữ liệu nhưng tránh rò rỉ phiên và retry vô tận.
Ví dụ sử dụng
- "Render trang sản phẩm này bằng IP Mỹ và lấy giá" → sinh script Playwright tối giản với
?p_cc=US, chặn tải ảnh/font. - "Trang cứ hiện tường 403" → kiểm tra header
X-Error-Descriptionđể biết lỗi phía Oxylabs hay do trang đích chặn, rồi áp dụng từng bậc thang leo thang. - "Cần giữ trạng thái đăng nhập giữa các lần chạy" → đề xuất mô hình một lần chạy setup với
o_profile_save=truevà nhiều lần chạy consumer chỉ đọc, nêu rõ giới hạn 5 profile.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/oxylabs/agent-skills/HEAD/skills/headless-browser/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/headless-browser từ repo GitHub oxylabs/agent-skills vào ~/.claude/skills/headless-browser/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/oxylabs/agent-skills.git && mkdir -p ~/.claude/skills && cp -r agent-skills/skills/headless-browser ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Tải mã nguồn:
git clone https://github.com/oxylabs/agent-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r agent-skills/skills/headless-browser ~/.claude/skills/ - Khai báo thông tin đăng nhập Oxylabs:
export OXY_UNBLOCKER_USERNAME=...vàexport OXY_UNBLOCKER_PASSWORD=...(nên thêm vào file cấu hình shell). - Cài thư viện CDP trong dự án:
npm i playwrighthoặcpip install playwright. - Khởi động lại Claude Code và yêu cầu ví dụ: "Dùng Oxylabs headless browser để render URL này".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT