클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

Oxylabs 헤드리스 브라우저

Playwright·Puppeteer로 Oxylabs 원격 헤드리스 크롬(CDP)에 붙어 봇 차단 사이트를 안정적으로 크롤링하도록 안내하는 스킬.

웹·API 연동중급★ 874⑂ 2AI 점수 8/10마지막 업데이트: 2026. 9. 24.

무엇을 해주나

  • wss://USER:PASS@hb.oxylabs.io 엔드포인트에 Playwright connectOverCDP 또는 Puppeteer connect로 접속하는 정확한 URL 작성 규칙을 알려준다(비밀번호를 new URL()로 감싸면 401이 나는 함정까지).
  • 재시도해도 되는 에러(429, 5xx, CDP_BAD_PROXY 등)와 재시도하면 안 되는 에러(400/401/403)를 구분하고, 지수 백오프·비밀번호 마스킹·finally에서의 browser.close() 같은 필수 패턴을 강제한다.
  • 세션/동시성/프로필/녹화 한도표와 session_name, o_profile, proxy_resi_ses_id 같은 파라미터의 올바른 조합을 정리한다.
  • DataDome·Cloudflare·Akamai 등에 막혔을 때 "새 세션 → 지역 확대 → 모바일 디바이스 → 속도 늦추기 → 라이브 VNC 점검 → 사용자에게 영구 프로필 제안" 순서의 단계적 대응 사다리를 제공한다.
  • 스트리밍·금융·정부·티켓팅 등 기본 차단 대상(1337 Invalid target)도 명시한다.

이런 분께 추천

  • Oxylabs 헤드리스 브라우저(또는 Web Unblocker) 계정을 이미 보유한 데이터 수집 엔지니어
  • JS 렌더링 페이지 때문에 WebFetch가 실패해 실제 브라우저 세션이 필요한 사람
  • 클로드에게 스크래핑 스크립트 작성을 맡기되, 세션 누수·무한 재시도 같은 사고를 막고 싶은 팀

활용 예시

  1. "미국 IP로 이 상품 페이지를 렌더링해서 가격 뽑아줘" → ?p_cc=US만 붙인 최소 세션으로 이미지·폰트를 차단한 Playwright 스크립트를 생성.
  2. "계속 403 차단 페이지가 뜬다" → X-Error-Description 헤더 유무로 Oxylabs 장애인지 타깃 차단인지 판별하고, 에스컬레이션 사다리를 한 단계씩 적용.
  3. "로그인 상태를 유지한 채 매일 수집하고 싶다" → o_profile_save=true 셋업 런 1회 + 읽기 전용 컨슈머 런 구조를 제안하고 프로필 5개 한도를 함께 안내.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/oxylabs/agent-skills/HEAD/skills/headless-browser/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 oxylabs/agent-skills 의 skills/headless-browser 폴더를 내 ~/.claude/skills/headless-browser/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/oxylabs/agent-skills.git && mkdir -p ~/.claude/skills && cp -r agent-skills/skills/headless-browser ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 연다.
  2. 저장소를 내려받는다: git clone https://github.com/oxylabs/agent-skills.git
  3. 스킬 폴더를 만든다: mkdir -p ~/.claude/skills
  4. 스킬을 복사한다: cp -r agent-skills/skills/headless-browser ~/.claude/skills/
  5. Oxylabs 대시보드에서 발급받은 자격 증명을 환경변수로 등록한다: export OXY_UNBLOCKER_USERNAME=..., export OXY_UNBLOCKER_PASSWORD=... (셸 프로필에 넣어두면 편하다).
  6. 작업 폴더에 npm i playwright 또는 pip install playwright 로 CDP 클라이언트를 준비한다.
  7. Claude Code를 재시작하고 "Oxylabs 헤드리스 브라우저로 이 URL 렌더링해줘"처럼 요청하면 스킬이 발동한다.
GitHub에서 원본 보기 ↗라이선스: MIT