Cài đặt, xác thực và điều khiển.
Capium Browser là Chrome ẩn danh độc quyền của chúng tôi, cấp phép theo phiên và cài đặt chỉ bằng một lệnh. Thêm license key và điều khiển cục bộ bằng API Playwright mà bạn đã biết.
Điều khiển như Playwright
Điều hướng, nhấp, gõ, chờ selector và mạng. API Playwright gốc hoạt động mà không cần thay đổi.
Chrome ẩn danh thật
Lõi Chrome chính hãng, luôn mới nhất, được gia cố chống phát hiện bot, không phải stub headless hay wrapper được vá.
Ảnh chụp màn hình và PDF
Chụp ảnh toàn trang hoặc xuất bất kỳ trang nào ra PDF, giống hệt như với trình duyệt cục bộ.
Phiên đồng thời
Chạy nhiều trình duyệt cùng lúc. Mỗi trình duyệt đang chạy tính là một phiên trong giới hạn của gói.
1. Bắt đầu
Cài đặt bộ công cụ cho ngôn ngữ của bạn. Không cần tự host và không cần vá gì. Binary ẩn danh được tải ở lần chạy đầu và tự động cập nhật.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserThêm license key và điều khiển trang đầu tiên. Bật humanize=True để có thao tác nhập và thời gian giống người thật.
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. Xác thực
License key nằm trên bảng điều khiển, mục Capium Browser. Hiển thị, sao chép hoặc cấp lại key tại đó. Hãy giữ bí mật và nạp key từ biến môi trường thay vì viết cứng trong code.
# 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)- Cấp lại key từ bảng điều khiển nếu key bị lộ. Key cũ ngừng hoạt động ngay lập tức.
- Mỗi tài khoản một giấy phép đang hoạt động. Bậc cao hơn tăng số phiên chạy cùng lúc.
- Key cấp quyền cho binary; không cần đăng nhập hay cookie riêng.
3. Điều khiển bằng Playwright (Python)
Mọi thứ bạn biết từ Playwright đều hoạt động: locator, wait, chặn bắt mạng và nhiều hơn nữa. Capium chỉ thay vào một lõi Chrome thật đã được gia cố.
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. Async API
Async API tương ứng với bản sync: launch_context_async trả về cùng bộ ba (browser, context, page) với các phương thức Playwright dùng await.
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. Chế độ Humanize
Truyền humanize=True khi khởi chạy sẽ thêm thao tác nhập và thời gian giống người thật: chuyển động chuột tự nhiên, nhịp gõ chân thực và các khoảng dừng ngắn thay đổi, cùng các helper page.human_type và page.human_scroll. Hãy bật cho các luồng tương tác; tắt đi khi chỉ cần tải và phân tích dữ liệu, nơi tốc độ là quan trọng.
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. Phiên và đồng thời
Mỗi trình duyệt đang chạy là một phiên. Giới hạn phiên của gói là số phiên bạn có thể chạy cùng lúc. Đóng trình duyệt khi xong việc để giải phóng phiên.
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. Công thức mẫu: ảnh chụp màn hình và 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. Nền tảng và CI
Binary gốc có sẵn cho Linux, Windows và macOS, hoạt động giống hệt nhau trên laptop, CI runner và hệ thống máy của bạn. Trong CI, hãy đặt license key làm biến môi trường bí mật:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. Khắc phục sự cố
Xác nhận key khớp với bảng điều khiển và giấy phép (hoặc bản dùng thử) của bạn vẫn còn hiệu lực. Cấp lại key nếu cần.
Bạn đang chạy số trình duyệt tối đa mà gói cho phép. Đóng các trình duyệt đã xong, hoặc nâng cấp để có giới hạn phiên cao hơn.
Binary được tải ở lần chạy đầu; hãy cho phép HTTPS ra ngoài. Trong CI bị khóa chặt, hãy cache bộ công cụ giữa các lần chạy.
10. Câu hỏi thường gặp
License key của tôi ở đâu?›
Trên bảng điều khiển, mục Capium Browser. Hiển thị, sao chép hoặc cấp lại key tại đó. Hãy giữ bí mật; coi nó như mật khẩu.
Tôi có cần tải gì về thủ công không?›
Không. Bộ công cụ tự tải binary gia cố mới nhất cho hệ điều hành của bạn ở lần chạy đầu tiên và tự động cập nhật.
Hỗ trợ những ngôn ngữ và driver nào?›
Python là chuẩn chính, điều khiển bằng API Playwright gốc mà bạn đã quen dùng. Gói JavaScript/TypeScript được cài với tên capiumbrowser trên npm.
Thế nào được tính là một phiên?›
Một phiên bản trình duyệt đang chạy. Giới hạn phiên của gói là số phiên bạn có thể chạy đồng thời, không phải tổng số mỗi tháng.
Bản dùng thử miễn phí có hết hạn không?›
Có. Bản dùng thử cho bạn một phiên trình duyệt trong 30 ngày, sau đó kết thúc. Nâng cấp bất cứ lúc nào để có thêm phiên và hỗ trợ.
Sẵn sàng bắt đầu?
Lấy license key và chạy phiên ẩn danh đầu tiên trong vài phút.