CloakBrowser.

# Python
pip install cloakbrowser

# Node.js（Playwright 或 Puppeteer 二選一）
npm install cloakbrowser playwright-core
npm install cloakbrowser puppeteer-core

# Linux 需要的系統函式庫
playwright install-deps chromium

from cloakbrowser import launch

browser = launch()                            # 預設 headless
page = browser.new_page()
page.goto("https://protected-site.com")   # 不再被擋
print(page.title())
browser.close()

- from playwright.sync_api import sync_playwright
- pw = sync_playwright().start()
- browser = pw.chromium.launch()
+ from cloakbrowser import launch
+ browser = launch()

# 後面的程式完全不動
page = browser.new_page()
page.goto("https://example.com")

from cloakbrowser import launch, launch_async, launch_context, launch_persistent_context

# 1. 同步、headless
browser = launch()

# 2. 帶 proxy（住宅級代理建議）
browser = launch(proxy="http://user:pass@proxy:8080")

# 3. headful（用 Xvfb 在無 GUI 的 Linux 伺服器上跑）
browser = launch(headless=False)

# 4. 非同步
async def main():
    browser = await launch_async()
    page = await browser.new_page()
    await page.goto("https://example.com")
    await browser.close()

# 5. 一次給好 UA／viewport／locale／時區
context = launch_context(
    user_agent="Mozilla/5.0 ...",
    viewport={"width": 1920, "height": 1080},
    locale="zh-TW",
    timezone="Asia/Taipei",
)

# 6. 帶 cookie/localStorage 的持久 profile
context = launch_persistent_context(user_data_dir="./profile-a")

from cloakbrowser import binary_info, clear_cache, ensure_binary

print(binary_info())   # 檢查 binary 版本與安裝狀態
clear_cache()          # 強制重新下載
ensure_binary()        # Docker build 時預先抓 binary，容器啟動即用

# 固定種子 → 同一台「裝置」反覆登入
# 隨機種子 → 每次都是新裝置
browser = launch(args=["--fingerprint=12345"])

# 強制平台（Linux 機器偽裝成 Windows）
browser = launch(args=[
    "--fingerprint-platform=windows",
    "--fingerprint-gpu-vendor=NVIDIA Corporation",
])

# humanize=True 自動加入：滑鼠 bezier 曲線移動、打字節奏、隨機 idle
browser = launch(
    humanize=True,
    human_config={
        "mistype_chance": 0.1,        # 10% 機率打錯然後 backspace
        "typing_delay": 50,           # 平均 50ms / 字
        "idle_between_actions": True,
    },
)

# 開啟 web UI 來管理 N 個 profile，每個獨立 fingerprint + proxy
docker run -p 8080:8080 -v cloakprofiles:/data cloakhq/cloakbrowser-manager

# 開 http://localhost:8080 → 建立 profile → Launch → 完成

# 適用 Selenium、Stagehand、undetected-chromedriver
from cloakbrowser.download import ensure_binary
from cloakbrowser.config import get_default_stealth_args

binary_path = ensure_binary()              # 沒下載就自動下載
stealth_args = get_default_stealth_args()  # 所有指紋旗標

# 把上面兩個塞給你框架的 launch options

# 適用 browser-use、Crawl4AI、Scrapling
from cloakbrowser import launch_async

browser = await launch_async(args=["--remote-debugging-port=9242"])

# 你的 AI agent 框架連到 http://127.0.0.1:9242
# 隱形指紋自動生效；只有 humanize 需要包裝層額外注入