Справочник SDK

Два SDK, один продукт: anti-detect-browser на npm и antibrow на PyPI. Они используют общий каталог кэша, формат профилей и аккаунт, поэтому профиль, созданный в одном, открывается в другом и в приложении для ПК. В любом случае вы запускаете профиль и получаете настоящие объекты Playwright по CDP, так что уже написанные селекторы, проверки и трейсы продолжают работать. Windows, macOS и Linux. Локальные профили не ограничены на любом тарифе; платные тарифы добавляют параллелизм, облачную синхронизацию, управляемые прокси и Live View.

npm install anti-detect-browser

import { AntiDetectBrowser } from 'anti-detect-browser'

const ab = new AntiDetectBrowser({ key: 'your-api-key' })

const { page, context, browser } = await ab.launch({
  profile: 'account-01',
  label: 'account-01',
})

// Plain Playwright from here.
await page.goto('https://example.com')
await page.getByRole('button', { name: 'Sign in' }).click()

await browser.close()

pip install antibrow

python -m antibrow login      # stores your API key
python -m antibrow install    # downloads the engine (optional: the first launch does it)

from antibrow import launch

browser = launch(profile="account-01")

# Plain Playwright from here.
page = browser.new_page()
page.goto("https://example.com")
page.get_by_role("button", name="Sign in").click()

browser.close()

from antibrow import launch

with launch(
    profile="scraper-eu",
    headless=True,
    proxy="http://user:pass@gate.example.com:8080",
    geoip=True,                # timezone and WebRTC follow the proxy exit
) as browser:
    page = browser.new_page()
    page.goto("https://example.com")
    print(browser.timezone, browser.public_ip)

import asyncio
from antibrow import launch_async

async def main():
    browser = await launch_async(profile="agent-01")
    page = await browser.new_page()
    await page.goto("https://example.com")
    print(await page.title())
    await browser.close()

asyncio.run(main())

new AntiDetectBrowser(options)

launch(options)

Что возвращает launch()

openProfile(options)

Низкоуровневая точка входа, на которой построен launch(). Используйте её, когда нужен сам объект сессии напрямую, гео по выходному IP, колбэки синхронизации архива или переключатели движка для конкретного профиля.

import { openProfile } from 'anti-detect-browser'

const session = await openProfile({
  key: 'your-api-key',
  profileName: 'account-01',
  proxyUrl: 'http://user:pass@host:5001',
  onProgress: (m) => console.log(m),
})

console.log(session.geo)   // { ip, country, countryCode, city, timezone }

const page = session.context.pages()[0] ?? await session.context.newPage()
await page.goto('https://example.com')

await session.close()

Сессия, которую она возвращает

launch(profile="default", **options)

Запускает движок и возвращает готовый к работе хендлер. launch_async() принимает точно такие же опции.

Хендлер Antibrow

Обращения к атрибутам делегируются в Playwright BrowserContext, поэтому хендлер ведёт себя как context, и не нужно сначала обращаться к .context.

browser = launch(profile="account-01")

# Attribute lookups fall through to the Playwright BrowserContext,
# so anything you would call on a context works on the handle.
browser.add_init_script("...")
browser.add_cookies([...])
browser.pages

Другие точки входа

from antibrow import (
    launch_async, launch_persistent_context,
    launch_persistent_context_async, prepare_launch,
)

browser = await launch_async(profile="p1")           # asyncio twin of launch()
context = launch_persistent_context(profile="p1")    # a literal Playwright BrowserContext
plan    = prepare_launch(profile="p1")               # resolve everything, start nothing

print(plan.redacted_args())   # the command line with the token and proxy password masked

prepare_launch() определяет точный исполняемый файл, аргументы, persona и часовой пояс, которые использовал бы запуск, не запуская процесс - поэтому именно его стоит вызывать для тестов, сухих прогонов и баг-репортов.

Управление профилями

import {
  listProfiles, getProfileDir, defaultCacheDir,
  getOrCreateProfile, deleteProfile,
} from 'anti-detect-browser'

