Olostep + n8n - Olostep Docs

Il nodo della comunità Olostep ti offre sei operazioni all’interno del builder visivo di n8n: eseguire lo scraping di un URL, cercare sul web, ottenere risposte AI, eseguire lo scraping di migliaia di URL in batch, eseguire il crawl di un sito o mappare tutti i suoi link. Visualizza su npm →

Prima di iniziare

Un account Olostep con una chiave API: ottienine una gratuita, non è richiesta la carta di credito. I tuoi primi 500 crediti sono inclusi.
n8n in esecuzione: sia n8n Cloud che un’istanza self-hosted. I nodi della comunità devono essere abilitati (lo sono per impostazione predefinita nella maggior parte delle configurazioni).
Non è richiesto codice: tutto in questa guida viene fatto tramite l’editor visivo di n8n.

Configurazione

Installa il nodo

In n8n, vai su Impostazioni → Nodi della Comunità e fai clic su Installa. Inserisci il nome del pacchetto n8n-nodes-olostep, spunta la casella che accetta il rischio dei nodi della comunità e fai clic su Installa.

Se Nodi della Comunità è disabilitato per il tuo workspace, un amministratore deve abilitarlo prima. Consulta la guida ai nodi della comunità di n8n.

Aggiungi il nodo a un workflow

Apri qualsiasi workflow, fai clic su + e cerca Olostep. Seleziona Olostep Web Scraper dai risultati.

Aggiungi la tua chiave API

Apri il nodo Olostep nel tuo workflow, fai clic su Configura Credenziali (nella scheda Parametri), aggiungi la tua chiave API e fai clic su Salva.

Modulo credenziali Olostep in n8n con campo Chiave API

Ottieni la tua chiave dalla dashboard di Olostep →

Collega e avvia

Collega il nodo Olostep a un trigger e a qualsiasi passaggio a valle, quindi esegui il tuo workflow.

Canvas del workflow n8n con Trigger di Pianificazione collegato al nodo Olostep

Azioni

Scrape Sito Web

Estrai contenuto da qualsiasi URL come Markdown, HTML, JSON o testo semplice. Gestisce pagine renderizzate in JS con tempi di attesa opzionali e targeting per paese.

Cerca

Esegui una ricerca web e ottieni risultati strutturati (titoli, URL e frammenti) come JSON.

Risposte (AI)

Fai una domanda in linguaggio naturale e ottieni una risposta con fonti citate. Utile prima dei nodi LLM quando hai bisogno di risposte fondate.

Scrape URL in Batch

Invia fino a 100.000 URL in un unico lavoro, elaborati in parallelo. Restituisce un batch_id; recupera i risultati in modo asincrono.

Crea Crawl

Parti da un URL, segui i link ed esegui lo scraping di tutte le sottopagine. Ottimo per siti di documentazione, blog o ingestione completa del sito. Restituisce un crawl_id.

Crea Mappa

Ottieni ogni URL su un sito senza eseguire lo scraping del contenuto. Usalo per la scoperta prima di un lavoro in batch. Restituisce un map_id.

Batch, Crawl e Map sono asincroni. Memorizza l’ID restituito e utilizza un nodo Wait o un secondo workflow per recuperare i risultati una volta completata l’elaborazione.

Esempio di workflow: Arricchimento lead da Google Sheets

Cosa fa: Quando incolli un URL aziendale in un Google Sheet, questo workflow esegue automaticamente lo scraping del sito web dell’azienda, estrae informazioni chiave con un nodo AI e scrive i risultati nella stessa riga, trasformando un foglio di calcolo vuoto in un database di lead completo. Nodi utilizzati: Trigger Google Sheets → Olostep Scrape Website → OpenAI → Codice → Aggiornamento Google Sheets

Workflow di arricchimento lead in n8n: Trigger Google Sheets collegato a nodi Olostep, OpenAI, Codice e aggiornamento Google Sheets

