# Python SDK
pip install capiumbrowser
# Or in a JavaScript / TypeScript project
npm install capiumbrowserWindows, macOS, Linux요금제는 동시 세션으로 측정
전체 제품 사이트 및 문서: capiumbrowser.com
첫 로컬 브라우저까지 세 단계
Python으로 시작하세요. SDK는 처음 실행할 때 브라우저 바이너리를 다운로드하므로, 첫 실행에는 시간과 네트워크 접근이 필요합니다.
SDK 설치 및 키 설정
pip 또는 npm으로 capiumbrowser를 설치하세요. 브라우저를 실행하는 프로세스의 환경에 CAPIUM_LICENSE_KEY를 설정하세요.
세션 실행 및 종료
launch_context는 browser, context, page를 반환합니다. 평소처럼 page로 작업한 다음 브라우저를 닫아 세션을 해제하세요.
# macOS / Linux: use the license key from your dashboard.
export CAPIUM_LICENSE_KEY='YOUR_CAPIUM_LICENSE_KEY'
# Then launch your script in this shell.
python first_browser.pyfrom capiumbrowser import launch_context
# Set CAPIUM_LICENSE_KEY before running this script.
# The browser binary downloads on first launch.
browser, context, page = launch_context(
seed=200123,
humanize=True,
url="https://example.com",
)
try:
print(page.title())
finally:
browser.close()대시보드에서 Capium Browser를 열고 요금제를 활성화한 다음 라이선스 키를 복사하세요. 이 키는 Capzy API 키와 별개입니다. 라이선스 키 받기
알아 두면 좋은 몇 가지 제어 옵션
스크립트 하나에서 워커 플릿으로 확장할 때 신원과 프로세스 수명 주기를 명시적으로 관리하세요.
CAPIUM_LICENSE_KEY필수 · 환경 변수- Capium 대시보드의 라이선스 키를 설정하세요. 컨테이너와 워커 프로세스에는 시크릿 구성을 통해 전달하세요.
seed선택 · 신원- 워크플로가 같은 일관된 기기를 사용해야 할 때 시드를 재사용하세요. 시드뿐 아니라 구성도 동일하게 유지하세요.
humanize선택 · 상호작용 동작- 워크플로에 적합한 경우 SDK의 사람 같은 입력 동작을 활성화하세요. 대상이 모든 요청을 수락한다는 보장은 없습니다.
url선택 · 시작 페이지- 실행 시 첫 URL을 지정하거나, 반환된 page로 탐색하세요. 작업이 끝나면 finally 블록에서 브라우저를 닫으세요.
요금
동시에 실행되는 브라우저 수를 기준으로 요금제를 정하세요. 동시 세션은 한 달 동안 보내는 총 요청 수와 다릅니다.
현재 가격 로드 중…
알아 두면 좋은 내용
Capium은 Capzy 서버에서 실행되나요?
Capium SDK는 설치한 컴퓨터에서 브라우저를 실행합니다. Capzy가 브라우저를 호스팅하고 CDP로 원격 연결하기를 원한다면 Browser API를 사용하세요.
첫 실행이 더 오래 걸리는 이유는 무엇인가요?
SDK는 처음 사용할 때 브라우저 바이너리를 다운로드합니다. 컴퓨터가 다운로드 서비스에 접근할 수 있는지, 프로세스에 브라우저 캐시를 쓸 권한이 있는지 확인하세요.
라이선스가 감지되지 않는 이유는 무엇인가요?
SDK를 실행하는 같은 셸, 컨테이너 또는 서비스에 CAPIUM_LICENSE_KEY가 설정되어 있는지 확인하세요. 라이선스가 활성 상태이고 사용 가능한 동시 세션이 있는지도 확인하세요.
로컬 세션 하나로 시작하세요.
라이선스 키를 받고 Python 예제를 실행한 다음 워크로드에 맞게 동시성을 확장하세요.