// Local profiles are directories on disk. Unlimited on every plan.
listProfiles()                // string[] of profile names
getProfileDir('account-01')   // absolute path to that profile
defaultCacheDir()             // ~/.anti-detect-browser by default

// Cloud-synced profiles talk to the server and need an API key.
const p = await getOrCreateProfile({ key, name: 'account-01', tags: ['ads'] })
await deleteProfile({ key, id: p.id })

from antibrow import list_profiles, profile_dir, default_cache_dir

# Local profiles are directories on disk. Unlimited on every plan, and
# launching a name that does not exist creates it.
list_profiles()                # ['account-01', 'account-02']
profile_dir("account-01")      # Path to that profile
default_cache_dir()            # ~/.anti-detect-browser by default

# Or point at an exact directory, e.g. a volume mounted into CI:
launch(profile_dir="/data/profiles/account-01")

Профили устройств

Две независимые опции, обе определяются только при первом создании профиля - существующий профиль сохраняет то, что было определено, зафиксированным в его persona.

• deviceType: 'android' симулирует полноценное окружение Android-телефона - user agent, Client Hints, сенсорный ввод, экран - которое работает на той же машине с Windows, macOS или Linux. Оно не работает на телефоне, и физическое устройство не требуется. Бесплатно на любом тарифе, включая Бесплатный.
• realFingerprint: true берёт личность из библиотеки отпечатков реальных устройств - пула отпечатков, собранных с реальных физических машин, - вместо локальной генерации. Только платные тарифы - запрос с Бесплатного тарифа получает от сервера 403, а не молчаливый откат к сгенерированной личности. Работает с любым типом устройства.

// A simulated Android phone - runs on this same Windows/macOS/Linux
// machine, not on a physical device, and needs none. Free on every
// plan. Only takes effect the first time this profile is created.
await ab.launch({ profile: 'mobile-01', deviceType: 'android' })

// Draw the identity from a real captured device instead of generating
// one. Paid plans only - a Free-plan key gets a 403. Works for either
// device type, and also only applies at first creation.
await ab.launch({ profile: 'captured-01', realFingerprint: true })

// Combine both: an Android identity pulled from the captured library.
await ab.launch({
  profile: 'captured-mobile-01',
  deviceType: 'android',
  realFingerprint: true,
})

# A simulated Android phone - runs on this same Windows/macOS/Linux
# machine, not on a physical device, and needs none. Free on every
# plan. Only takes effect the first time this profile is created.
browser = launch(profile="mobile-01", device_type="android")

# Draw the identity from a real captured device instead of generating
# one. Paid plans only - a Free-plan key raises. Works for either
# device type, and also only applies at first creation.
browser = launch(profile="captured-01", real_fingerprint=True)

Экспорт и импорт

Профили экспортируются в переносимый архив .fpprofile на любом тарифе, включая Бесплатный, потому что возможность уйти не должна быть платной функцией. Архив несёт отпечаток, cookies, хранилище, закладки и passkeys. Относитесь к файлу как к учётным данным: всё, что может его открыть, входит в систему под этой личностью.

import { exportProfileArchive, importProfileArchive, getProfileDir } from 'anti-detect-browser'
import { writeFileSync, readFileSync } from 'node:fs'

// Carries the fingerprint, cookies, storage, bookmarks and passkeys.
const buf = exportProfileArchive(getProfileDir('account-01'), meta)
writeFileSync('account-01.fpprofile', buf)

// Restore it into another machine's profile directory.
importProfileArchive(readFileSync('account-01.fpprofile'), getProfileDir('account-01'))

Прокси

launch(proxy="http://user:pass@gate.example.com:8080")
launch(proxy="socks5://user:pass@127.0.0.1:1080")
launch(proxy={"server": "http://gate.example.com:8080", "username": "u", "password": "p"})

browser = launch(profile="p1", proxy="socks5://user:pass@127.0.0.1:1080")
print(browser.public_ip, browser.timezone)   # 203.0.113.7 America/Los_Angeles

