본문으로 건너뛰기

Capzy Browser API. 연결하고 자동화하세요.

Chrome DevTools Protocol을 통해 Capzy 인프라에서 브라우저 자동화를 실행하세요. 원격 세션, 선택적 프록시, 영구 프로필과 함께 기존 Playwright 또는 Puppeteer 워크플로를 그대로 유지할 수 있습니다.

내 스크립트 → Capzy 브라우저CDP / WebSocket
내 애플리케이션chromium.connect_over_cdp(CDP_URL)
원격 브라우저 세션page.goto("https://example.com")
페이지 읽기, 상호작용, 결과 수집page.title() → "Example Domain"

연결 URL에서 첫 페이지까지

클라이언트를 설치하고 CDP URL을 복사한 다음 연결하세요. 인증에는 URL에 포함된 Browser API 사용자 이름과 비밀번호가 사용됩니다.

  1. Browser API 요금제 활성화

    워크로드에 필요한 동시 세션, 영구 프로필, 포함 대역폭을 갖춘 요금제를 선택하세요.

    Browser API 열기
  2. 연결 URL 복사

    개요에서 Browser API 사용자 이름과 비밀번호가 포함된 CDP URL을 복사하세요. CAPZY_CDP_URL로 저장하세요. 솔버 API 키와는 다릅니다.

  3. 연결하고, 작업하고, 닫기

    connect_over_cdp 또는 puppeteer.connect를 사용하세요. 제공된 컨텍스트에서 페이지를 만들고, finally 블록에서 브라우저를 닫아 세션을 해제하세요.

remote_browser.py
# Install: pip install playwright
import os
from playwright.sync_api import sync_playwright

# Copy your full authenticated URL from Dashboard > Browser API.
# Shape: wss://USERNAME:[email protected]/cdp
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(os.environ["CAPZY_CDP_URL"])
    try:
        page = browser.contexts[0].new_page()
        page.goto("https://example.com", wait_until="domcontentloaded")
        print(page.title())
    finally:
        browser.close()

워크플로마다 필요한 연결 제공

인증된 CDP URL에 쿼리 매개변수를 추가하세요. 다음 연결에서도 같은 신원을 사용하려면 고정된 프로필 이름을 유지하세요.

username:password필수 · URL 자격 증명
대시보드에서 복사한 전체 URL을 사용하세요. 직접 만드는 경우 사용자 이름과 비밀번호의 예약 문자를 퍼센트 인코딩하세요.
profile=my-identity선택 · 영구 유지
프로필 이름을 재사용하면 지원되는 브라우저 상태가 세션 간에 유지됩니다. 프로필은 요금제의 프로필 허용량에 포함됩니다.
proxy=capzy-US선택 · 미국 프록시
내장 프록시 옵션으로 지원되는 국가를 선택하세요. 자동 위치는 proxy=capzy, 프록시가 필요 없으면 proxy=none을 사용하세요.
인증된 CDP 연결
wss://USERNAME:[email protected]/cdp?profile=my-identity&proxy=capzy-US
대시보드 → Browser API → 개요에서 전체 연결 URL을 받으세요. 비공개로 유지하세요.

요금

요금제는 동시 브라우저 세션, 저장된 프로필, 포함 대역폭으로 구분됩니다. 맞춤 구성기는 현재 공개 요금을 사용합니다.

현재 가격 로드 중…

현재 가격 로드 중…

알아 두면 좋은 내용

Browser API와 Capium Browser 중 무엇을 써야 하나요?

Browser API는 Capzy 인프라에서 브라우저를 호스팅하고 CDP를 제공합니다. Capium Browser는 내 컴퓨터에서 브라우저를 실행하는 SDK입니다. 원격 용량이 필요하면 Browser API를 선택하세요.

CDP 연결이 실패하는 이유는 무엇인가요?

요금제가 활성 상태인지, 사용자 이름과 비밀번호가 대시보드와 일치하는지, 애플리케이션이 보안 WebSocket에 접근할 수 있는지 확인하세요. 동시 세션 허용량을 모두 사용한 경우에도 새 연결이 차단될 수 있습니다.

Selenium이 필요한가요?

여기의 예제는 Playwright와 Puppeteer를 사용합니다. Selenium은 적절한 CDP 연결 설정이 필요합니다. webdriver.Remote에 WebSocket URL을 전달하지 말고 Browser API 연결 가이드를 따르세요.

다음 브라우저는 여기서 실행할 수 있습니다.

용량을 선택하고 연결 URL을 복사한 다음 위의 예제로 시작하세요.

대시보드 열기