CDP Browser per AI Agents: A Developer Guide — copertina di articolo illustrata Clawbrowser

Browser CDP per agenti AI: una guida per sviluppatori

Clawbrowser Teamai-agentiCdAguida

Se il vostro agente raschia i dati, riempie i moduli, gestisce più account o naviga i flussi di lavoro multi-step, controlla il browser attraverso un protocollo. Per ogni importante framework agente, che il protocollo è CDP (Chrome DevTools Protocol). Il problema: collegare il vostro agente ad un'istanza standard Chromium lo ottiene rilevato e bloccato in pochi minuti.

TL;DR: CDP è il protocollo standard che gli agenti AI utilizzano per controllare i browser. Standard Chrome espone i segnali di automazione che i sistemi anti-bot rilevano istantaneamente. Clawbrowser è una forchetta Chromium con Native CDP, impronte gestite su 20+ superfici, routing proxy incorporato e un MCP server. Il tuo agente si connette a un browser reale che non viene bloccato.


Che cos'è il Chrome DevTools Protocol?

CDP è un protocollo basato su WebSocket che dà programmi esterni pieno controllo su un browser Chromium. È stato costruito per Chrome DevTools (l'ispettore che si apre con F12), ma è diventato lo standard de facto per l'browser automation.

Attraverso CDP, un cliente può:

  • Passare a URL e gestire le schede
  • Eseguire JavaScript arbitrario in contesto pagina
  • Acquisire screenshot e PDF
  • Intercetta e modifica le richieste di rete
  • Gestione dei cookie, archiviazione e cache
  • Simulare l'ingresso dell'utente: click, keypress, scorrimento

Il modello di connessione è semplice. Inizia Chrome con una porta di debugging, e qualsiasi client WebSocket può connettersi:

# Start Chrome with CDP enabled
chrome --remote-debugging-port=9222
// Connect from Node.js with Puppeteer
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:9222/devtools/browser/...'
});
const page = await browser.newPage();

Un protocollo, un endpoint, il controllo completo del browser, è per questo che CDP ha vinto.


Perché ogni AI Agent Framework utilizza CDP

Il CDP è il connettore universale tra gli agenti dell'AI e i browser. Ogni quadro dell'agente principale si aspetta un CDP endpoint:

Agente Connessione CDP
Claude Code MCP server o CDP endpoint
OpenAI Codex connect_over_cdp()
Cursor CDP WebSocket
Browser Use CDP endpoint
Hermes Agent CDP endpoint
OpenClaw CDP endpoint
Kilo Code CDP endpoint
Puppeteer client Native CDP
Playwright (Chromium) connect_over_cdp()

Quando il vostro agente ha bisogno di un browser, si aspetta ws://localhost:9222. Non Juggler (protocollo di Firefox), non WebDriver BiDi, non un REST API proprietario. CDP.

Ecco perché i browser anti-detect basati su Firefox non possono collegarsi alla maggior parte dei flussi di lavoro degli agenti senza un livello adattatore: utilizzano un protocollo completamente diverso. Se lo stack è Agent → CDP → Browser, il browser deve essere basato su Chromium.


Il problema: Chrome standard viene rilevato

Chrome standard con --remote-debugging-port I sistemi anti-bot come Cloudflare, DataDome e PerimeterX rilevano il Chrome guidato da CDP attraverso più segnali:

1. navigator.webdriver flag. Chrome imposta questo a true quando controllato tramite CDP. E' la prima cosa che gli script anti-bot controllano.

2. CDP runtime artefatti. Runtime.evaluate le chiamate lasciano tracce nel contesto di esecuzione JavaScript che differiscono dalle interazioni reali dell'utente.

3. Impronte di default. Un'istanza Chrome fresco restituisce i valori di fabbrica-default Canvas, WebGL e AudioContext. I browser reali hanno impronte digitali uniche modellate da GPU, driver e configurazione del sistema operativo.

4. Profilo del browser mancante. Nessuna cronologia di navigazione, nessun cookie, nessun font memorizzato nella cache, nessuna estensione.

5. Le perdite di modalità senza testa. Anche --headless=new produce differenze rilevabili nel comportamento di rendering, array di plugin e dimensioni dello schermo.

Il risultato: il vostro agente si connette a Chrome, naviga al bersaglio e colpisce una parete CAPTCHA o un blocco silenzioso. La connessione CDP funziona perfettamente. Il browser è ciò che non funziona.


Collegare il vostro agente a Clawbrowser

Clawbrowser è una forchetta Chromium costruita per esattamente questo caso di utilizzo: un browser CDP per agenti AI che gestisce anti-detection a livello del browser. Il vostro agente si connette a un CDP endpoint standard. Il browser gestisce tutto il resto.

Inizia una sessione con un'impronta gestita

# Start Clawbrowser with a managed fingerprint profile
clawctl session start --profile residential-us-1

# CDP endpoint is immediately available
# ws://localhost:9222/devtools/browser/...

Collegamento da Playwright o Puppeteer

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    # Connect to Clawbrowser's CDP endpoint, same as any Chrome
    browser = p.chromium.connect_over_cdp("ws://localhost:9222")
// Puppeteer: zero changes to existing code
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:9222/devtools/browser/...'
});
const page = await browser.newPage();

Eseguire più sessioni isolate con routing proxy

# Session 1: US residential proxy, unique fingerprint
clawctl session start --profile us-east --proxy socks5://us-proxy:1080

# Session 2: EU residential proxy, different fingerprint
clawctl session start --profile eu-west --proxy socks5://eu-proxy:1080

Ogni sessione ottiene un profilo di impronta digitale completo e coerente internamente. Il renders di tela corrisponde ai parametri GPU riportati. I parametri WebGL corrispondono alla scheda grafica. Le proprietà del navigatore corrispondono alla versione del sistema operativo e del browser.


CDP + MCP: due protocolli, uno studio legale

MCP (Model Context Protocol) fornisce agli agenti dell'IA un accesso agli strumenti di alto livello. Clawbrowser supporta sia sulla stessa istanza.

Con CDP, il tuo agente invia comandi granulari: navigare in URL, fare clic su elemento alle coordinate, eseguire questo JavaScript.

Con MCP, il tuo agente chiama le funzioni degli strumenti: navigate, screenshot, extract_text. Il MCP server li traduce in operazioni CDP internamente. Meno codice, integrazione più veloce, ma controllo meno granulare.

La divisione pratica:

  • Utilizza CDP quando il tuo agente esegue script di automazione personalizzati, ha bisogno di intercezione di rete o utilizza Puppeteer/Playwright direttamente.
  • Utilizzare MCP quando il vostro agente è un LLM che ha bisogno di accesso al browser a livello di strumento (Codice di riconoscimento, Codex o qualsiasi agente compatibile con MCP).
  • Utilizza entrambi quando il tuo orchestratore gestisce la sessione su CDP mentre i singoli agenti LLM interagiscono attraverso MCP.

Nessun altro Anti-Detect Browser offre entrambi i protocolli sulla stessa istanza.


Opzioni del browser CDP confrontate

Caratteristica Clawbrowser Chrome Browserbase Steel Camoufox
Native CDP Sì. Sì. Sì. Sì. No (Juggler)
Anti-detection. 20+ superfici None Sì. Sì. Sì.
Le impronte gestite Sì. No. Sì. Sì. Sì (BrowserForge)
Proxy routing Costruito No. Sì. Sì. Manuale
MCP server Costruito No. No. No. No.
Dislocazione Locale / self-hosted Locale locale Solo cloud Solo cloud Locale locale
Tre volte Gratis Gratis Da $150/mo Da $99/mo Gratis

Clawbrowser è l'unica opzione che combina Native CDP, impronte gestite, routing proxy integrato e un MCP server, ed è gratuito.


Iniziare

# Install Clawbrowser
clawctl install

# Start a session with default fingerprint
clawctl session start --profile default

Il codice CDP esistente funziona in modo immutato. Indica il tuo agente al punto finale. Il browser gestisce automaticamente le impronte digitali, il routing proxy e l'anti-detection.


FAQ

Clawbrowser lavora con Puppeteer e Playwright?

Sì. Clawbrowser espone un CDP endpoint. puppeteer.connect() o playwright.chromium.connect_over_cdp() con l'URL WebSocket esattamente come si farebbe con Chrome regolare. Nessun codice cambia richiesto.

Posso eseguire più sessioni simultaneamente?

Ogni sessione ottiene il proprio CDP endpoint, il profilo delle impronte digitali, i cookie e il proxy opzionale. Eseguire quante più sessioni supportate dall'hardware. Le sessioni sono completamente isolate senza uno stato condiviso tra di loro.

Clawbrowser è gratuito per uso commerciale?

Sì. Clawbrowser è gratuito e open source. Nessun limite di utilizzo, nessun prezzo per sessione, nessuna chiave API richiesta. Utilizzare in produzione, in CI/CD o sulla vostra macchina locale.

Qual è la differenza tra CDP e MCP in Clawbrowser?

MCP (Model Context Protocol) fornisce un controllo del browser di alto livello: navigare, fare clic, eseguire JavaScript, intercettare le richieste di rete. MCP (Model Context Protocol) fornisce un accesso agli strumenti di alto livello: navigare, screenshot, estrarre il testo.

Funziona in modalità Docker e senza testa?

Sì. Clawbrowser funziona a Docker con lo stesso CDP endpoint esposto. --headless per ambienti server. Tutta la gestione delle impronte funziona identicamente in modalità senza testa.

Continua a leggere

Vedi tutti →