> ## 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.

# Integrazione Olostep + Raycast

> Aggiungi scraping web, ricerca, crawling e risposte AI a Raycast AI con il server ufficiale Olostep MCP

Raycast è il launcher di produttività utilizzato da sviluppatori, operatori e utenti esperti di AI. Con il supporto nativo di Raycast per il Model Context Protocol (MCP), il **server ufficiale Olostep MCP** si integra direttamente in Raycast AI — fornendo al tuo launcher strumenti di dati web live che puoi richiamare da AI Chat, Quick AI e AI Commands con una semplice menzione `@olostep`.

Olostep è una [voce ufficiale nel registro MCP di Raycast](https://www.raycast.com/), quindi puoi aggiungerlo in un paio di clic — nessun file di configurazione da modificare.

## Caratteristiche

Il Server Olostep MCP fornisce al tuo Raycast AI l'accesso alle capacità principali di dati web di Olostep:

<CardGroup cols={2}>
  <Card title="Scrape Website" icon="file-lines">
    Estrai contenuti da qualsiasi URL singolo come Markdown, HTML, JSON o testo — con rendering JavaScript e targeting per paese.
  </Card>

  <Card title="Search Web" icon="magnifying-glass">
    Esegui una ricerca web e ottieni risultati strutturati basati su parser (titoli, URL, frammenti).
  </Card>

  <Card title="Answers (AI)" icon="sparkles">
    Fai una domanda in linguaggio naturale e ottieni una risposta basata sul web con fonti citate e output strutturato opzionale.
  </Card>

  <Card title="Batch Scrape URLs" icon="layer-group">
    Elabora fino a 10.000 URL in un singolo lavoro parallelo — ideale per estrazioni su larga scala.
  </Card>

  <Card title="Crawl Websites" icon="spider-web">
    Parti da un URL, segui i link e fai scraping di interi siti o sezioni automaticamente.
  </Card>

  <Card title="Map Site URLs" icon="map">
    Scopri ogni URL su un sito senza fare scraping — perfetto per pianificare un crawl o un lavoro batch.
  </Card>
</CardGroup>

## Prima di iniziare

* **Una chiave API Olostep:** [ottienine una gratuita](https://olostep.com/dashboard/api-keys), non è richiesta la carta di credito. I tuoi primi 500 crediti sono inclusi.
* **Raycast installato**, con [Raycast AI](https://manual.raycast.com/ai) disponibile nel tuo piano. Gli strumenti MCP funzionano tramite Raycast AI (AI Chat, Quick AI e AI Commands).

<Note>
  Olostep supporta due modalità di connessione. L'**endpoint ospitato** (`https://mcp.olostep.com/mcp`) utilizza un'intestazione `Authorization: Bearer YOUR_API_KEY`. L'opzione **local stdio** (`npx -y olostep-mcp`) utilizza `OLOSTEP_API_KEY` come variabile d'ambiente. Scegli una — mescolare le due modalità di autenticazione è l'errore di configurazione più comune.
</Note>

## Installazione

<Steps>
  <Step title="Ottieni la tua chiave API">
    Copia la tua chiave dalla [dashboard Olostep](https://olostep.com/dashboard/api-keys). La incollerai in Raycast nel passaggio successivo.
  </Step>

  <Step title="Installa Olostep in Raycast (consigliato)">
    Poiché Olostep è una voce ufficiale nel registro MCP di Raycast, il percorso più veloce è con un clic:

    1. Installa l'estensione **Model Context Protocol Registry** dal Raycast Store (cerca "MCP" o "Model Context Protocol").
    2. Esegui il comando **Search Servers**, cerca **Olostep** e selezionalo.
    3. Scegli **Install**, quindi inserisci la tua chiave API Olostep quando richiesto.

    Raycast salva la configurazione, avvia la connessione e carica gli strumenti automaticamente.
  </Step>

  <Step title="Oppure aggiungilo manualmente">
    Preferisci configurarlo da solo? Apri Raycast, esegui **Install MCP Server** (o **Manage MCP Servers → Install New Server**) e compila il modulo con questi valori:

    * **Nome:** `olostep`
    * **Trasporto:** HTTP
    * **URL:** `https://mcp.olostep.com/mcp`
    * **Intestazione HTTP:** `Authorization` → `Bearer YOUR_API_KEY`

    Premi **Install MCP Server** (`⌘` / `Ctrl` + `↵`).

    <Accordion title="Preferisci un'installazione locale? (stdio)">
      Scegli **Standard Input/Output** come trasporto invece, e usa:

      * **Comando:** `npx`
      * **Argomenti:** `-y olostep-mcp`
      * **Ambiente:** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      Richiede Node.js 18+ sulla tua macchina. Se il comando si basa su qualcosa nel tuo `PATH`, riavvia Raycast dopo aver aggiornato le variabili d'ambiente in modo che i nuovi valori vengano rilevati.
    </Accordion>
  </Step>

  <Step title="Verifica e inizia a usarlo">
    Apri il comando **Manage MCP Servers** — `olostep` dovrebbe apparire come **Running** con i suoi **10 strumenti**. Quindi, in AI Chat o Quick AI, digita `@olostep` per indirizzare una richiesta a esso:

    ```txt theme={null}
    @olostep trova gli ultimi prezzi su queste tre pagine dei concorrenti e riassumili
    ```
  </Step>
</Steps>

## Strumenti disponibili

In Raycast invochi strumenti in linguaggio naturale — menziona `@` `olostep`, descrivi ciò che vuoi, e Raycast AI sceglie lo strumento giusto. Gli esempi seguenti mostrano prompt tipici.

### scrape\_website

Estrai contenuti da un singolo URL in Markdown, HTML, JSON o testo. Gestisce pagine renderizzate in JavaScript e supporta targeting per paese e parser specializzati.

```txt theme={null}
@olostep scrape https://example.com/pricing e dammi il markdown pulito
```

### search\_web

Esegui una ricerca web e restituisci risultati strutturati per una query.

```txt theme={null}
@olostep cerca le ultime notizie sulla regolamentazione AI dell'UE
```

### answers

Ottieni una risposta generata da AI a una domanda, basata su dati web reali e restituita con fonti citate. Chiedi una forma specifica per ottenere un output strutturato.

```txt theme={null}
@olostep quali sono i 5 principali concorrenti di Notion per documenti tecnici? Restituisci nome, homepage e una descrizione di una riga, con fonti.
```

### batch\_scrape\_urls

Fai scraping di un elenco noto di URL in un lavoro parallelo (fino a 10.000). Esegue in modo asincrono e restituisce un lavoro che recuperi una volta completato.

```txt theme={null}
@olostep fai scraping di questi 200 URL di prodotti e restituisci il titolo e il prezzo per ciascuno come JSON
```

### create\_crawl

Inizia da un URL, segui i suoi link e fai scraping delle pagine corrispondenti su un intero sito o sezione. Esegue in modo asincrono.

```txt theme={null}
@olostep fai crawling di https://docs.stripe.com sotto /docs e riassumi ogni sezione come markdown
```

### create\_map

Elenca ogni URL su un sito senza fare scraping del contenuto — utile per la scoperta prima di un crawl o di un lavoro batch.

```txt theme={null}
@olostep mappa tutti gli URL sotto https://example.com/blog
```

<Note>
  **Batch e crawl eseguono in modo asincrono.** Ognuno avvia un lavoro e restituisce un ID, che Raycast recupera con il suo strumento compagno (`get_batch_results`, `get_crawl_results`). Insieme a `get_webpage_content` e `get_website_urls`, il server espone **10 strumenti** in totale. Vedi la [riferimento del Server Olostep MCP](/integrations/mcp-server) per l'elenco completo e i parametri.
</Note>

## Esempi di flussi di lavoro

### Ricerca rapida dei concorrenti

Da AI Chat, raccogli e sintetizza dati web in un unico prompt:

```txt theme={null}
@olostep cerca i migliori strumenti di gestione progetti nel 2026, poi usa answers
per riassumere i 3 più menzionati con i loro prezzi e una fonte per ciascuno.
```

### Trasforma una pagina in appunti puliti

```txt theme={null}
@olostep fai scraping di https://example.com/blog/post e dammi un riassunto di 5 punti
più le citazioni chiave.
```

### Salvalo come un AI Command riutilizzabile

Una volta che Olostep è connesso, puoi incorporare un prompt in un [AI Command](https://manual.raycast.com/ai) con un solo clic. Ad esempio, crea un comando chiamato **"Riassumi URL"** con l'istruzione:

```txt theme={null}
Usando @olostep, fai scraping di {argument} come markdown e restituisci un riassunto di 3 paragrafi
che copra di cosa tratta la pagina, i dettagli chiave e eventuali prezzi.
```

Ora puoi eseguirlo da qualsiasi parte in Raycast con un URL e ottenere un riassunto istantaneo.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Il server mostra come Running ma elenca 0 strumenti">
    La tua chiave API è invalida o limitata. Verificala nella [dashboard Olostep](https://olostep.com/dashboard/api-keys). Per l'endpoint ospitato, l'intestazione deve essere esattamente `Authorization: Bearer YOUR_API_KEY` — senza virgolette intorno al valore e senza spazi extra.
  </Accordion>

  <Accordion title="Olostep non appare dopo l'installazione">
    Apri **Manage MCP Servers** e controlla lo stato del server. Se è in stato di **Errore**, il pannello dei dettagli mostra l'output completo dal server o dal trasporto. Ricontrolla l'URL/intestazione (HTTP) o comando/ambiente (stdio), quindi usa l'azione **Restart**.
  </Accordion>

  <Accordion title="L'installazione locale (stdio) non si avvia">
    Assicurati che Node.js 18+ sia installato e nel tuo `PATH`. Dopo aver installato o modificato le variabili d'ambiente, riavvia completamente Raycast in modo che i nuovi valori vengano rilevati. Su Windows, assicurati che `npx` si risolva nella shell che Raycast avvia.
  </Accordion>

  <Accordion title="L'endpoint ospitato non si connette">
    Conferma che `https://mcp.olostep.com/mcp` sia raggiungibile dalla tua rete (proxy aziendali e firewall possono bloccarlo). Se è bloccato, passa all'installazione locale stdio, che si connette a `api.olostep.com` invece.
  </Accordion>

  <Accordion title="Lo strumento non viene utilizzato in una risposta">
    Assicurati di menzionare `@` `olostep` nel messaggio (in AI Chat o Quick AI), e che la richiesta richieda chiaramente dati web. Puoi indirizzare una domanda al server digitando `@` e selezionandolo.
  </Accordion>
</AccordionGroup>

## Scopri di più

<CardGroup cols={2}>
  <Card title="Raycast" icon="link" href="https://www.raycast.com">
    Il launcher Raycast
  </Card>

  <Card title="Manuale Raycast MCP" icon="book" href="https://manual.raycast.com/ai/model-context-protocol">
    Come Raycast connette e gestisce i server MCP
  </Card>

  <Card title="Server Olostep MCP" icon="server" href="/integrations/mcp-server">
    Configurazione completa MCP, riferimento strumenti e parametri
  </Card>

  <Card title="Repository Server MCP" icon="github" href="https://github.com/olostep/olostep-mcp-server">
    Sorgente, problemi e note di rilascio
  </Card>
</CardGroup>

## Correlati

<CardGroup cols={2}>
  <Card title="Scrapes API" icon="file-lines" href="/features/scrapes">
    Riferimento completo per l'endpoint di scraping
  </Card>

  <Card title="Batches API" icon="layer-group" href="/features/batches">
    Come funzionano i lavori batch e come recuperare i risultati
  </Card>

  <Card title="Crawls API" icon="spider-web" href="/features/crawls">
    Configurazione del crawl e recupero dei risultati
  </Card>

  <Card title="Maps API" icon="map" href="/features/maps">
    Scoperta degli URL e opzioni di filtraggio
  </Card>
</CardGroup>

## Inizia

Pronto a portare dati web live in Raycast?

<CardGroup cols={2}>
  <Card title="Ottieni una chiave API gratuita" icon="key" href="https://olostep.com/dashboard/api-keys">
    Iscriviti e prendi la tua chiave API Olostep — 500 crediti inclusi
  </Card>

  <Card title="Sfoglia i server MCP di Raycast" icon="store" href="https://www.raycast.com">
    Trova Olostep e altri server nel registro MCP di Raycast
  </Card>
</CardGroup>

Connetti Olostep con Raycast e metti scraping web, ricerca e crawling a una menzione `@olostep` di distanza.