Stealth Mode

Configure anti-detection features for your browser sessions

Built-in Stealth Features#

All Notte sessions automatically include:

• Clean browser fingerprints - Realistic browser signatures
• Navigator properties - Proper webdriver, plugins, and language settings
• Canvas fingerprinting protection - Randomized canvas signatures
• WebGL fingerprinting protection - Unique WebGL parameters
• Timezone and locale matching - Consistent geolocation data
• Chrome DevTools Protocol hiding - CDP detection prevention

Basic Usage#

Stealth features are enabled by default. Simply create a session:

from notte_sdk import NotteClient
 
client = NotteClient()
 
with client.Session() as session:
    page = session.page
    page.goto("https://bot-detection-test.com")
    # Stealth features automatically active

Enhanced Stealth with Proxies#

Combine stealth mode with residential proxies for maximum anonymity:

with client.Session(
    proxies=True,  # Enable residential proxies
    browser_type="chrome"  # Use Chrome for best compatibility
) as session:
    page = session.page
    page.goto("https://example.com")

Custom User Agents#

with client.Session(
    user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
) as session:
    page = session.page
    page.goto("https://example.com")

Stealth Best Practices#

1. Use Realistic Behavior#

Avoid patterns that look automated — add human-like delays between actions instead of instant clicks and fills.

2. Rotate Proxies#

Use different proxies for different sessions:

# Session 1 with US proxy
with client.Session(proxies="us") as session:
    pass
 
# Session 2 with UK proxy
with client.Session(proxies="gb") as session:
    pass

3. Match Viewport to Real Devices#

# Desktop
with client.Session(viewport_width=1920, viewport_height=1080) as session:
    pass
 
# Laptop
with client.Session(viewport_width=1366, viewport_height=768) as session:
    pass

4. Combine Multiple Techniques#

with client.Session(
    browser_type="chrome",
    proxies=True,
    viewport_width=1920,
    viewport_height=1080,
    user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
) as session:
    # Maximum stealth configuration
    pass

What Stealth Can't Do#

Stealth features help avoid detection, but they cannot:

• Bypass login rate limits (use delays between attempts)
• Avoid behavioral analysis (act like a human)
• Bypass IP-based blocking (use proxy rotation)
• Solve all captchas automatically (use captcha solving)

Stealth + Captcha Solving#

with client.Session(
    solve_captchas=True,
    proxies=True
) as session:
    page = session.page
    page.goto("https://example.com/login")
    # Both stealth and captcha solving active

Next Steps#

• Proxies — Configure residential proxies

• CAPTCHA Solving — Automatically solve captchas

• Browser Types — Choose the right browser engine

• Multi-Region Support — Run sessions in different regions

Back to overview