browser-stealth 0.1.0__py3-none-any.whl

browser_stealth/__init__.py

@@ -0,0 +1,127 @@
+"""Next-generation browser antidetect, human-like behavior emulation, and profile warmer.
+
+Библиотека глубокой маскировки и эмуляции поведения человека для nodriver, Playwright, Selenium и WebDriver BiDi.
+"""
+
+from __future__ import annotations
+
+from . import (
+    antidetect,
+    bidi,
+    concurrency,
+    fingerprint,
+    humanize,
+    launchers,
+    profiles,
+    proxy,
+    testing,
+)
+from .antidetect.config import AntidetectConfig
+from .antidetect.core import (
+    ANTIDETECT_JS_SCRIPT,
+    apply_antidetect_nodriver,
+    apply_antidetect_playwright,
+    apply_antidetect_selenium,
+    get_browser_launch_args,
+    get_client_hints,
+)
+from .bidi.client import BiDiClient
+from .bidi.session import BiDiSession, bidi_session
+from .exceptions import BrowserStealthError, OptionalDependencyError
+from .humanize.actions import (
+    TouchGestureGenerator,
+    TouchPoint,
+    async_click,
+    async_human_sleep,
+    async_move_mouse,
+    async_scroll_to,
+    async_touch_swipe,
+    async_touch_tap,
+    async_type_text,
+    click,
+    human_sleep,
+    move_mouse,
+    scroll_to,
+    type_text,
+)
+from .humanize.behavior import BehavioralProfile
+from .humanize.math_utils import (
+    BezierCurveGenerator,
+    JitterDelayGenerator,
+    KeyboardTypoGenerator,
+    WindMouseGenerator,
+)
+from .humanize.turnstile import (
+    detect_cf_turnstile,
+    is_cf_turnstile_solved,
+    solve_cf_turnstile,
+)
+from .humanize.warmer import ProfileWarmer, SyncProfileWarmer
+from .launchers import camoufox, nodriver
+from .launchers.nodriver import close_tab, launch_nodriver, nodriver_session
+from .profiles.manager import ProfileManager
+from .profiles.models import BrowserProfile
+from .proxy.models import ProxyConfig, ProxyHealthResult
+from .proxy.parser import parse_proxy
+from .proxy.pool import ProxyPool
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "ANTIDETECT_JS_SCRIPT",
+    "AntidetectConfig",
+    "BehavioralProfile",
+    "BezierCurveGenerator",
+    "BiDiClient",
+    "BiDiSession",
+    "BrowserProfile",
+    "BrowserStealthError",
+    "JitterDelayGenerator",
+    "KeyboardTypoGenerator",
+    "OptionalDependencyError",
+    "ProfileManager",
+    "ProfileWarmer",
+    "ProxyConfig",
+    "ProxyHealthResult",
+    "ProxyPool",
+    "SyncProfileWarmer",
+    "TouchGestureGenerator",
+    "TouchPoint",
+    "WindMouseGenerator",
+    "antidetect",
+    "apply_antidetect_nodriver",
+    "apply_antidetect_playwright",
+    "apply_antidetect_selenium",
+    "async_click",
+    "async_human_sleep",
+    "async_move_mouse",
+    "async_scroll_to",
+    "async_touch_swipe",
+    "async_touch_tap",
+    "async_type_text",
+    "bidi",
+    "bidi_session",
+    "camoufox",
+    "click",
+    "close_tab",
+    "concurrency",
+    "detect_cf_turnstile",
+    "fingerprint",
+    "get_browser_launch_args",
+    "get_client_hints",
+    "human_sleep",
+    "humanize",
+    "is_cf_turnstile_solved",
+    "launch_nodriver",
+    "launchers",
+    "move_mouse",
+    "nodriver",
+    "nodriver_session",
+    "parse_proxy",
+    "profiles",
+    "proxy",
+    "scroll_to",
+    "solve_cf_turnstile",
+    "testing",
+    "type_text",
+]

browser_stealth/antidetect/__init__.py