Passo 1: Configura il tuo Google Sheet

Crea un foglio con queste colonne: Company URL, Industry, Description, Company Size, Enriched. Il workflow legge da Company URL e compila il resto.

Passo 2: Aggiungi un trigger Google Sheets

In n8n, aggiungi un nodo trigger Google Sheets. Imposta l’evento su Row Added, puntalo al tuo foglio e impostalo per monitorare la colonna Company URL. Ora ogni volta che incolli un nuovo URL nel foglio, questo workflow si attiva.

Passo 3: Aggiungi Olostep Scrape Website

Collega un nodo Olostep Web Scraper dopo il trigger. Imposta:

Azione: Scrape Website
URL: {{ $json["Company URL"] }} (estrae l’URL dalla nuova riga)
Formato di Output: Markdown

Markdown funziona meglio qui perché elimina navigazione, annunci e boilerplate. Il nodo AI nel passaggio successivo ottiene prosa pulita sull’azienda invece di rumore HTML grezzo.

Passo 4: Aggiungi un nodo OpenAI

Collega un nodo OpenAI. Imposta il modello su gpt-4o-mini (veloce ed economico per compiti di estrazione) e usa questo prompt:

Sei un ricercatore di vendite. Basandoti sul contenuto del sito web dell'azienda qui sotto, estrai:
1. Settore (una frase, es. "B2B SaaS", "E-commerce", "Healthcare")
2. Descrizione dell'azienda in una frase (max 20 parole)
3. Dimensione stimata dell'azienda (Startup / SMB / Mid-market / Enterprise)

Ritorna solo un oggetto JSON con chiavi: industry, description, company_size.

Contenuto del sito web:
{{ $json.markdownContent }}

Il campo markdownContent è ciò che Olostep restituisce dallo scraping, come testo semplice pulito.

Passo 5: Analizza la risposta AI e scrivi indietro

Aggiungi un nodo Codice per analizzare il JSON da OpenAI:

const parsed = JSON.parse($input.first().json.message.content);
return [{ json: parsed }];

Quindi collega un nodo Google Sheets impostato su Update Row. Mappa le colonne:

Industry → {{ $json.industry }}
Description → {{ $json.description }}
Company Size → {{ $json.company_size }}
Enriched → Yes

Cosa ottieni

Incolla un URL come https://notion.so nel tuo foglio e in circa 10 secondi la riga si riempie:

Company URL	Industry	Description	Company Size	Enriched
https://notion.so	Productivity SaaS	All-in-one workspace for notes, docs, and databases	Mid-market	Yes

Da qui puoi estendere questo workflow: aggiungi una notifica Slack quando l’arricchimento è completato, filtra per settore prima di scrivere indietro, o sostituisci Google Sheets con HubSpot per aggiornare i contatti direttamente.

Modelli

Workflow n8n pronti da importare costruiti con Olostep:

Crawl docs → base di conoscenza AI

Esegui il crawl di siti di documentazione con Olostep e struttura l’output in una base di conoscenza pronta per l’AI.

Lead da Google Maps → arricchimento decisore

Esegui lo scraping di lead aziendali da Google Maps e arricchiscili con dettagli sui decisori.

Analisi reclami utenti → rapporto di insight

Analizza i reclami con Olostep + Gemini e genera rapporti di insight strutturati in Google Docs.

Estrazione prodotti Amazon → Google Sheets

Estrai URL e metadati dei prodotti Amazon con Olostep, quindi sincronizza i risultati su Sheets.

Esplora tutti i workflow Olostep su n8n.io →

Parser

Aggiungi un ID parser al campo Parser su qualsiasi azione Scrape o Batch per ottenere dati strutturati invece di contenuto grezzo:

