Stealth Mode

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Notte sessions include built-in stealth features to help your automations avoid detection by anti-bot systems.

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:

from notte_sdk import NotteClient

client = NotteClient()

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

Override the default user agent for specific requirements:

from notte_sdk import NotteClient

client = NotteClient()

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:

realistic_behavior.py

import random
import time

from notte_sdk import NotteClient

client = NotteClient()

with client.Session() as session:
    page = session.page
    page.goto("https://example.com")

    # Bad: Instant actions
    page.click("button")
    page.fill("input", "text")

    # Good: Human-like delays
    page.click("button")
    time.sleep(random.uniform(0.5, 1.5))
    page.fill("input", "text")

2. Rotate Proxies

Use different proxies for different sessions:

rotate_proxies.py

from notte_sdk import NotteClient

client = NotteClient()

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

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

3. Match Viewport to Real Devices

Use common screen resolutions:

from notte_sdk import NotteClient

client = NotteClient()

# Desktop
with client.Session(viewport_width=1920, viewport_height=1080) as desktop:
    pass

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

import { NotteClient } from "notte-sdk";

const client = new NotteClient();

// Desktop
const desktop = client.Session({ viewport_width: 1920, viewport_height: 1080 });
await desktop.use(async () => {});

// Laptop
const session = client.Session({ viewport_width: 1366, viewport_height: 768 });
await session.use(async () => {});

4. Combine Multiple Techniques

Layer stealth features for best results:

from notte_sdk import NotteClient

client = NotteClient()

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

import { NotteClient } from 'notte-sdk';

const client = new NotteClient();

const session = 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",
});
await session.use(async () => {
  // Maximum stealth configuration
});

Testing Stealth

Test your stealth configuration against detection services:

from notte_sdk import NotteClient

client = NotteClient()

test_sites = [
    "https://bot.sannysoft.com/",
    "https://arh.antoinevastel.com/bots/areyouheadless",
    "https://fingerprint.com/demo/"
]

with client.Session(proxies=True) as session:
    page = session.page

    for site in test_sites:
        page.goto(site)
        page.screenshot(path=f"stealth_test_{site.split('//')[1].split('/')[0]}.png")

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

Combine stealth with automatic captcha solving for comprehensive protection:

from notte_sdk import NotteClient

client = NotteClient()

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

Getting Started

Sessions

Authentication

Functions

Web API

Guides

Stealth Mode

Built-in Stealth Features

Basic Usage

Enhanced Stealth with Proxies

Custom User Agents

Stealth Best Practices

1. Use Realistic Behavior

2. Rotate Proxies

3. Match Viewport to Real Devices

4. Combine Multiple Techniques

Testing Stealth

What Stealth Can’t Do

Stealth + Captcha Solving

Next Steps

Proxies

CAPTCHA Solving

Browser Types

Multi-Region Support

​Built-in Stealth Features

​Basic Usage

​Enhanced Stealth with Proxies

​Custom User Agents

​Stealth Best Practices

​1. Use Realistic Behavior

​2. Rotate Proxies

​3. Match Viewport to Real Devices

​4. Combine Multiple Techniques

​Testing Stealth

​What Stealth Can’t Do

​Stealth + Captcha Solving

​Next Steps

Proxies

CAPTCHA Solving

Browser Types

Multi-Region Support

Built-in Stealth Features

Basic Usage

Enhanced Stealth with Proxies

Custom User Agents

Stealth Best Practices

1. Use Realistic Behavior

2. Rotate Proxies

3. Match Viewport to Real Devices

4. Combine Multiple Techniques

Testing Stealth

What Stealth Can’t Do

Stealth + Captcha Solving

Next Steps