Перейти к содержимому
Как пользоваться Capium Browser

Установите, авторизуйтесь и управляйте.

Capium Browser: наш собственный стелс-Chrome с лицензией по числу сессий, устанавливается одной командой. Укажите лицензионный ключ и управляйте им локально через знакомый API Playwright.

Управляйте как в Playwright

Переходы, клики, ввод текста, ожидание селекторов и сети. Стандартный API Playwright работает без изменений.

Настоящий стелс-Chrome

Подлинное, всегда актуальное ядро Chrome, защищённое от обнаружения ботов, а не headless-заглушка или пропатченная обёртка.

Скриншоты и PDF

Делайте скриншоты всей страницы или сохраняйте любую страницу в PDF точно так же, как в локальном браузере.

Одновременные сессии

Запускайте несколько браузеров одновременно. Каждый активный браузер считается одной сессией в рамках лимита тарифа.

1. Начало работы

Установите инструментарий для своего языка. Ничего не нужно размещать у себя и ничего не нужно патчить. Стелс-бинарник загружается при первом запуске и обновляется автоматически.

install.sh
# Python
pip install capiumbrowser
python -m playwright install-deps   # Chromium's OS libraries (once)

# JavaScript / TypeScript
npm install capiumbrowser

Укажите лицензионный ключ и откройте первую страницу. Включите humanize=True для человекоподобного ввода и таймингов.

first_run.py
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. Там его можно показать, скопировать или перевыпустить. Храните его в секрете и загружайте из переменных окружения, а не прописывайте в коде.

auth.py
# 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.

playwright.py
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.

async_run.py
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. Оставляйте его включённым для интерактивных сценариев и выключайте для простого «загрузил и распарсил», где важна скорость.

humanize.py
browser, ctx, page = launch_context(seed=200123, humanize=True)

page.human_type("#email", "[email protected]")   # natural typing cadence
page.human_scroll(1200)                          # smooth, variable scrolling

6. Сессии и параллельность

Каждый активный браузер: одна сессия. Лимит сессий тарифа определяет, сколько их можно запускать одновременно. Закрывайте браузер после работы, чтобы освободить сессию.

concurrent.py
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

capture.py
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 задайте лицензионный ключ как секретную переменную окружения:

ci.yml
# 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 дней, затем он заканчивается. Перейти на платный тариф ради большего числа сессий и поддержки можно в любой момент.

Готовы начать?

Получите лицензионный ключ и запустите первую стелс-сессию за считанные минуты.

Открыть панель управления