Установите, авторизуйтесь и управляйте.
Capium Browser: наш собственный стелс-Chrome с лицензией по числу сессий, устанавливается одной командой. Укажите лицензионный ключ и управляйте им локально через знакомый API Playwright.
Управляйте как в Playwright
Переходы, клики, ввод текста, ожидание селекторов и сети. Стандартный API Playwright работает без изменений.
Настоящий стелс-Chrome
Подлинное, всегда актуальное ядро Chrome, защищённое от обнаружения ботов, а не headless-заглушка или пропатченная обёртка.
Скриншоты и PDF
Делайте скриншоты всей страницы или сохраняйте любую страницу в PDF точно так же, как в локальном браузере.
Одновременные сессии
Запускайте несколько браузеров одновременно. Каждый активный браузер считается одной сессией в рамках лимита тарифа.
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)- Если ключ когда-либо утечёт, перевыпустите его в панели управления. Старый ключ сразу перестанет работать.
- Одна активная лицензия на аккаунт. Старшие уровни увеличивают число одновременных сессий.
- Ключ авторизует бинарник, отдельный вход или cookie не требуются.
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 повторяет синхронный: launch_context_async возвращает ту же тройку (browser, context, page) с awaitable-методами Playwright.
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. Сессии и параллельность
Каждый активный браузер: одна сессия. Лимит сессий тарифа определяет, сколько их можно запускать одновременно. Закрывайте браузер после работы, чтобы освободить сессию.
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. Там его можно показать, скопировать или перевыпустить. Храните его в секрете, как пароль.
Нужно ли что-то скачивать вручную?›
Нет. При первом запуске инструментарий загружает последний защищённый бинарник для вашей ОС и автоматически поддерживает его актуальным.
Какие языки и драйверы поддерживаются?›
Основной язык: Python, со стандартным API Playwright, который вы уже используете. Пакет для JavaScript/TypeScript устанавливается из npm как capiumbrowser.
Что считается сессией?›
Один запущенный экземпляр браузера. Лимит сессий тарифа: сколько их можно запускать одновременно, а не общее количество за месяц.
Пробный период заканчивается?›
Да. Пробный период даёт одну сессию браузера на 30 дней, затем он заканчивается. Перейти на платный тариф ради большего числа сессий и поддержки можно в любой момент.
Готовы начать?
Получите лицензионный ключ и запустите первую стелс-сессию за считанные минуты.