Ad Blocking

Built-in ad and tracker blocking for browser sessions

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.

Ad Blocking provides built-in filtering of advertisements, trackers, and unwanted content in your browser sessions. This improves page load performance, reduces bandwidth usage, and creates cleaner pages for scraping and automation.

Key Benefits

• Faster page loads - Skip downloading ads and trackers
• Reduced bandwidth - Lower data transfer costs
• Cleaner content - Easier extraction without ad clutter
• Better reliability - Avoid ad-related JavaScript errors

Usage

Ad blocking is enabled by default on every Notte-hosted session, controlled by the block_ads session parameter (default true). Set block_ads=False to turn it off, for example when a site breaks without its ad or tracking scripts:

ad_blocking.py

from notte_sdk import NotteClient

client = NotteClient()

# Ad blocking is on by default
with client.Session() as default_session:
    default_session.execute(type="goto", url="https://example.com")

# Turn it off when a site needs its ads or trackers to load
with client.Session(block_ads=False) as session:
    session.execute(type="goto", url="https://example.com")

block_ads only applies to browsers Notte launches. It has no effect when you connect an external browser with cdp_url; use your provider’s own ad blocking settings instead.

Next Steps

Session Configuration

Explore all session options

Proxies

Route traffic through residential proxies