Il browser integrato di Cursor va bene per controllare una web app in locale. Naviga, clicca e fa screenshot. Ma resta una webview isolata: non conserva davvero le sessioni, non ha un fingerprint credibile e non ti aiuta quando il sito controlla Cloudflare, DataDome o altri sistemi anti-bot.
TL;DR: collega Cursor a Clawbrowser via CDP (Chrome DevTools Protocol). L'agente usa un Chromium reale con profili persistenti, fingerprint gestiti e proxy routing. Installi il runtime, avvii un profilo e punti Cursor all'endpoint locale.
Perché il browser integrato di Cursor non basta
Cursor include un browser tool basato su una webview sandboxed esposta da un MCP server. Per sviluppo locale è utile: navigate, click, type, scroll, screenshot, console output e network traffic.
Sul web reale, però, i limiti si vedono subito:
| Limite | Cosa succede |
|---|---|
| Webview sandboxed | Non è una vera istanza Chromium. I siti rilevano API mancanti e proprietà window non standard. |
| Nessuna persistenza sessione | Cookies e localStorage sono legati al workspace e non sono affidabili tra sessioni. |
| Nessuna gestione fingerprint | Canvas hash, WebGL renderer e navigator properties restano statici a ogni run. |
| Nessun proxy support | Il traffico usa l'IP di default della macchina. Le IP datacenter vengono segnalate rapidamente. |
| Problemi di affidabilità | Cursor 2.3.18+ ha avuto regressioni su click, scroll e ricerca elementi, con report ancora aperti. |
Non è un problema teorico. Se l'agente deve fare login, scraping o workflow multi-step su un sito protetto, la webview integrata parte già svantaggiata.
Cosa ti dà CDP
CDP (Chrome DevTools Protocol) è l'interfaccia standard per controllare browser Chromium via codice. Playwright usa connectOverCDP, Puppeteer usa puppeteer.connect e i client CDP aprono un WebSocket verso la porta di debugging.
Con Cursor collegato a un browser esterno via CDP ottieni:
- Un browser reale con motore di rendering completo, estensioni e API standard
- Sessioni persistenti con cookies e stato login riutilizzabili tra run
- Controllo completo della pagina tramite lo stesso protocollo usato da Playwright e Puppeteer
- Anti-detection quando browser, fingerprint e proxy descrivono la stessa identità
La connessione è una normale URL WebSocket. Qualsiasi tool che parla CDP può attaccarsi a un browser con endpoint CDP. Clawbrowser ne espone uno per ogni profilo.
Collegare Cursor a Clawbrowser: passo passo
Prerequisiti
- macOS (Apple Silicon), Linux (x64 o arm64) o Windows
- Cursor installato
- Una API key Clawbrowser da
app.clawbrowser.ai
Step 1: installare Clawbrowser
Scarica ed estrai il bootstrapper clawctl:
# macOS (Apple Silicon)
archive="clawctl-macos-arm64.tar.gz"
curl -fL --retry 3 -o "$archive" \
"https://github.com/clawbrowser/clawctl/releases/latest/download/${archive}"
tar -xzf "$archive"Su Linux usa clawctl-linux-amd64.tar.gz o clawctl-linux-arm64.tar.gz. Non servono Docker o sudo.
Imposta la API key:
./clawctl config set api-keyStep 2: avviare un profilo browser
Avvia Clawbrowser con un profilo nominato. Ogni profilo ha fingerprint, cookie storage e proxy opzionale separati:
# Start a profile and open the verification page
clawctl start --profile cursor-dev --url clawbrowser://verify/ --json
# Get the CDP endpoint for this profile
clawctl endpoint --profile cursor-dev --jsonIl comando endpoint restituisce una URL come http://127.0.0.1:9222. È l'endpoint CDP che Cursor userà.
Step 3: connettere Cursor via MCP
L'integrazione più semplice passa dal MCP server integrato in Clawbrowser. Espone navigazione, screenshot, click, tab management e avvio profili come strumenti MCP che Cursor può chiamare direttamente. Il server gestisce CDP internamente.
Esegui l'installer per scrivere la configurazione MCP locale:
clawctl install --agent all --jsonCursor leggerà il MCP server dalla configurazione.
Alternativa: Microsoft Playwright MCP
Se preferisci il server Microsoft Playwright MCP ufficiale, puntalo all'endpoint CDP di Clawbrowser in Cursor Settings > MCP > Add Server:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [Entrambe le strade danno a Cursor accesso ad alto livello al browser. Il MCP server Clawbrowser aggiunge gestione profili e fingerprint sopra le azioni standard.
Step 4: verificare la connessione
Chiedi all'agente Cursor di aprire una pagina di test:
Navigate to https://browserleaks.com/canvas and take a screenshot. Tell me what canvas fingerprint hash you see.
Se la connessione funziona, vedrai un canvas fingerprint reale dal profilo Clawbrowser, non l'hash generico della webview.
Connessione CDP diretta dal codice
Se l'agente Cursor scrive ed esegue script invece di usare MCP, collega Playwright o Puppeteer direttamente:
Playwright (Python)
from playwright.async_api import async_playwright
async def browse_with_clawbrowser():
async with async_playwright() as p:
# Connect to Clawbrowser's CDP endpointPlaywright (Node.js)
const { chromium } = require('playwright');
const browser = await chromium.connectOverCDP('http://127.0.0.1:9222');
const page = browser.contexts()[0].pages()[0];
Puppeteer
const puppeteer = require('puppeteer');
const browser = await puppeteer.connect({
browserURL: 'http://127.0.0.1:9222'
});Tutti e tre i framework si collegano allo stesso endpoint CDP. Clawbrowser gestisce lo strato identity: Canvas, WebGL, AudioContext, font, risoluzione, timezone, navigator properties e proxy routing restano coerenti nel profilo.
Perché l'anti-detection conta per gli agenti Cursor
Quando un agente Cursor naviga con un browser standard, i sistemi anti-bot controllano l'identità su più superfici:
| Segnale | Cosa viene controllato | Chrome standard | Clawbrowser |
|---|---|---|---|
| Canvas hash | GPU rendering fingerprint | Static, matches known automation profiles | Unique per profile, consistent with reported GPU |
| WebGL renderer | Graphics card identifier | Exposes real hardware | Matches the profile's simulated hardware |
| Navigator properties | Browser version, platform, language | Generic Chromium values | Consistent with profile's OS and locale |
| Timezone | System timezone vs IP geo | Mismatches with proxy location | Auto-aligned with proxy geography |
| CDP detection | Runtime.enable traces |
Detectable via leaked CDP artifacts | Engine-level patches suppress CDP signals |
Una normale istanza Chromium controllata via CDP lascia tracce che gli anti-bot leggono in pochi secondi. Clawbrowser interviene a livello di engine, non con override JavaScript facili da scoprire.
È la differenza tra collegare Cursor a chrome --remote-debugging-port=9222, che viene bloccato, e collegarlo a Clawbrowser, che mantiene una fingerprint coerente.
Gestire più profili
Ogni profilo Clawbrowser è isolato. Puoi eseguire più profili in parallelo per account o progetti diversi:
# Create three profiles with different locations
clawctl create --profile account-a --location sweden --json
clawctl create --profile account-b --location germany --json
clawctl create --profile account-c --location japan --json
Ogni profilo ha fingerprint unico, IP proxy proprio e storage isolato. Le piattaforme vedono utenti indipendenti su macchine e paesi diversi.
L'agente Cursor può passare da un profilo all'altro usando endpoint CDP diversi, oppure gestirli in parallelo dallo stesso script.
Browser integrato Cursor vs CDP vs Clawbrowser
| Cursor integrato | Chrome via CDP | Clawbrowser via CDP | |
|---|---|---|---|
| Browser engine | Sandboxed webview | Real Chromium | Real Chromium (patched) |
| Session persistence | Workspace-scoped | Manual profile dirs | Named profiles with auto-persistence |
| Fingerprint management | None | None | 20+ surfaces managed per profile |
| Proxy support | None | Manual flag | Profile-bound, geo-aligned |
| Anti-bot survival | Blocked instantly | Blocked within minutes | Passes Cloudflare, DataDome, PerimeterX |
| Multi-account | Not possible | Separate --user-data-dir |
Built-in profile isolation |
| Setup complexity | Zero (built in) | Moderate | Three commands |
Usa il browser integrato per ispezionare la tua app in localhost. Usa Clawbrowser via CDP per tutto ciò che tocca il web reale.
FAQ
Funziona con l'agent mode di Cursor?
Sì. L'agent mode di Cursor può usare qualunque MCP server, inclusi quelli che controllano browser esterni via CDP. L'agente chiama gli strumenti MCP come farebbe con il browser integrato, ma le azioni girano in Clawbrowser.
Devo installare Playwright o Puppeteer?
Solo se l'agente scrive ed esegue script di automazione. Nel flusso MCP, il server gestisce internamente CDP e l'agente usa azioni ad alto livello come "navigate" e "click".
Posso riutilizzare sessioni di login tra progetti Cursor?
Sì. I profili Clawbrowser conservano cookies, localStorage e IndexedDB. Avvia un profilo, fai login manualmente o con l'agente e riutilizzalo nelle sessioni successive.
E se il browser tool di Cursor crea confusione con quello esterno?
Puoi disattivare il browser integrato in Settings > Features > Browser. In alternativa possono coesistere: sono due browser indipendenti.
Clawbrowser è gratuito?
Sì. Clawbrowser è gratuito, open source e MIT-licensed. Nessun costo per seat, nessun limite d'uso, nessun abbonamento al runtime. Serve una API key da app.clawbrowser.ai per validare l'installazione.
Inizia
Tre comandi per collegare il tuo agente Cursor a un browser reale:
# Install Clawbrowser
clawctl install --json
# Set your API key
clawctl config set api-keyPunta il tuo MCP server o script Playwright all'endpoint restituito. L'agente Cursor naviga con fingerprint gestiti, sessioni persistenti e proxy routing.
Per approfondire CDP, leggi CDP browser per agenti AI: guida agli sviluppatori. Per il fingerprinting, leggi Browser fingerprinting: 20 segnali anti-bot.
Continua a leggere
Articoli correlati
CDP vs MCP: quando usare quale per il controllo browser con IA
CDP controlla il browser. MCP connette l'IA. Scopri quando usare Chrome DevTools Protocol e quando Model Context Protocol per l'automazione browser con agenti AI.
Leggi l’articolo →
Browser anti-detect gratis per agenti IA: quali funzionano davvero
La maggior parte dei browser anti-detect addebita per profilo o per sessione. Ecco cosa è realmente gratis per l'automazione con agenti IA, cosa ha dei limiti nascosti e come si confrontano le opzioni.
Leggi l’articolo →