How to Add Proxy to Notte

What is Notte

Notte is a browser automation platform for building, running, and deploying AI agents and web automation scripts at scale. It provides managed browser infrastructure, an agents framework, serverless functions, and observability – all through a single API.

Key Features of Notte:

Browser Sessions: Cloud-hosted browser instances with built-in anti-detection, CAPTCHA solving, and graceful fallbacks.
AI Agents: Give tasks in natural language. Agents observe pages, reason about actions, and execute autonomously.
Serverless Functions: Deploy any automation script as an API endpoint. Invoke on demand or schedule on cron.
Agent Tools: Secure credential vaults, persona identities (real email/phone for 2FA), alongside agent file storage.
Observability: Session recordings, live view debugging, with step-by-step agent replay and logs.

Notte is used for web scraping, data extraction, account automation, and any workflow that requires reliable browser control in production.

Dark-themed code editor window showing a Python example that configures an external proxy for a browser automation session, including server, username, and password fields, displayed over a soft orange gradient background with subtle network-style graphics.

Why Use Massive Proxies with Notte?

Integrating Massive Residential Proxies with Notte provides a high-performance, compliant proxy layer for browser automation at scale.

Benefits of Combining Massive Proxies with Notte:

Ethical Compliance: Massive's 100% ethically sourced IPs (user-consented, GDPR/CCPA compliant) align with enterprise compliance requirements.
Global Coverage: Access residential IPs in 195+ countries with city, state, and ZIP-level targeting for geo-specific automation.
High Success Rates: Massive's 99.8% success rate and <0.6s average response time ensure reliable session performance.
Flexible Integration: Bring your own Massive credentials into Notte's custom proxy configuration – works with HTTP, HTTPS, and SOCKS5.
Production-Ready: Combine Massive's proxy network with Notte's anti-detection, CAPTCHA solving, and browser fingerprint management for robust automation.

What Are the Common Use Cases for Massive Proxies with Notte?

Pairing Massive Residential Proxies with Notte supports a wide range of automation workflows:

Web Scraping and Data Extraction

Run Notte agents or scraping scripts through Massive's rotating residential IPs to extract data at scale without detection or blocking.

Account Automation

Use Notte's persona identities (real email/phone) with Massive proxies to create and manage accounts on platforms requiring verification and geo-specific IPs.

Price and Inventory Monitoring

Deploy scheduled Notte functions to monitor competitor pricing, stock levels, or marketplace listings across regions using Massive's geo-targeted proxies.

Ad Verification

Verify ad placements and detect fraud across different geographies by running Notte sessions through Massive's residential network.

Market Research

Collect localised data from search engines, social platforms, and e-commerce sites using Notte's AI agents paired with Massive's country/city-specific IPs.

Massive Residential Proxies

Massive offers an ethically sourced residential proxy network built for performance and compliance:

Ethical Sourcing: 100% user-consented IPs, GDPR and CCPA compliant, AppEsteem certified.
Global Reach: 1M+ residential IPs across 195+ countries with city, state, and ZIP targeting.
High Performance: 99.8% success rate, <0.6s average response time, 99.9% uptime.
Protocol Support: HTTP, HTTPS, and SOCKS5.
Unlimited Connections: Scale concurrent sessions without restrictions.

Adding Massive Proxies to Notte

1. Get Your Massive Proxy Credentials

First, sign up for a Massive account and obtain your credentials:

Visit partners.joinmassive.com to access your dashboard
Locate your username and password in the partner portal
Choose your protocol based on your use case:
- HTTP: Port 65534 (recommended for most use cases)
- HTTPS: Port 65535 (for enhanced security requirements)‍
- SOCKS5: Port 65533 (for advanced routing needs)

2. Install Notte SDK

pip install notte-sdk

‍

3. Configure Massive Proxies in Notte

Import the Notte SDK and configure your Massive proxy settings:

from notte_sdk import NotteClient
from notte_sdk.types import ExternalProxy

# Initialize Notte client
notte_client = NotteClient()

# Configure Massive proxy settings
massive_proxy = ExternalProxy(
    server="http://network.joinmassive.com:65534",  # HTTP protocol
    username="your-username",  # From partners.joinmassive.com
    password="your-password",  # From partners.joinmassive.com
)

# Create a session with Massive proxies
with notte_client.Session(proxies=[massive_proxy]) as session:
    # Navigate to your target URL
    session.observe(url="https://www.notte.cc")
    
    # Your automation tasks here
    # ...

‍

4. Advanced Targeting with Massive

Massive supports advanced geo-targeting and device-type targeting through the username parameter. Simply modify your username string to include targeting parameters:

Geographic Targeting

# Target specific country
massive_proxy = ExternalProxy(
    server="http://network.joinmassive.com:65534",
    username="your-username-country-US",  # United States
    password="your-password",
)

# Target specific state/subdivision
massive_proxy = ExternalProxy(
    server="http://network.joinmassive.com:65534",
    username="your-username-country-US-subdivision-CA",  # California
    password="your-password",
)

# Target specific city
massive_proxy = ExternalProxy(
    server="http://network.joinmassive.com:65534",
    username="your-username-country-US-subdivision-CA-city-San Francisco",
    password="your-password",
)

‍

Device-Type Targeting

# Target desktop devices
massive_proxy = ExternalProxy(
    server="http://network.joinmassive.com:65534",
    username="your-username-device-desktop",
    password="your-password",
)

# Target mobile devices
massive_proxy = ExternalProxy(
    server="http://network.joinmassive.com:65534",
    username="your-username-device-mobile",
    password="your-password",
)

‍

Combining Multiple Parameters

# Target mobile devices in New York
massive_proxy = ExternalProxy(
    server="http://network.joinmassive.com:65534",
    username="your-username-country-US-subdivision-NY-city-New York-device-mobile",
    password="your-password",
)

‍

Complete Example Script

Here's a complete, production-ready script demonstrating Massive proxy integration with Notte:

from notte_sdk import NotteClient
from notte_sdk.types import ExternalProxy
import os
from dotenv import load_dotenv

# Load environment variables
load_dotenv()

def main():
    # Get credentials from environment variables
    massive_username = os.getenv("MASSIVE_USERNAME")
    massive_password = os.getenv("MASSIVE_PASSWORD")
    notte_api_key = os.getenv("NOTTE_API_KEY")
    
    if not all([massive_username, massive_password, notte_api_key]):
        raise ValueError("Missing required environment variables")
    
    # Initialize Notte client
    notte_client = NotteClient(api_key=notte_api_key)
    
    # Configure Massive proxy with US targeting
    massive_proxy = ExternalProxy(
        server="http://network.joinmassive.com:65534",
        username=f"{massive_username}-country-US",
        password=massive_password,
    )
    
    try:
        print("Creating Notte session with Massive proxies...")
        
        # Create session with Massive proxy
        with notte_client.Session(proxies=[massive_proxy]) as session:
            # Create an agent for automated tasks
            agent = notte_client.Agent(session=session, max_steps=10)
            
            # Run your automation task
            result = agent.run(
                task="extract pricing information from https://www.notte.cc"
            )
            
            print(f"Task completed: {result.answer}")
            
    except Exception as e:
        print(f"Error during automation: {e}")
        raise

if __name__ == "__main__":
    main()

‍

Environment Variables (.env file)

# Massive Proxy Credentials (from partners.joinmassive.com)
MASSIVE_USERNAME=your-massive-username
MASSIVE_PASSWORD=your-massive-password

# Notte API Key
NOTTE_API_KEY=your-notte-api-key

‍

Conclusion

Integrating Massive residential proxies with Notte combines best-in-class browser automation with ethically sourced, high-performance proxy infrastructure. This powerful combination enables you to build reliable, scalable web scraping and automation workflows while maintaining full compliance with privacy regulations.

With Massive's 99%+ success rate, sub-2-second response times, and advanced geo-targeting capabilities, your Notte agents can access content from anywhere in the world with the authenticity of real residential IPs. Whether you're conducting market research, verifying ads, monitoring SEO, or collecting competitive intelligence, the Massive-Notte integration provides the infrastructure you need to succeed.

Ready for a free 2 GB trial?