ScrapingBee MCP Server: pagine, ricerca e screenshot

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

ScrapingBee

Web scraping con ScrapingBee dalla tua AI: scarica qualsiasi pagina come HTML renderizzato, markdown o testo tramite proxy a rotazione, premium o stealth, estrai dati strutturati con regole CSS, XPath o AI, cattura screenshot, ottieni risultati Google e Amazon già interpretati e controlla i crediti rimasti nel piano. Tutti gli strumenti tranne la verifica dei consumi spendono crediti ScrapingBee.

Setup

La configurazione richiede circa 2 minuti. Ti serve un account ScrapingBee; la prova gratuita include 1.000 crediti.

1. Accedi a https://dashboard.scrapingbee.com.
2. Copia l'API key dalla dashboard (https://dashboard.scrapingbee.com/account/manage/api_key).
3. Incollala in SCRAPINGBEE_API_KEY. Viene inviata come token Bearer, solo a app.scrapingbee.com.
4. Installa il connettore ed esegui scrapingbee_get_usage: mostra i crediti usati e inclusi e conferma la chiave.

Cosa costa crediti: tutti gli strumenti tranne scrapingbee_get_usage spendono crediti API del tuo piano, e solo per le chiamate riuscite (contano anche le risposte 404 e 410). Le richieste di pagina con scrapingbee_scrape_page e scrapingbee_extract_data costano 1 credito senza JavaScript, 5 con JavaScript (il default), 10 o 25 con premium_proxy (senza o con JavaScript) e 75 con stealth_proxy; l'estrazione AI ne aggiunge 5. scrapingbee_take_screenshot esegue sempre JavaScript, quindi costa 5 crediti, 25 con proxy premium e 75 con proxy stealth. scrapingbee_google_search costa 10 crediti (15 con light_request: false), scrapingbee_fast_search 10. scrapingbee_amazon_search e scrapingbee_amazon_product costano 5 per pagina leggera e 15 per pagina renderizzata, e pages moltiplica il costo. L'AI ti chiede conferma prima di una serie di chiamate a pagamento.

Leggere pagine: scrapingbee_scrape_page restituisce HTML oppure il contenuto principale in markdown (return_page_markdown) o testo semplice (return_page_text). Per le pagine statiche l'AI imposta render_js: false (1 credito invece di 5). Per una pagina bloccata usa mode: auto, che prova prima la configurazione più economica e addebita solo quella riuscita (max_cost pone un tetto, ad esempio 25 per non arrivare mai al proxy stealth), oppure riprova con premium_proxy e poi stealth_proxy. Altre opzioni: country_code per il paese del proxy, wait (fino a 35.000 ms), wait_for su un selettore CSS, wait_browser, block_ads, block_resources (attivo di default), device, cookies, session_id (lo stesso IP per 5 minuti), timeout e js_scenario, che clicca, scorre e compila moduli prima di catturare la pagina. json_response racchiude la risposta con header, cookie, costo e URL risolto.

Estrarre dati: scrapingbee_extract_data restituisce JSON invece della pagina. Se la struttura è nota l'AI scrive extract_rules (selettori CSS o XPath come testo JSON, con output come text, html, @href, table_json o table_array). Se non è nota usa ai_query (una domanda sulla pagina) o ai_extract_rules (i campi descritti a parole), eventualmente limitati a una parte della pagina con ai_selector.

Screenshot: scrapingbee_take_screenshot restituisce un PNG dell'area visibile (1920 x 1080 di default), dell'intera pagina (screenshot_full_page) o di un elemento (screenshot_selector), su desktop o mobile.

Ricerca: scrapingbee_fast_search fornisce subito un elenco di risultati organici di Google (posizione, titolo, link, descrizione) e notizie principali. scrapingbee_google_search restituisce la pagina dei risultati interpretata con risultati organici, annunci, knowledge graph, risultati locali e su mappa, notizie principali e domande correlate; search_type sceglie news, maps, images, shopping, lens, ai_mode o ads. Le panoramiche AI richiedono light_request: false. Filtri: country_code, language, device, date_range e, per lo shopping, sort_by, min_price e max_price.

Amazon: scrapingbee_amazon_search restituisce i prodotti di una ricerca (ASIN, titolo, prezzo, valuta, valutazione, indicatore sponsorizzato, posizione) su un marketplace a scelta (domain, ad esempio com, it o de), con ordinamento e filtri per categoria e venditore. scrapingbee_amazon_product legge un prodotto tramite ASIN: prezzo, buy box, valutazione e numero di recensioni, marca, punti elenco, immagini, varianti, dettagli, consegna, disponibilità e posizione nelle vendite. zip_code dà prezzi e consegna locali; currency imposta la valuta mostrata.

Cosa modifica: niente nel tuo account ScrapingBee; tutti gli strumenti leggono. Nessuno strumento è disattivato all'installazione, ma ogni chiamata tranne la verifica dei consumi costa crediti.

Formati dei dati: le opzioni JSON extract_rules, ai_extract_rules e js_scenario si passano come testo JSON. country_code è un codice ISO 3166-1 in minuscolo; senza proxy premium o stealth un paese non supportato ricade su us senza avviso. Su Amazon non inviare come country il paese del marketplace; usa zip_code. I prezzi sono nella valuta del marketplace, salvo che currency sia impostato.

Paginazione e limiti: scrapingbee_google_search accetta page e pages (da 1 a 10 pagine di risultati unite, consigliate 3 o meno), scrapingbee_amazon_search accetta start_page e pages, ogni pagina addebitata, e scrapingbee_fast_search accetta page. Le risposte sono limitate a circa 100 KB, quindi per le pagine lunghe l'AI usa markdown, testo o regole di estrazione. scrapingbee_get_usage consente 6 chiamate al minuto e le richieste parallele sono limitate dalla concorrenza del piano.

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

Errori comuni: 401 Invalid api key o crediti esauriti: copia di nuovo la chiave o controlla il piano nella dashboard. 400 indica una combinazione di parametri non valida, come mode: auto insieme a render_js, premium_proxy o stealth_proxy, oppure un country uguale al paese del dominio Amazon; non viene addebitato. 429 indica che è stato raggiunto il limite di concorrenza del piano; attendi e riprova una volta, non viene addebitato. 500 indica che la pagina non è stata scaricata (errore del sito, blocco o timeout); non viene addebitato e spesso aiuta riprovare con premium_proxy o stealth_proxy.

Il connettore non usa la modalità proxy, non inoltra richieste POST o PUT al sito di destinazione, non scarica file oltre 2 MB e non copre gli endpoint Walmart, YouTube, ChatGPT e Gemini né la CLI.

Prerequisiti: SCRAPINGBEE_API_KEY

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli ScrapingBee e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quanti crediti ScrapingBee ci restano in questo periodo e quando si rinnova il piano?"
• "Scarica https://example.com/blog/launch in markdown senza JavaScript e riassumi l'articolo."
• "Estrai nome del prodotto, prezzo e disponibilità da questa pagina del negozio con regole di estrazione AI."
• "Fai uno screenshot mobile dell'intera pagina https://example.com e dimmi cosa si vede senza scorrere."
• "Cerca su Amazon.it un caricatore USB-C da 65 W, ordinato per valutazione, ed elenca i primi 10 con ASIN e prezzo."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT