browser-stealth 0.1.0__tar.gz

browser_stealth-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: browser-stealth
+Version: 0.1.0
+Summary: Next-generation browser antidetect, human-like behavior emulation (WindMouse), and profile warmer for Playwright, nodriver, and Selenium.
+Keywords: playwright-stealth,nodriver,antidetect,web-scraping,windmouse,turnstile-solver,browser-automation
+Author: Chu4hel
+Author-email: Chu4hel <106600877+Chu4hel@users.noreply.github.com>
+License-Expression: MIT
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: browser-stealth[playwright,nodriver,selenium,camoufox,bidi,crypto] ; extra == 'all'
+Requires-Dist: websockets>=14.0.0 ; extra == 'bidi'
+Requires-Dist: camoufox>=0.4.0 ; extra == 'camoufox'
+Requires-Dist: cryptography>=41.0.0 ; extra == 'crypto'
+Requires-Dist: nodriver>=0.38 ; extra == 'nodriver'
+Requires-Dist: playwright>=1.40.0 ; extra == 'playwright'
+Requires-Dist: selenium>=4.15.0 ; extra == 'selenium'
+Requires-Python: >=3.11
+Provides-Extra: all
+Provides-Extra: bidi
+Provides-Extra: camoufox
+Provides-Extra: crypto
+Provides-Extra: nodriver
+Provides-Extra: playwright
+Provides-Extra: selenium
+Description-Content-Type: text/markdown
+
+# browser-stealth 🥷
+
+> Библиотека браузерного антидетекта нового поколения, биомеханической эмуляции поведения человека (**WindMouse**) и прогрева профилей для **nodriver**, **Playwright**, **Selenium** и **WebDriver BiDi**.
+
+---
+
+## Ключевые возможности
+
+* **Кросс-движковый антидетект**:
+  * Скрытие признаков автоматизации (`navigator.webdriver`, флаги automation CDP).
+  * Полифилы и согласованный спуфинг WebGL (`UNMASKED_VENDOR_WEBGL`, `UNMASKED_RENDERER_WEBGL`), Canvas (субпиксельный детерминированный шум), AudioContext и WebRTC.
+  * Защита от детекта через Web Workers и чистые трассировки стека V8 без утечек patched evaluation.
+  * Поддержка Client Hints (`navigator.userAgentData`), сенсорных событий Touch API и гироскопа.
+* **Биомеханика движений человека (Humanize)**:
+  * Алгоритм движения мыши **WindMouse** с физической моделью гравитации, инерции и кривых Безье.
+  * Имитация опечаток на клавиатуре и вариативной скорости набора текста.
+  * Реалистичные сенсорные жесты: тапы, свайпы и пинч-зум.
+  * Марковские цепи для эмуляции случайного блуждания и серфинга по сайтам.
+* **Прогрев сессий и решение проверок (Warmers & Solvers)**:
+  * `ProfileWarmer` — автоматический органический прогрев браузерных сессий через поисковые системы (Google, Yandex, Bing).
+  * Автоматический обход модальных окон согласия Google Consent / GDPR.
+  * Встроенный инспектор и интеграционный мост для токенов Cloudflare Turnstile.
+* **Синтез и управление профилями**:
+  * Синтез консистентных цифровых личностей по seed-ключу (`FingerprintSynthesizer`).
+  * Защищенный экспорт/импорт профилей (`.chprofile`) с опциональным AES/Fernet-шифрованием.
+  * Автоматическая гигиена и санитизация профилей (сброс флагов сбоя `exit_type`, очистка временного мусора Chromium).
+* **Сетевая инфраструктура**:
+  * Пул прокси с скорингом задержки, ротацией и health-check.
+  * Динамическая генерация Chrome Extension для базовой аутентификации прокси.
+  * Локальный TCP/SOCKS авторизационный туннель.
+* **Протокол WebDriver BiDi**:
+  * Кроссбраузерное внедрение антидетект скриптов через `script.addPreloadScript` поверх WebSocket-соединения.
+
+---
+
+## Установка
+
+Установка ядра с нулевыми тяжелыми зависимостями:
+
+```bash
+uv add browser-stealth
+# или
+pip install browser-stealth
+```
+
+Установка с поддержкой конкретных браузерных движков:
+
+```bash
+uv add "browser-stealth[playwright]"  # Для Playwright
+uv add "browser-stealth[nodriver]"    # Для nodriver
+uv add "browser-stealth[selenium]"    # Для Selenium
+uv add "browser-stealth[bidi]"        # Для протокола WebDriver BiDi
+uv add "browser-stealth[all]"         # Все компоненты
+```
+
+---
+
+## Быстрый старт
+
+### 1. Декларативная маскировка nodriver (Zero-Footprint)
+
+```python
+import asyncio
+from browser_stealth import AntidetectConfig, launch_nodriver
+
+
+async def main():
+    config = AntidetectConfig.preset_stealth_nodriver(
+        session_seed="user_account_42",
+    )
+    browser = await launch_nodriver(antidetect_config=config, headless=False)
+    page = await browser.get("https://bot.sannysoft.com")
+    await asyncio.sleep(5)
+    await browser.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### 2. Человекоподобные движения мыши (WindMouse)
+
+```python
+import asyncio
+from browser_stealth.humanize import async_move_mouse, async_type_text
+
+
+async def interact(tab):
+    # Плавное биомеханическое перемещение мыши в координаты кнопки
+    await async_move_mouse(tab, target_x=450, target_y=320)
+    # Ввод текста с естественными задержками и опечатками
+    await async_type_text(tab, "#search-input", "browser antidetect python")
+```
+
+### 3. Интеграция с Playwright
+
+```python
+import asyncio
+from playwright.async_api import async_playwright
+from browser_stealth import AntidetectConfig, apply_antidetect_playwright
+
+
+async def main():
+    config = AntidetectConfig.preset_aggressive(
+        webgl_vendor="Google Inc. (NVIDIA)",
+        webgl_renderer="ANGLE (NVIDIA, GeForce RTX 4080 Direct3D11)",
+    )
+    async with async_playwright() as p:
+        browser = await p.chromium.launch(headless=True)
+        context = await browser.new_context()
+        await apply_antidetect_playwright(context, config=config)
+        page = await context.new_page()
+        await page.goto("https://nowecure.com")
+        await browser.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## Лицензия
+
+Распространяется под лицензией MIT.

browser_stealth-0.1.0/README.md

@@ -0,0 +1,125 @@
+# browser-stealth 🥷
+
+> Библиотека браузерного антидетекта нового поколения, биомеханической эмуляции поведения человека (**WindMouse**) и прогрева профилей для **nodriver**, **Playwright**, **Selenium** и **WebDriver BiDi**.
+
+---
+
+## Ключевые возможности
+
+* **Кросс-движковый антидетект**:
+  * Скрытие признаков автоматизации (`navigator.webdriver`, флаги automation CDP).
+  * Полифилы и согласованный спуфинг WebGL (`UNMASKED_VENDOR_WEBGL`, `UNMASKED_RENDERER_WEBGL`), Canvas (субпиксельный детерминированный шум), AudioContext и WebRTC.
+  * Защита от детекта через Web Workers и чистые трассировки стека V8 без утечек patched evaluation.
+  * Поддержка Client Hints (`navigator.userAgentData`), сенсорных событий Touch API и гироскопа.
+* **Биомеханика движений человека (Humanize)**:
+  * Алгоритм движения мыши **WindMouse** с физической моделью гравитации, инерции и кривых Безье.
+  * Имитация опечаток на клавиатуре и вариативной скорости набора текста.
+  * Реалистичные сенсорные жесты: тапы, свайпы и пинч-зум.
+  * Марковские цепи для эмуляции случайного блуждания и серфинга по сайтам.
+* **Прогрев сессий и решение проверок (Warmers & Solvers)**:
+  * `ProfileWarmer` — автоматический органический прогрев браузерных сессий через поисковые системы (Google, Yandex, Bing).
+  * Автоматический обход модальных окон согласия Google Consent / GDPR.
+  * Встроенный инспектор и интеграционный мост для токенов Cloudflare Turnstile.
+* **Синтез и управление профилями**:
+  * Синтез консистентных цифровых личностей по seed-ключу (`FingerprintSynthesizer`).
+  * Защищенный экспорт/импорт профилей (`.chprofile`) с опциональным AES/Fernet-шифрованием.
+  * Автоматическая гигиена и санитизация профилей (сброс флагов сбоя `exit_type`, очистка временного мусора Chromium).
+* **Сетевая инфраструктура**:
+  * Пул прокси с скорингом задержки, ротацией и health-check.
+  * Динамическая генерация Chrome Extension для базовой аутентификации прокси.
+  * Локальный TCP/SOCKS авторизационный туннель.
+* **Протокол WebDriver BiDi**:
+  * Кроссбраузерное внедрение антидетект скриптов через `script.addPreloadScript` поверх WebSocket-соединения.
+
+---
+
+## Установка
+
+Установка ядра с нулевыми тяжелыми зависимостями:
+
+```bash
+uv add browser-stealth
+# или
+pip install browser-stealth
+```
+
+Установка с поддержкой конкретных браузерных движков:
+
+```bash
+uv add "browser-stealth[playwright]"  # Для Playwright
+uv add "browser-stealth[nodriver]"    # Для nodriver
+uv add "browser-stealth[selenium]"    # Для Selenium
+uv add "browser-stealth[bidi]"        # Для протокола WebDriver BiDi
+uv add "browser-stealth[all]"         # Все компоненты
+```
+
+---
+
+## Быстрый старт
+
+### 1. Декларативная маскировка nodriver (Zero-Footprint)
+
+```python
+import asyncio
+from browser_stealth import AntidetectConfig, launch_nodriver
+
+
+async def main():
+    config = AntidetectConfig.preset_stealth_nodriver(
+        session_seed="user_account_42",
+    )
+    browser = await launch_nodriver(antidetect_config=config, headless=False)
+    page = await browser.get("https://bot.sannysoft.com")
+    await asyncio.sleep(5)
+    await browser.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### 2. Человекоподобные движения мыши (WindMouse)
+
+```python
+import asyncio
+from browser_stealth.humanize import async_move_mouse, async_type_text
+
+
+async def interact(tab):
+    # Плавное биомеханическое перемещение мыши в координаты кнопки
+    await async_move_mouse(tab, target_x=450, target_y=320)
+    # Ввод текста с естественными задержками и опечатками
+    await async_type_text(tab, "#search-input", "browser antidetect python")
+```
+
+### 3. Интеграция с Playwright
+
+```python
+import asyncio
+from playwright.async_api import async_playwright
+from browser_stealth import AntidetectConfig, apply_antidetect_playwright
+
+
+async def main():
+    config = AntidetectConfig.preset_aggressive(
+        webgl_vendor="Google Inc. (NVIDIA)",
+        webgl_renderer="ANGLE (NVIDIA, GeForce RTX 4080 Direct3D11)",
+    )
+    async with async_playwright() as p:
+        browser = await p.chromium.launch(headless=True)
+        context = await browser.new_context()
+        await apply_antidetect_playwright(context, config=config)
+        page = await context.new_page()
+        await page.goto("https://nowecure.com")
+        await browser.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## Лицензия
+
+Распространяется под лицензией MIT.

