> ## 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 + Snowflake

> Cerca, esegui scraping, mappa e analizza il web in tempo reale da Snowflake SQL e salva le pagine come tabelle con l’app nativa di Olostep.

L’[app nativa di Olostep sul Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling) porta i dati web in tempo reale su Snowflake. [Olostep](https://www.olostep.com) è un'infrastruttura di dati web per agenti AI e flussi di lavoro AI aziendali. Le sue API forniscono ricerca web in tempo reale, scraping e crawling per estrarre, pulire e strutturare i dati dal web.

Chiama Olostep da SQL per cercare nel web, eseguire scraping delle pagine in markdown pulito, mappare e analizzare siti web, e ottenere risposte con fonti. Gli scraping e i crawling batch vengono salvati come tabelle nel tuo account, così puoi unire i dati web con i tuoi dati, caricarli in Cortex Search o usarli in Cortex Agents.

[Visualizza sul Snowflake Marketplace →](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling)

## Prima di iniziare

* **Un account Olostep con una chiave API:** [ottienine una gratuita](https://www.olostep.com/dashboard), non è richiesta la carta di credito. I tuoi primi 500 crediti sono inclusi.
* **Un account Snowflake con accesso esterno:** l'app chiama l'API di Olostep tramite un'integrazione di accesso esterno, che gli account di prova non supportano.
* **Un ruolo che può approvare le connessioni dell'app:** approvare la connessione a `api.olostep.com` richiede il privilegio `MANAGE APPLICATION SPECIFICATIONS`, che `ACCOUNTADMIN` e `SECURITYADMIN` hanno.

## Configurazione

**1. Ottieni l'app**

Apri l’[elenco](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling) e fai clic su **Ottieni**. Gli esempi in questa pagina assumono che tu la installi come `olostep`.

**2. Approva la connessione all’API di Olostep**

L'app crea la propria integrazione di accesso esterno per `api.olostep.com` e non può chiamare l'API finché non la approvi. In Snowsight, vai su **Catalogo** > **App** e seleziona l'app. Seleziona l'icona **Impostazioni**, quindi apri la scheda **Configurazioni**. Sotto **Connessioni esterne**, espandi **Dettagli** accanto a **Integrazioni di accesso esterno** e approva l'endpoint `api.olostep.com`.

**3. Aggiungi la tua chiave API**

Nella stessa scheda **Configurazioni**, sotto **Credenziali**, aggiungi un segreto `GENERIC_STRING` che contiene la tua chiave API dal [dashboard di Olostep](https://www.olostep.com/dashboard/api-keys) a **Chiave API di Olostep**.

> [accordion] Preferisci SQL? Fai i passaggi 2 e 3 in un foglio di lavoro
>
> ```sql theme={null}
> -- Approva la connessione, utilizzando il numero di sequenza che SHOW SPECIFICATIONS restituisce
> SHOW SPECIFICATIONS IN APPLICATION olostep;
> ALTER APPLICATION olostep APPROVE SPECIFICATION olostep_api_access SEQUENCE_NUMBER = 1;
>
> -- Memorizza la tua chiave in un segreto e consegnala all'app
> CREATE DATABASE IF NOT EXISTS olostep_config;
>
> CREATE OR REPLACE SECRET olostep_config.public.olostep_api_key
>   TYPE = GENERIC_STRING
>   SECRET_STRING = '<YOUR_OLOSTEP_API_KEY>';
>
> CALL olostep.core.register_reference('OLOSTEP_API_KEY', 'ADD',
>   SYSTEM$REFERENCE('SECRET', 'olostep_config.public.olostep_api_key', 'PERSISTENT', 'READ'));
> ```

## Procedure

| Procedura | Cosa fa |
| - | - |
| `core.scrape(url)` | Esegui scraping di una pagina e restituisci markdown pulito (incluso il rendering JavaScript) |
| `core.search(query, max_results)` | Cerca nel web in tempo reale e restituisci titoli, URL e descrizioni |
| `core.answer(task)` | Rispondi a una domanda dal web in tempo reale, con URL delle fonti |
| `core.map(url, top_n)` | Elenca gli URL su un sito web |
| `core.batch_scrape(urls, table_name)` | Esegui scraping di un elenco di URL in un batch e salva le pagine in una tabella |
| `core.crawl(url, table_name, max_pages)` | Analizza un sito web e salva le pagine in una tabella |
| `core.save_results(id, table_name)` | Salva le pagine di un batch o crawl che era ancora in esecuzione quando la chiamata è stata restituita |

Ogni procedura restituisce un `VARIANT`. In caso di errore, restituisce un oggetto con `status` impostato su `error`. I limiti di velocità, gli errori del server e i timeout vengono ritentati automaticamente.

## Utilizzo

```sql theme={null}
-- Esegui scraping di una pagina in markdown
CALL olostep.core.scrape('https://docs.olostep.com');

-- Cerca nel web
CALL olostep.core.search('ultimi framework per agenti AI', 5);

-- Rispondi a una domanda con fonti
CALL olostep.core.answer('Qual è l’ultima versione stabile di Next.js?');

-- Elenca gli URL su un sito web
CALL olostep.core.map('https://docs.olostep.com', 50);
```

## Salva le pagine come tabelle

`batch_scrape` e `crawl` salvano una riga per pagina in `olostep.results.<table_name>`, con le colonne `URL`, `MARKDOWN`, `ERROR` e `RETRIEVED_AT`. Usare un nome di tabella esistente sostituisce quella tabella.

```sql theme={null}
-- Esegui scraping di ogni URL in una delle tue tabelle
CALL olostep.core.batch_scrape(
  (SELECT ARRAY_AGG(website) FROM my_db.crm.accounts),
  'account_pages');

-- Analizza un sito web (fino a 25 pagine)
CALL olostep.core.crawl('https://docs.olostep.com', 'olostep_docs', 25);

-- Interroga i risultati o copiali nel tuo database
SELECT url, markdown FROM olostep.results.account_pages;
CREATE TABLE my_db.crm.account_pages AS SELECT * FROM olostep.results.account_pages;
```

I batch e i crawl di solito finiscono in pochi minuti. Se uno è ancora in esecuzione dopo 20 minuti, la procedura restituisce il suo `id` con `status` impostato su `in_progress`. Salva le sue pagine successivamente con:

```sql theme={null}
CALL olostep.core.save_results('<id>', 'account_pages');
```

Le tabelle in `results` vengono rimosse se disinstalli l'app, quindi copia tutto ciò che vuoi conservare nel tuo database.

## Risoluzione dei problemi

* **"Impossibile raggiungere api.olostep.com":** la connessione non è ancora approvata. Approvala come nel passaggio 2.
* **"Funzione definita dall'utente sconosciuta INTERNAL.OLOSTEP\_REQUEST":** la chiave API non è ancora aggiunta. Aggiungila come nel passaggio 3.
* **HTTP 401 nell'errore:** il segreto non contiene una chiave API di Olostep valida. Controllala nel [dashboard di Olostep](https://www.olostep.com/dashboard/api-keys).

## Risorse

* [Olostep sul Snowflake Marketplace](https://app.snowflake.com/marketplace/listing/GZT8Z4URI87/olostep-olostep-web-search-scraping-and-crawling)
* [Repository GitHub](https://github.com/olostep-api/olostep-snowflake)
* [Documentazione delle app native di Snowflake](https://docs.snowflake.com/en/developer-guide/native-apps/native-apps-about)
* [Sito web di Olostep](https://www.olostep.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.