설치, 인증, 그리고 제어.
Capium Browser는 세션 단위로 라이선스되고 명령 하나로 설치되는 Capzy의 자체 스텔스 Chrome입니다. 라이선스 키를 넣고 이미 익숙한 Playwright API로 로컬에서 제어하세요.
Playwright처럼 제어
탐색, 클릭, 입력, 선택자 및 네트워크 대기. 기본 Playwright API가 그대로 작동합니다.
실제 스텔스 Chrome
헤드리스 스텁이나 패치된 래퍼가 아닌, 봇 탐지에 강화된 항상 최신 정품 Chrome 코어입니다.
스크린샷 및 PDF
로컬 브라우저와 똑같이 전체 페이지 스크린샷을 캡처하거나 모든 페이지를 PDF로 렌더링하세요.
동시 세션
여러 브라우저를 동시에 실행하세요. 실행 중인 브라우저 하나가 요금제 한도에서 세션 1개로 계산됩니다.
1. 시작하기
사용하는 언어에 맞는 툴킷을 설치하세요. 직접 호스팅하거나 패치할 것이 없습니다. 스텔스 바이너리는 처음 실행할 때 가져오며 자동으로 최신 상태를 유지합니다.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowser라이선스 키를 넣고 첫 페이지를 제어해 보세요. 사람 같은 입력과 타이밍을 원하면 humanize=True를 켜세요.
from capiumbrowser import launch_context
# Your license key is on the dashboard: Dashboard -> Capium Browser.
# Export it once: export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# launch_context returns (browser, context, page); the always-latest
# stealth binary is downloaded on first run.
browser, ctx, page = launch_context(
seed=200123, # one seed = one coherent device
humanize=True, # human-like input + timing
url="https://example.com",
)
print(page.title())
browser.close()2. 인증
라이선스 키는 대시보드의 Capium Browser 아래에 있습니다. 그곳에서 표시, 복사 또는 재발급하세요. 비밀로 유지하고 코드에 하드코딩하지 말고 환경 변수에서 불러오세요.
# Keep the key out of source. Export it in your shell or CI:
# export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# The SDK reads it from the environment (or ~/.capium/license)
# automatically — nothing to pass in code.
from capiumbrowser import launch_context
browser, ctx, page = launch_context(seed=200123)- 키가 노출되면 대시보드에서 재발급하세요. 기존 키는 즉시 작동을 멈춥니다.
- 계정당 하나의 활성 라이선스. 상위 등급일수록 동시에 실행할 수 있는 세션 수가 늘어납니다.
- 키가 바이너리를 인증하므로 별도의 로그인이나 쿠키가 필요 없습니다.
3. Playwright로 제어 (Python)
로케이터, 대기, 네트워크 가로채기 등 Playwright에서 알던 모든 기능이 그대로 작동합니다. Capium은 강화된 실제 Chrome 코어로 교체할 뿐입니다.
from capiumbrowser import launch_context
browser, ctx, page = launch_context(seed=200123, humanize=True)
page.goto("https://example.com/login")
page.fill("#email", "[email protected]")
page.fill("#password", "hunter2")
page.click("button[type=submit]")
page.wait_for_url("**/dashboard")
# The Playwright API you already know: locators, waits, network, etc.
print(page.locator("h1").inner_text())
browser.close()4. 비동기 API
비동기 API는 동기 API와 동일하게 구성됩니다. launch_context_async는 await 가능한 Playwright 메서드를 갖춘 동일한 (browser, context, page) 세트를 반환합니다.
import asyncio
from capiumbrowser import launch_context_async
async def main():
browser, ctx, page = await launch_context_async(
seed=200123, humanize=True, url="https://example.com",
)
print(await page.title())
await browser.close()
asyncio.run(main())5. Humanize 모드
실행 시 humanize=True를 전달하면 자연스러운 마우스 움직임, 현실적인 타이핑 속도, 작고 가변적인 일시 정지 등 사람 같은 입력과 타이밍이 추가되며, page.human_type 및 page.human_scroll 헬퍼도 제공됩니다. 상호작용이 필요한 흐름에서는 켜 두고, 속도가 중요한 단순 가져오기 및 파싱 작업에서는 끄세요.
browser, ctx, page = launch_context(seed=200123, humanize=True)
page.human_type("#email", "[email protected]") # natural typing cadence
page.human_scroll(1200) # smooth, variable scrolling6. 세션 및 동시성
실행 중인 브라우저 하나가 세션 1개입니다. 요금제의 세션 한도는 동시에 실행할 수 있는 수입니다. 작업이 끝나면 브라우저를 닫아 세션을 해제하세요.
import concurrent.futures
from capiumbrowser import launch_context
def fetch(url, seed):
browser, ctx, page = launch_context(seed=seed, url=url)
title = page.title()
browser.close()
return title
# Each live browser counts as one session against your plan's cap.
urls = ["https://a.example", "https://b.example", "https://c.example"]
seeds = range(200001, 200001 + len(urls)) # one coherent device per worker
with concurrent.futures.ThreadPoolExecutor(max_workers=3) as pool:
print(list(pool.map(fetch, urls, seeds)))7. 레시피: 스크린샷 및 PDF
page.goto("https://example.com")
# Full-page screenshot
page.screenshot(path="shot.png", full_page=True)
# Render the page to a PDF
page.pdf(path="page.pdf", format="A4")8. 플랫폼 및 CI
Linux, Windows, macOS용 네이티브 바이너리가 제공되며 노트북, CI 러너, 플릿에서 동일하게 동작합니다. CI에서는 라이선스 키를 비밀 환경 변수로 설정하세요:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. 문제 해결
키가 대시보드의 키와 일치하는지, 라이선스(또는 체험판)가 아직 활성 상태인지 확인하세요. 필요하면 키를 재발급하세요.
요금제에서 허용하는 만큼 브라우저가 실행 중입니다. 완료된 브라우저를 닫거나, 더 높은 세션 한도로 업그레이드하세요.
바이너리는 처음 실행할 때 가져옵니다. 아웃바운드 HTTPS를 허용하세요. 제한된 CI 환경에서는 실행 간에 툴킷을 캐시하세요.
10. FAQ
라이선스 키는 어디에 있나요?›
대시보드의 Capium Browser 아래에 있습니다. 그곳에서 표시, 복사 또는 재발급할 수 있습니다. 비밀로 유지하고 비밀번호처럼 다루세요.
수동으로 다운로드해야 하는 것이 있나요?›
아니요. 툴킷이 처음 실행할 때 OS에 맞는 최신 강화 바이너리를 가져오고 자동으로 최신 상태를 유지합니다.
어떤 언어와 드라이버를 지원하나요?›
Python이 기본이며, 이미 사용 중인 기본 Playwright API로 제어합니다. JavaScript/TypeScript 패키지는 npm에서 capiumbrowser로 설치할 수 있습니다.
세션은 어떻게 계산되나요?›
실행 중인 브라우저 인스턴스 하나입니다. 요금제의 세션 한도는 월간 총량이 아니라 동시에 실행할 수 있는 수입니다.
무료 체험은 만료되나요?›
예. 체험판은 30일 동안 브라우저 세션 1개를 제공하며 이후 종료됩니다. 더 많은 세션과 지원이 필요하면 언제든지 업그레이드하세요.
시작할 준비가 되셨나요?
라이선스 키를 받고 몇 분 만에 첫 스텔스 세션을 실행해 보세요.