Parser	Estrae
`@olostep/amazon-product`	Titolo, prezzo, valutazione, recensioni, immagini, varianti
`@olostep/google-search`	Titoli dei risultati, URL, frammenti
`@olostep/google-maps`	Nome azienda, indirizzo, valutazione, recensioni
`@olostep/extract-emails`	Indirizzi email da qualsiasi pagina
`@olostep/extract-socials`	Link ai profili social (X, GitHub, LinkedIn, ecc.)
`@olostep/extract-calendars`	Link Google Calendar e ICS

Consulta l’elenco completo nel negozio di parser Olostep →

Risoluzione dei problemi

Chiave API rifiutata

Copia la chiave direttamente da olostep.com/dashboard senza spazi finali. Elimina e ricrea la credenziale in n8n se l’errore persiste.

Contenuto dello scraping vuoto

Aumenta Attendi Prima di Scraping (prova 2000–5000ms per pagine pesanti in JS). Conferma che l’URL sia pubblicamente accessibile senza login. Se un dominio specifico fallisce costantemente, contatta info@olostep.com.

Errore di formato URL batch

Il campo URL da Scrape si aspetta un array JSON:

[
  { "url": "https://example.com/page-1", "custom_id": "p1" },
  { "url": "https://example.com/page-2", "custom_id": "p2" }
]

Usa un nodo Codice a monte per costruire questo array dai tuoi dati se necessario.

Limite di velocità raggiunto

Aggiungi un nodo Wait tra i passaggi di scraping, o passa a Batch Scrape URLs invece di eseguire scraping singoli in loop. Controlla l’uso corrente nella dashboard.

Nodi della Comunità non visibili nelle Impostazioni

Su n8n Cloud, i nodi della comunità devono essere abilitati da un proprietario del workspace. Su self-hosted, assicurati che N8N_COMMUNITY_PACKAGES_ENABLED=true sia impostato nel tuo ambiente. Consulta la guida all’installazione di n8n.

Correlati

Scrapes API

Riferimento completo per l’endpoint di scraping

Batches API

Come funzionano i lavori batch e come recuperare i risultati

Crawls API

Configurazione del crawl e recupero dei risultati

Maps API

Scoperta degli URL e opzioni di filtraggio

Inizia

Pronto ad automatizzare i tuoi workflow di ricerca web, scraping e crawling?

Sito Web n8n

Piattaforma n8n

Installa il Nodo

Installa n8n-nodes-olostep e inizia a costruire workflow automatizzati

Connetti Olostep con n8n e automatizza oggi stesso l’estrazione dei dati web!

​Prima di iniziare

​Configurazione

​Azioni

Scrape Sito Web

Cerca

Risposte (AI)

Scrape URL in Batch

Crea Crawl

Crea Mappa

​Esempio di workflow: Arricchimento lead da Google Sheets

​Passo 1: Configura il tuo Google Sheet

​Passo 2: Aggiungi un trigger Google Sheets

​Passo 3: Aggiungi Olostep Scrape Website

​Passo 4: Aggiungi un nodo OpenAI

​Passo 5: Analizza la risposta AI e scrivi indietro

​Cosa ottieni

​Modelli

Crawl docs → base di conoscenza AI

Lead da Google Maps → arricchimento decisore

Analisi reclami utenti → rapporto di insight

Estrazione prodotti Amazon → Google Sheets

​Parser

​Risoluzione dei problemi

​Correlati

Scrapes API

Batches API

Crawls API

Maps API

​Inizia

Sito Web n8n

Installa il Nodo

Prima di iniziare

Configurazione

Azioni

Esempio di workflow: Arricchimento lead da Google Sheets

Passo 1: Configura il tuo Google Sheet

Passo 2: Aggiungi un trigger Google Sheets

Passo 3: Aggiungi Olostep Scrape Website

Passo 4: Aggiungi un nodo OpenAI

Passo 5: Analizza la risposta AI e scrivi indietro

Cosa ottieni

Modelli

Parser

Risoluzione dei problemi

Correlati

Inizia