@@ -0,0 +1,43 @@
+"""Подсистема антидетекта и маскировки браузерных сред."""
+
+from __future__ import annotations
+
+from .config import AntidetectConfig
+from .core import (
+    ANTIDETECT_JS_SCRIPT,
+    _ensure_nodriver,
+    _ensure_playwright,
+    _ensure_selenium,
+    apply_antidetect_nodriver,
+    apply_antidetect_playwright,
+    apply_antidetect_selenium,
+    extract_clearance_cookies,
+    get_browser_launch_args,
+    get_client_hints,
+)
+from .scripts import (
+    DEFAULT_DEVICE_MEMORY,
+    DEFAULT_HARDWARE_CONCURRENCY,
+    DEFAULT_WEBGL_RENDERER,
+    DEFAULT_WEBGL_VENDOR,
+    _get_antidetect_js,
+)
+
+__all__ = [
+    "ANTIDETECT_JS_SCRIPT",
+    "DEFAULT_DEVICE_MEMORY",
+    "DEFAULT_HARDWARE_CONCURRENCY",
+    "DEFAULT_WEBGL_RENDERER",
+    "DEFAULT_WEBGL_VENDOR",
+    "AntidetectConfig",
+    "_ensure_nodriver",
+    "_ensure_playwright",
+    "_ensure_selenium",
+    "_get_antidetect_js",
+    "apply_antidetect_nodriver",
+    "apply_antidetect_playwright",
+    "apply_antidetect_selenium",
+    "extract_clearance_cookies",
+    "get_browser_launch_args",
+    "get_client_hints",
+]

browser_stealth/antidetect/_mobile_scripts.py

@@ -0,0 +1,3 @@
+"""Алиас для обратной совместимости."""
+
+from .mobile import *

browser_stealth/antidetect/antidetect.py

@@ -0,0 +1,3 @@
+"""Алиас для обратной совместимости."""
+
+from .core import *

browser_stealth/antidetect/antidetect_scripts.py

@@ -0,0 +1,3 @@
+"""Алиас для обратной совместимости."""
+
+from .scripts import *

browser_stealth/antidetect/config.py

