Come collegare Browserless a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Browserless, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Browserless + Cursor

Browser cloud di Browserless dalla tua AI: leggi pagine renderizzate come markdown, HTML o link con lo smart scrape, estrai elementi con selettori CSS, cattura screenshot, stampa PDF, esegui audit Lighthouse, mappa gli URL di un sito e apri pagine protette da sistemi anti-bot con l'API unblock. Tutti gli strumenti tranne il controllo della versione spendono unità Browserless.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

BROWSERLESS_API_TOKEN, BROWSERLESS_HOST

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Browserless; il piano gratuito include unità mensili.

1. Accedi a https://browserless.io/account/ e copia l'API token dalla dashboard.
2. Incollalo in BROWSERLESS_API_TOKEN. Browserless lo riceve come parametro di query token in ogni chiamata; viene inviato solo all'host indicato sotto.
3. Imposta BROWSERLESS_HOST sulla regione del tuo piano, senza https://: production-sfo.browserless.io (costa ovest USA, il default per i piani condivisi), production-lon.browserless.io (Londra) o production-ams.browserless.io (Amsterdam). I piani dedicati (private fleet) usano chrome.browserless.io o il loro host regionale chrome-...browserless.io; un token privato su un host condiviso viene rifiutato con 401.
4. Installa il connettore ed esegui browserless_get_meta: restituisce la versione del servizio Browserless sull'host e conferma il token.

Cosa costa unità: tutti gli strumenti tranne browserless_get_meta spendono unità Browserless del tuo piano: 1 unità ogni 30 secondi di browser (arrotondato per eccesso; i download semplici nello smart scrape costano 0,5), più 6 unità per MB di traffico su proxy residenziale o 2 per MB su proxy datacenter, e 10 unità per ogni CAPTCHA risolto. browserless_smart_scrape e browserless_map usano di default il proxy residenziale, e i formati json e summary dello smart scrape aggiungono unità di estrazione AI. stealth: true non costa nulla in più. L'AI ti chiede conferma prima di una serie di chiamate e prima di usare un proxy su pagine grandi.

Leggere pagine: browserless_smart_scrape è la prima scelta. Prova un download semplice, poi un proxy, poi un browser completo, dice quale strategia ha servito la pagina e restituisce i formats richiesti: markdown (il default qui), html, rawText, links, screenshot, pdf, json (estrazione AI con uno schema o un prompt in json_options) o summary. only_main_content, include_tags ed exclude_tags sfoltiscono la pagina. browserless_get_content restituisce l'HTML completamente renderizzato di un URL, o di HTML che passi tu, da un Chrome vero. browserless_scrape restituisce testo, HTML e attributi di ogni elemento che corrisponde ai tuoi selettori CSS.

Immagini e documenti: browserless_screenshot cattura l'area visibile, l'intera pagina o un elemento (selector) in PNG, JPEG o WebP, con un viewport personalizzato, scroll_page per i contenuti caricati in ritardo e block_consent_modals per nascondere i banner dei cookie. browserless_pdf stampa in PDF un URL o HTML che passi tu (ad esempio un report generato), con opzioni come format, landscape, margini e printBackground.

Mappatura e qualità del sito: browserless_map elenca gli URL di un sito dalla sitemap e dai link, con titoli e descrizioni, ordinati per pertinenza rispetto a search (limit 200 di default, fino a 5000). browserless_performance esegue un audit Google Lighthouse con punteggi da 0 a 1 per prestazioni, accessibilità, best practice, SEO e PWA. Un audit completo può durare minuti ed è molto grande, quindi l'AI passa config per analizzare una sola categoria.

Pagine bloccate: browserless_unblock supera i sistemi di rilevamento dei bot (Datadome, CAPTCHA passivi) e restituisce l'HTML, i cookie impostati dal sito e, se richiesto, uno screenshot dell'intera pagina; funziona meglio con proxy: residential e l'AI chiede prima conferma. Con gli altri strumenti l'AI prova prima stealth: true, poi un proxy (proxy_country sceglie il paese).

Attendere i contenuti: gli strumenti di rendering accettano wait_for_selector (un elemento e un timeout), wait_for_timeout, goto_options (ad esempio waitUntil: networkidle2) e best_attempt, che prosegue con ciò che si è caricato quando un'attesa va in timeout. In browserless_get_content e browserless_scrape, reject_resource_types (immagini, font, media) velocizza le pagine; browserless_get_content invia anche set_extra_http_headers e cookies con la richiesta. Tutti i tempi sono in millisecondi; timeout limita l'intera chiamata.

Disattivati all'installazione: browserless_function, che esegue il tuo codice Puppeteer per flussi in più passaggi, come compilare un modulo o scorrere i risultati pagina per pagina. Quel codice può inviare moduli, accedere o acquistare su siti web, e queste azioni non si possono annullare, quindi un amministratore del workspace lo attiva quando serve al team. Una volta attivo, l'AI ti mostra il codice e aspetta il tuo sì.

Cosa modifica: niente nel tuo account Browserless. Ogni chiamata avvia un nuovo Chrome headless, svolge un compito su un URL e chiude il browser, quindi nulla resta tra una chiamata e l'altra.

Formati dei dati: gli screenshot tornano come immagini e i PDF come file; le risposte testuali sono limitate a circa 100 KB. Opzioni come wait_for_selector, goto_options, viewport e json_options sono oggetti JSON. I punteggi Lighthouse sono frazioni (0,92 = 92).

Contenuti non affidabili: pagine, cookie e testi estratti provengono da siti di terzi. L'AI tratta le istruzioni al loro interno come dati, mai come ordini.

Errori comuni: 401 indica un token errato o che non appartiene a questo host (fleet condivisa o privata); copialo di nuovo dalla dashboard. 404 nel controllo di installazione indica che BROWSERLESS_HOST non espone le API REST. 400 è un corpo malformato, ad esempio senza né url né html. 403 indica che la destinazione non è consentita per questo account. 408 indica che la pagina ha superato il timeout: aumenta timeout, attendi meno o usa best_attempt. 429 indica che la concorrenza del piano è esaurita; attendi e riprova una volta. Un contenuto vuoto o parziale di solito significa che il sito blocca l'automazione: prova stealth: true, poi browserless_unblock con un proxy residenziale.

Il connettore non copre BrowserQL, le sessioni WebSocket per Puppeteer o Playwright, le API asincrone di crawl e agent, i download di file né la gestione delle sessioni.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Browserless.

Tool disponibili

Esempi di prompt

• "Leggi https://example.com/pricing con lo smart scrape e dammi piani e prezzi in una tabella."
• "Fai uno screenshot dell'intera home page a 1280 px di larghezza e nascondi il banner dei cookie."
• "Esegui un audit Lighthouse delle prestazioni di https://example.com ed elenca i tre problemi principali."
• "Mappa gli URL di https://example.com legati alla documentazione ed elenca i primi 50."
• "Trasforma questo report HTML in un PDF A4 con i colori di sfondo e margini di 1 cm."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot