> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Olostep + Relay
> Aggiungi web scraping, ricerca potenziata dall’AI, lavori batch, crawl e mappe del sito a qualsiasi workflow Relay, senza bisogno di codice.
L'app verificata [Olostep su Relay](https://www.relay.app/apps/olostep/integrations) ti offre due azioni all'interno del costruttore visivo di Relay: eseguire lo scraping di un URL o mappare tutti i link su un sito.
[Visualizza su Relay →](https://www.relay.app/apps/olostep/integrations)
## Prima di iniziare
* **Un account Olostep con una chiave API:** [ottienine uno gratuitamente](https://olostep.com/dashboard), non è richiesta la carta di credito. I tuoi primi 500 crediti sono inclusi.
* **Un account Relay:** creane uno su [relay.app](https://www.relay.app/).
* **Non è richiesto codice:** tutto in questa guida viene fatto tramite l'editor visivo di Relay.
***
## Configurazione
Apri un workflow in Relay, aggiungi un passaggio e cerca **Olostep**. Seleziona **Olostep** dall'elenco delle app.
Dopo aver selezionato **Olostep**, scegli una delle azioni Olostep disponibili nella configurazione del passaggio.
Clicca su **Connetti account**, incolla la tua chiave API Olostep e autorizza la connessione. Relay salverà questo account per i futuri workflow.
Ottieni la tua chiave dal [dashboard di Olostep →](https://olostep.com/dashboard)
* **URL da scrappare:** mappa da un passaggio precedente o inserisci manualmente
* **Formato di output:** scegli `Markdown`, `HTML`, `JSON` o `Text`
Esegui un test per verificare l'output, quindi pubblica o attiva il workflow una volta che i risultati sembrano corretti.
***
## Azioni
Estrai contenuti da qualsiasi URL come Markdown, HTML, JSON o testo semplice. Gestisce pagine renderizzate in JS con tempi di attesa opzionali e targeting per paese.
Ottieni ogni URL su un sito senza eseguire lo scraping dei contenuti. Usalo per la scoperta prima di un lavoro batch. Restituisce un `map_id`.
**La mappa è asincrona.** Memorizza il `map_id` restituito e utilizza un pattern di delay/poll in Relay per recuperare i risultati una volta completato il processo.
***
## Esempio di workflow: Scraping programmato della pagina di un concorrente
**Cosa fa:** Su un programma, questo workflow esegue lo scraping di una pagina di un concorrente e memorizza contenuti puliti che puoi riutilizzare nei passaggi successivi di Relay.
**Nodi utilizzati:** Schedule -> Olostep Scrape Website
***
### Passaggio 1: Aggiungi un trigger di schedule
Crea un workflow e aggiungi un trigger di schedule (ad esempio, ogni giorno feriale alle 8:00).
### Passaggio 2: Aggiungi Olostep Scrape Website
Aggiungi un passaggio **Olostep** e seleziona **Scrape Website**. Imposta:
* **URL:** `https://competitor.com/blog`
* **Formato di output:** Markdown
### Passaggio 3: Testa e pubblica
Esegui un test per confermare l'output, quindi pubblica o attiva il workflow.
### Cosa ottieni
Ogni esecuzione produce contenuti di pagina puliti pronti per l'analisi o l'instradamento:
> **Risultato dello scraping**
>
> * URL di origine
> * Contenuto recuperato nel formato selezionato
> * Output dell'esecuzione con timestamp in Relay
***
## Parser
Aggiungi un ID parser al campo **Parser** sull'azione Scrape per ottenere dati strutturati invece di contenuti grezzi:
| Parser | Estrae |
| ---------------------------- | ----------------------------------------------------------- |
| `@olostep/amazon-product` | Titolo, prezzo, valutazione, recensioni, immagini, varianti |
| `@olostep/google-search` | Titoli dei risultati, URL, snippet |
| `@olostep/google-maps` | Nome dell'attività, 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 a Google Calendar e ICS |
Vedi l'elenco completo nel [negozio parser di Olostep →](https://www.olostep.com/store)
***
## Relay.app vs Zapier
Relay.app è una valida alternativa a Zapier per i workflow che necessitano di revisione integrata e orchestrazione AI-first.
**Vantaggi di Relay.app:**
* **Human-in-the-loop:** passaggi di approvazione e revisione nativi nel workflow
* **Design del workflow AI-first:** più facile aggiungere decisioni AI e riepiloghi come passaggi di prima classe
* **Chiarezza del workflow:** costruttore visivo pulito con contesto di esecuzione chiaro e output dei passaggi
**Quando Zapier potrebbe essere migliore:**
* Hai bisogno di copertura per un'app di nicchia disponibile solo su Zapier
* Il tuo team ha già molti Zaps esistenti e strumenti operativi attorno a Zapier
Se entrambe le piattaforme supportano il tuo stack, scegli Relay quando revisione + collaborazione AI sono centrali nel tuo processo.
***
## Risoluzione dei problemi
Copia la chiave direttamente da [olostep.com/dashboard](https://olostep.com/dashboard) senza spazi finali. Riconnetti l'account Olostep in Relay se l'errore persiste.
Aumenta **Attesa prima dello scraping** (prova 2000–5000ms per pagine pesanti in JS). Conferma che l'URL sia accessibile pubblicamente senza login. Se un dominio fallisce costantemente, contatta [info@olostep.com](mailto:info@olostep.com).
Aggiungi ritardi tra esecuzioni pesanti di scraping e riprova con backoff per workflow di grandi dimensioni. Controlla l'uso corrente nel [dashboard](https://olostep.com/dashboard).
Le mappe sono asincrone. Memorizza prima il `map_id` restituito, quindi recupera i risultati in un passaggio/esecuzione successivo una volta completato il processo.
***
## Correlati
Riferimento completo per l'endpoint di scraping
Come funzionano i lavori batch e come recuperare i risultati
Configurazione del crawl e recupero dei risultati
Scoperta degli URL e opzioni di filtraggio