Trình duyệt Headless Oxylabs

Kết nối Playwright/Puppeteer tới trình duyệt headless từ xa của Oxylabs qua CDP để chống phát hiện bot, đổi proxy theo vùng và giải CAPTCHA.

Web · APITrung cấp★ 454⑂ 1Điểm AI 8/10Cập nhật lần cuối: 12 thg 8, 2026

Kỹ năng này làm gì

Hướng dẫn Claude kết nối tới trình duyệt headless từ xa của Oxylabs (Chrome, Firefox legacy) qua Chrome DevTools Protocol (CDP).
Cung cấp snippet sẵn dùng cho Playwright (Python/JS) và Puppeteer, không cần cài trình duyệt trên máy.
Bảng tham số kết nối: nhắm mục tiêu quốc gia/thành phố/bang Mỹ (p_cc, p_city, p_state), giả lập thiết bị (p_device), gỡ lỗi bằng VNC (o_vnc), tham số Chrome (bargs).
Quy trình xử lý CAPTCHA: lắng nghe các sự kiện oxylabs-captcha-solve-* và kích hoạt thủ công bằng window.postMessage cho hcaptcha, recaptcha, turnstile.
Nêu rõ giới hạn: 100 phiên đồng thời, 10 phiên/giây, và khi nào nên dùng Web Scraper API thay thế.

Phù hợp với ai

Kỹ sư thu thập dữ liệu đang dùng thuê bao Oxylabs.
Lập trình viên cần render các site nặng JavaScript hoặc bị chặn bot.
Nhóm chạy automation trên CI, nơi không tiện mở trình duyệt cục bộ.

Ví dụ sử dụng

"Mở trang sản phẩm này bằng IP Texas và lấy giá" → sinh URL wss kèm ?p_state=texas và code Playwright.
"Chụp ảnh và xuất PDF trang này ở chế độ mobile" → thêm p_device=mobile rồi viết code screenshot/PDF.
"Xử lý CAPTCHA Turnstile xuất hiện sau khi đăng nhập" → đăng ký listener trước khi điều hướng rồi gọi solve_captcha.

· · · 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.

↓ Tải ZIP

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 /tmp/oxylabs-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/oxylabs-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 repo: 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=... (thêm vào file cấu hình shell để dùng lâu dài).
Cài thư viện: pip install playwright hoặc npm i playwright / npm i puppeteer.
Khởi động lại Claude Code và yêu cầu ví dụ: "Dùng Oxylabs headless browser render trang này".

Xem mã nguồn trên GitHub ↗Giấy phép: MIT