browser_stealth-0.1.0/pyproject.toml

@@ -0,0 +1,97 @@
+[project]
+name = "browser-stealth"
+version = "0.1.0"
+description = "Next-generation browser antidetect, human-like behavior emulation (WindMouse), and profile warmer for Playwright, nodriver, and Selenium."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+keywords = [
+    "playwright-stealth",
+    "nodriver",
+    "antidetect",
+    "web-scraping",
+    "windmouse",
+    "turnstile-solver",
+    "browser-automation",
+]
+dependencies = ["pydantic>=2.10.0"]
+
+[[project.authors]]
+name = "Chu4hel"
+email = "106600877+Chu4hel@users.noreply.github.com"
+
+[project.optional-dependencies]
+playwright = ["playwright>=1.40.0"]
+nodriver = ["nodriver>=0.38"]
+selenium = ["selenium>=4.15.0"]
+camoufox = ["camoufox>=0.4.0"]
+bidi = ["websockets>=14.0.0"]
+crypto = ["cryptography>=41.0.0"]
+all = ["browser-stealth[playwright,nodriver,selenium,camoufox,bidi,crypto]"]
+
+[project.entry-points."chutils.plugins.stealth"]
+browser_stealth = "browser_stealth.plugin:BrowserStealthPluginImpl"
+
+[build-system]
+requires = ["uv_build>=0.11.28,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "chutils",
+    "cryptography>=50.0.2",
+    "httpx>=0.28.1",
+    "mypy>=2.3.1",
+    "playwright>=1.62.0",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-mock>=3.16.0",
+    "ruff>=0.16.9",
+    "selenium>=4.50.0",
+    "websockets>=17.1",
+]
+docs = ["mkdocs-material>=9.5.0"]
+
+[tool.uv.sources.chutils]
+path = "../chutils"
+editable = true
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+asyncio_default_fixture_loop_scope = "function"
+markers = ["e2e: End-to-end integration and antidetect tests"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+ignore = [
+    "B009",
+    "B010",
+    "BLE001",
+    "S110",
+    "S101",
+    "PIE810",
+    "SIM103",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = [
+    "B008",
+    "B017",
+    "SIM117",
+    "RUF059",
+    "S101",
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+ignore_missing_imports = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+check_untyped_defs = true
+disallow_untyped_defs = true

browser_stealth-0.1.0/pyproject.toml.orig

@@ -0,0 +1,104 @@
+[project]
+name = "browser-stealth"
+version = "0.1.0"
+description = "Next-generation browser antidetect, human-like behavior emulation (WindMouse), and profile warmer for Playwright, nodriver, and Selenium."
+readme = "README.md"
+authors = [
+    { name = "Chu4hel", email = "106600877+Chu4hel@users.noreply.github.com" }
+]
+license = "MIT"
+requires-python = ">=3.11"
+keywords = [
+    "playwright-stealth",
+    "nodriver",
+    "antidetect",
+    "web-scraping",
+    "windmouse",
+    "turnstile-solver",
+    "browser-automation",
+]
+dependencies = [
+    "pydantic>=2.10.0",
+]
+
+[project.optional-dependencies]
+playwright = ["playwright>=1.40.0"]
+nodriver = ["nodriver>=0.38"]
+selenium = ["selenium>=4.15.0"]
+camoufox = ["camoufox>=0.4.0"]
+bidi = ["websockets>=14.0.0"]
+crypto = ["cryptography>=41.0.0"]
+all = [
+    "browser-stealth[playwright,nodriver,selenium,camoufox,bidi,crypto]",
+]
+
+[project.entry-points."chutils.plugins.stealth"]
+browser_stealth = "browser_stealth.plugin:BrowserStealthPluginImpl"
+
+[build-system]
+requires = ["uv_build>=0.11.28,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "chutils",
+    "cryptography>=50.0.2",
+    "httpx>=0.28.1",
+    "mypy>=2.3.1",
+    "playwright>=1.62.0",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-mock>=3.16.0",
+    "ruff>=0.16.9",
+    "selenium>=4.50.0",
+    "websockets>=17.1",
+]
+docs = [
+    "mkdocs-material>=9.5.0",
+]
+
+[tool.uv.sources]
+chutils = { path = "../chutils", editable = true }
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+asyncio_default_fixture_loop_scope = "function"
+markers = [
+    "e2e: End-to-end integration and antidetect tests",
+]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+ignore = [
+    "B009",   # Do not call getattr with a constant attribute name
+    "B010",   # Do not call setattr with a constant attribute name
+    "BLE001", # Do not catch blind exception
+    "S110",   # try-except-pass
+    "S101",   # Use of assert
+    "PIE810", # startswith tuple
+    "SIM103", # return condition directly
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = [
+    "B008",
+    "B017",
+    "SIM117",
+    "RUF059",
+    "S101",
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+ignore_missing_imports = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+check_untyped_defs = true
+disallow_untyped_defs = true
+

browser_stealth-0.1.0/src/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-0.1.0/src/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-0.1.0/src/browser_stealth/antidetect/_mobile_scripts.py

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

browser_stealth-0.1.0/src/browser_stealth/antidetect/antidetect.py

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

browser_stealth-0.1.0/src/browser_stealth/antidetect/antidetect_scripts.py

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