@@ -0,0 +1,495 @@
+"""Декларативная конфигурация антидетекта для браузерных движков."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, cast
+
+if TYPE_CHECKING:
+    from browser_stealth.fingerprint.models import FingerprintProfile
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .scripts import (
+    DEFAULT_DEVICE_MEMORY,
+    DEFAULT_HARDWARE_CONCURRENCY,
+    DEFAULT_WEBGL_RENDERER,
+    DEFAULT_WEBGL_VENDOR,
+)
+
+
+class AntidetectConfig(BaseModel):
+    """Конфигурация параметров маскировки браузера (антидетект)."""
+
+    model_config = ConfigDict(arbitrary_types_allowed=True, validate_assignment=True)
+
+    webgl_vendor: str = Field(
+        default=DEFAULT_WEBGL_VENDOR,
+        description="Эмулируемый производитель WebGL.",
+    )
+    webgl_renderer: str = Field(
+        default=DEFAULT_WEBGL_RENDERER,
+        description="Эмулируемая видеокарта WebGL.",
+    )
+    hardware_concurrency: int = Field(
+        default=DEFAULT_HARDWARE_CONCURRENCY,
+        ge=1,
+        le=128,
+        description="Количество виртуальных ядер процессора.",
+    )
+    device_memory: int = Field(
+        default=DEFAULT_DEVICE_MEMORY,
+        ge=1,
+        le=128,
+        description="Объем оперативной памяти устройства в ГБ.",
+    )
+    stealth_minimal: bool = Field(
+        default=True,
+        description=(
+            "Если True, не накладывать синтетический шум на Canvas и не подменять WebGL, "
+            "сохраняя 100% консистентный отпечаток реального Chromium (рекомендуется для nodriver)."
+        ),
+    )
+    session_seed: str | int = Field(
+        default=1337,
+        description="Сид для детерминированного шума Canvas и AudioContext.",
+    )
+    client_hints: dict[str, Any] | None = Field(
+        default=None,
+        description="Параметры navigator.userAgentData (brands, platform, mobile).",
+    )
+    user_agent: str | None = Field(
+        default=None,
+        description="Пользовательская строка User-Agent для переопределения через CDP/HTTP.",
+    )
+    screen_width: int | None = Field(
+        default=None,
+        description="Эмулируемая ширина экрана (screen.width).",
+    )
+    screen_height: int | None = Field(
+        default=None,
+        description="Эмулируемая высота экрана (screen.height).",
+    )
+    screen_avail_height: int | None = Field(
+        default=None,
+        description="Эмулируемая доступная высота экрана за вычетом панели задач (screen.availHeight).",
+    )
+    device_pixel_ratio: float | None = Field(
+        default=None,
+        description="Эмулируемый коэффициент масштабирования (window.devicePixelRatio).",
+    )
+    media_devices: list[dict[str, Any]] | None = Field(
+        default=None,
+        description="Список эмулируемых медиа-устройств (микрофоны, динамики, веб-камеры).",
+    )
+    is_mobile: bool = Field(
+        default=False,
+        description="Флаг эмуляции мобильного устройства.",
+    )
+    has_touch: bool = Field(
+        default=False,
+        description="Флаг поддержки сенсорного ввода (Touch Events).",
+    )
+    max_touch_points: int = Field(
+        default=0,
+        ge=0,
+        le=20,
+        description="Максимальное количество точек касания (navigator.maxTouchPoints).",
+    )
+    is_ios: bool = Field(
+        default=False,
+        description="Флаг эмуляции iOS Safari (специфичные объекты window.safari, ApplePaySession).",
+    )
+    orientation: dict[str, Any] | None = Field(
+        default=None,
+        description="Параметры ориентации экрана (type, angle).",
+    )
+
+    @classmethod
+    def preset_stealth_nodriver(
+        cls,
+        *,
+        session_seed: str | int = 1337,
+        client_hints: dict[str, Any] | None = None,
+        user_agent: str | None = None,
+    ) -> AntidetectConfig:
+        """Рекомендуемый пресет для nodriver: zero-footprint (без синтетического шума Canvas/WebGL).
+
+        Args:
+            session_seed: Сид для детерминированного генератора псевдослучайных чисел.
+            client_hints: Опциональный словарь с параметрами Client Hints.
+            user_agent: Опциональная строка User-Agent.
+
+        Returns:
+            Экземпляр AntidetectConfig с конфигурацией zero-footprint.
+        """
+        return cls(
+            stealth_minimal=True,
+            session_seed=session_seed,
+            client_hints=client_hints,
+            user_agent=user_agent,
+        )
+
+    @classmethod
+    def preset_aggressive(
+        cls,
+        *,
+        webgl_vendor: str = DEFAULT_WEBGL_VENDOR,
+        webgl_renderer: str = DEFAULT_WEBGL_RENDERER,
+        hardware_concurrency: int = DEFAULT_HARDWARE_CONCURRENCY,
+        device_memory: int = DEFAULT_DEVICE_MEMORY,
+        session_seed: str | int = 1337,
+        client_hints: dict[str, Any] | None = None,
+        user_agent: str | None = None,
+    ) -> AntidetectConfig:
+        """Агрессивный пресет с рандомизацией Canvas/WebGL/Audio (для Playwright/Selenium в headless).
+
+        Args:
+            webgl_vendor: Эмулируемый производитель WebGL.
+            webgl_renderer: Эмулируемая видеокарта WebGL.
+            hardware_concurrency: Эмулируемое количество ядер CPU.
+            device_memory: Эмулируемый объем оперативной памяти в ГБ.
+            session_seed: Сид для рандомизации шума Canvas/Audio.
+            client_hints: Дополнительные параметры Client Hints.
+            user_agent: Опциональная строка User-Agent.
+
+        Returns:
+            Экземпляр AntidetectConfig с агрессивной рандомизацией.
+        """
+        return cls(
+            webgl_vendor=webgl_vendor,
+            webgl_renderer=webgl_renderer,
+            hardware_concurrency=hardware_concurrency,
+            device_memory=device_memory,
+            stealth_minimal=False,
+            session_seed=session_seed,
+            client_hints=client_hints,
+            user_agent=user_agent,
+        )
+
+    @classmethod
+    def preset_minimal(
+        cls,
+        *,
+        session_seed: str | int = 1337,
+        user_agent: str | None = None,
+    ) -> AntidetectConfig:
+        """Минимальный пресет: отключен шум, только базовая защита от утечек и скрытие webdriver.
+
+        Args:
+            session_seed: Сид для инициализации сессии.
+            user_agent: Опциональная строка User-Agent.
+
+        Returns:
+            Экземпляр AntidetectConfig с минимальной модификацией.
+        """
+        return cls(
+            stealth_minimal=True,
+            session_seed=session_seed,
+            user_agent=user_agent,
+        )
+
+    @classmethod
+    def preset_mobile_android(
+        cls,
+        *,
+        device: str = "pixel_8",
+        session_seed: str | int = 1337,
+        stealth_minimal: bool = True,
+    ) -> AntidetectConfig:
+        """Мобильный пресет для Android Chrome (Pixel 8, Pixel 7, Galaxy S24).
+
+        Args:
+            device: Идентификатор устройства ('pixel_8', 'pixel_7', 'galaxy_s24').
+            session_seed: Сид для детерминированного шума и генератора поведения.
+            stealth_minimal: Режим маскировки.
+
+        Returns:
+            Экземпляр AntidetectConfig для Android устройства.
+        """
+        device_lower = device.lower()
+        if device_lower == "pixel_7":
+            width, height = 412, 915
+            dpr = 2.625
+            ua = (
+                "Mozilla/5.0 (Linux; Android 13; Pixel 7) AppleWebKit/537.36 "
+                "(KHTML, like Gecko) Chrome/128.0.0.0 Mobile Safari/537.36"
+            )
+            vendor = "ARM"
+            renderer = "Mali-G710"
+        elif device_lower in ("galaxy_s24", "s24"):
+            width, height = 360, 780
+            dpr = 3.0
+            ua = (
+                "Mozilla/5.0 (Linux; Android 14; SM-S921B) AppleWebKit/537.36 "
+                "(KHTML, like Gecko) Chrome/128.0.0.0 Mobile Safari/537.36"
+            )
+            vendor = "Qualcomm"
+            renderer = "Adreno (TM) 750"
+        else:  # pixel_8 по умолчанию или generic
+            width, height = 412, 915
+            dpr = 2.625
+            ua = (
+                f"Mozilla/5.0 (Linux; Android 14; {'Pixel 8' if device_lower == 'pixel_8' else device}) "
+                "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Mobile Safari/537.36"
+            )
+            vendor = "ARM"
+            renderer = "Mali-G715 Immortalis MC11"
+
+        client_hints = {
+            "platform": "Android",
+            "mobile": True,
+            "brands": [
+                {"brand": "Chromium", "version": "128"},
+                {"brand": "Google Chrome", "version": "128"},
+                {"brand": "Not;A=Brand", "version": "24"},
+            ],
+        }
+
+        return cls(
+            user_agent=ua,
+            webgl_vendor=vendor,
+            webgl_renderer=renderer,
+            hardware_concurrency=8,
+            device_memory=8,
+            screen_width=width,
+            screen_height=height,
+            screen_avail_height=height,
+            device_pixel_ratio=dpr,
+            is_mobile=True,
+            has_touch=True,
+            max_touch_points=5,
+            is_ios=False,
+            orientation={"type": "portrait-primary", "angle": 0},
+            client_hints=client_hints,
+            stealth_minimal=stealth_minimal,
+            session_seed=session_seed,
+        )
+
+    @classmethod
+    def preset_mobile_ios(
+        cls,
+        *,
+        device: str = "iphone_15",
+        session_seed: str | int = 1337,
+        stealth_minimal: bool = True,
+    ) -> AntidetectConfig:
+        """Мобильный пресет для iOS Safari (iPhone 15, iPhone 14).
+
+        Args:
+            device: Идентификатор устройства ('iphone_15', 'iphone_14').
+            session_seed: Сид для детерминированного шума и генератора поведения.
+            stealth_minimal: Режим маскировки.
+
+        Returns:
+            Экземпляр AntidetectConfig для iOS Safari.
+        """
+        device_lower = device.lower()
+        if device_lower in ("iphone_14", "iphone14"):
+            width, height = 390, 844
+            dpr = 3.0
+            ua = (
+                "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) "
+                "AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1"
+            )
+        else:  # iphone_15 по умолчанию или generic
+            width, height = 393, 852
+            dpr = 3.0
+            ua = (
+                f"Mozilla/5.0 ({'iPhone' if 'iphone' in device_lower else device}; CPU iPhone OS 17_5 like Mac OS X) "
+                "AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
+            )
+
+        client_hints = {
+            "platform": "iOS",
+            "mobile": True,
+            "brands": [],
+        }
+
+        return cls(
+            user_agent=ua,
+            webgl_vendor="Apple Inc.",
+            webgl_renderer="Apple GPU",
+            hardware_concurrency=6,
+            device_memory=6,
+            screen_width=width,
+            screen_height=height,
+            screen_avail_height=height,
+            device_pixel_ratio=dpr,
+            is_mobile=True,
+            has_touch=True,
+            max_touch_points=5,
+            is_ios=True,
+            orientation={"type": "portrait-primary", "angle": 0},
+            client_hints=client_hints,
+            stealth_minimal=stealth_minimal,
+            session_seed=session_seed,
+        )
+
+    @classmethod
+    def from_fingerprint(
+        cls,
+        profile: FingerprintProfile | Any,
+        *,
+        stealth_minimal: bool = True,
+    ) -> AntidetectConfig:
+        """Создает AntidetectConfig на основе объекта FingerprintProfile.
+
+        Args:
+            profile: Экземпляр FingerprintProfile.
+            stealth_minimal: Если True, не накладывать синтетический шум на Canvas.
+
+        Returns:
+            Сконфигурированный экземпляр AntidetectConfig.
+        """
+        res = profile.to_antidetect_config(stealth_minimal=stealth_minimal)
+        return cast(AntidetectConfig, res)
+
+    @classmethod
+    def from_seed(
+        cls,
+        seed: int | str,
+        *,
+        stealth_minimal: bool = True,
+        os_target: str = "windows",
+        locale: str = "ru-RU",
+    ) -> AntidetectConfig:
+        """Синтезирует детерминированную цифровую личность по сиду и возвращает AntidetectConfig.
+
+        Один и тот же сид всегда дает абсолютно идентичный и физически согласованный
+        отпечаток (видеокарта, процессор, память, геометрия экрана, панель задач).
+
+        Args:
+            seed: Сид профиля или имя учетной записи.
+            stealth_minimal: Если True, сохраняет чистый отпечаток без искажения Canvas.
+            os_target: Целевая ОС ('windows').
+            locale: Локаль ('ru-RU', 'en-US').
+
+        Returns:
+            Экземпляр AntidetectConfig.
+        """
+        from browser_stealth.fingerprint import FingerprintSynthesizer
+
+        fp = FingerprintSynthesizer(
+            mode="procedural", os_target=os_target, locale=locale
+        ).synthesize(seed)
+        return fp.to_antidetect_config(stealth_minimal=stealth_minimal)
+
+    @classmethod
+    def from_browserforge(
+        cls,
+        seed: int | str | None = None,
+        *,
+        browser: str = "chrome",
+        os: str = "windows",
+        stealth_minimal: bool = True,
+    ) -> AntidetectConfig:
+        """Генерирует отпечаток через байесовскую сеть browserforge (при наличии пакета).
+
+        Args:
+            seed: Опциональный сид для воспроизводимой детерминированной генерации.
+            browser: Эмулируемый браузер ('chrome').
+            os: Целевая ОС ('windows').
+            stealth_minimal: Режим маскировки.
+
+        Returns:
+            Экземпляр AntidetectConfig.
+        """
+        from browser_stealth.fingerprint import FingerprintSynthesizer
+
+        fp = FingerprintSynthesizer(mode="browserforge", os_target=os).synthesize(seed)
+        return fp.to_antidetect_config(stealth_minimal=stealth_minimal)
+
+    @classmethod
+    def from_procedural(
+        cls,
+        seed: int | str | None = None,
+        *,
+        stealth_minimal: bool = True,
+        os_target: str = "windows",
+        locale: str = "ru-RU",
+    ) -> AntidetectConfig:
+        """Синтезирует отпечаток через встроенный процедурный генератор.
+
+        Args:
+            seed: Опциональный сид.
+            stealth_minimal: Режим маскировки.
+            os_target: Целевая ОС.
+            locale: Локаль.
+
+        Returns:
+            Экземпляр AntidetectConfig.
+        """
+        from browser_stealth.fingerprint import FingerprintSynthesizer
+
+        fp = FingerprintSynthesizer(
+            mode="procedural", os_target=os_target, locale=locale
+        ).synthesize(seed)
+        return fp.to_antidetect_config(stealth_minimal=stealth_minimal)
+
+    def get_behavioral_profile(self) -> Any:
+        """Возвращает детерминированный биометрический профиль моторики на основе session_seed.
+
+        Returns:
+            Экземпляр BehavioralProfile.
+        """
+        from browser_stealth.humanize.behavior import BehavioralProfile
+
+        return BehavioralProfile.from_seed(self.session_seed)
+
+    def get_init_script(self) -> str:
+        """Генерирует JavaScript-скрипт антидетекта на основе настроек конфигурации.
+
+        Returns:
+            Строка исполняемого JavaScript-кода для инъекции в браузер.
+        """
+        from .scripts import _get_antidetect_js
+
+        return _get_antidetect_js(
+            webgl_vendor=self.webgl_vendor,
+            webgl_renderer=self.webgl_renderer,
+            hardware_concurrency=self.hardware_concurrency,
+            device_memory=self.device_memory,
+            stealth_minimal=self.stealth_minimal,
+            session_seed=self.session_seed,
+            client_hints=self.client_hints,
+            screen_width=self.screen_width,
+            screen_height=self.screen_height,
+            screen_avail_height=self.screen_avail_height,
+            device_pixel_ratio=self.device_pixel_ratio,
+            media_devices=self.media_devices,
+            is_mobile=self.is_mobile,
+            has_touch=self.has_touch,
+            max_touch_points=self.max_touch_points,
+            is_ios=self.is_ios,
+            orientation=self.orientation,
+        )
+
+    async def apply_to_nodriver(self, tab: Any) -> None:
+        """Применяет данную конфигурацию антидетекта к вкладке nodriver Tab.
+
+        Args:
+            tab: Экземпляр вкладки nodriver Tab.
+        """
+        from .core import apply_antidetect_nodriver
+
+        await apply_antidetect_nodriver(tab, config=self)
+
+    async def apply_to_playwright(self, target: Any) -> None:
+        """Применяет данную конфигурацию антидетекта к Playwright Page или BrowserContext.
+
+        Args:
+            target: Экземпляр Playwright BrowserContext или Page.
+        """
+        from .core import apply_antidetect_playwright
+
+        await apply_antidetect_playwright(target, config=self)
+
+    def apply_to_selenium(self, driver: Any) -> None:
+        """Применяет данную конфигурацию антидетекта к Selenium WebDriver.
+
+        Args:
+            driver: Экземпляр Selenium WebDriver.
+        """
+        from .core import apply_antidetect_selenium
+
+        apply_antidetect_selenium(driver, config=self)