Интеграции с фреймворками

Каждая интеграция работает одинаково: SDK запускает браузер, а вы передаёте его CDP-endpoint тому, что должно им управлять. Playwright вообще не требует прослойки - хендлер уже является context.

browser = launch(profile="agent-01")

browser.cdp_url        # http://127.0.0.1:54321        - crawl4ai, puppeteer.connect
browser.cdp_endpoint   # ws://127.0.0.1:54321/devtools/browser/...

# browser-use
Agent(task="...", llm=llm, browser=Browser(cdp_url=browser.cdp_url))

# crawl4ai
AsyncWebCrawler(config=BrowserConfig(cdp_url=browser.cdp_url, headless=False))

# Scrapling
DynamicFetcher.fetch("https://example.com", cdp_url=browser.cdp_endpoint)

Selenium не может подключиться к endpoint, работающему только по CDP, без подходящего chromedriver, поэтому привязки для Selenium сегодня нет. Если вы переходите с него, Playwright - самый короткий путь. Хотите управлять браузером из AI-агента? См. MCP-сервер.

Live View

Транслируйте работающую сессию в кабинет. Только платные тарифы.

const { page, viewUrl } = await ab.launch({
  profile: 'account-01',
  liveView: { quality: 60, maxWidth: 1280, everyNthFrame: 2 },
})

console.log(viewUrl)   // open in the dashboard to watch the session

Обновления движка

Движок скачивается при первом использовании и кэшируется в каталоге кэша. Новые профили используют текущую версию по умолчанию; существующий профиль сохраняет версию, записанную в его persona, поэтому его отпечаток не меняется незаметно после обновления.

await ab.checkKernelUpdates()

if (await ab.hasKernelUpdate()) {
  await ab.updateKernel(undefined, (m) => console.log(m))
}

// Or fold it into a launch:
await ab.launch({ profile: 'account-01', updateKernelBeforeLaunch: true })

# Fold the check into a launch:
launch(profile="account-01", update_kernel=True)

# Or from the CLI:
#   python -m antibrow install --force

CLI и окружение

python -m antibrow install [--version 150.0.7871.182] [--force]   # get the engine
python -m antibrow info                                           # engines, profiles, license
python -m antibrow login [--key ab_live_...]                      # store an API key
python -m antibrow version                                        # SDK and default engine version

antibrow ... тоже работает, как консольный скрипт. info - первое, что стоит запустить, если что-то не так: команда выводит каталог кэша, все версии движка с их статусом установки, все профили с версией, к которой они привязаны, и откуда был взят ваш API-ключ.

Docker

Linux-движок работает в обычном режиме под Xvfb, потому что у настоящего headless-режима Chromium есть собственный отпечаток. Этот образ работает и на linux/amd64, и на linux/arm64; подходящая сборка выбирается по CPU контейнера.

FROM python:3.12-slim
RUN apt-get update && apt-get install -y --no-install-recommends \
      xvfb libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 \
      libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 \
      libgbm1 libasound2 libpango-1.0-0 libcairo2 fonts-liberation ca-certificates \
    && rm -rf /var/lib/apt/lists/*
RUN pip install --no-cache-dir antibrow
COPY script.py .
CMD ["xvfb-run", "-a", "python", "script.py"]

Смонтируйте каталог кэша как volume (-v antibrow-cache:/root/.anti-detect-browser), чтобы движок и профили сохранялись между запусками, иначе каждый контейнер будет скачивать движок заново.

Ошибки

from antibrow import AntibrowError, ConcurrencyLimitError, LicenseError

try:
    browser = launch()
except ConcurrencyLimitError:
    ...   # the plan's simultaneous-browser cap is in use
except LicenseError:
    ...   # no API key, or the server rejected it
except AntibrowError:
    ...   # engine download, unsupported platform, proxy, launch failure

API сервера

Оба SDK вызывают их за вас, поэтому напрямую они нужны редко. Они приведены здесь для тех, кто интегрируется без SDK. Авторизация через Authorization: Bearer <api-key>.