Vai al contenuto principale
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 MCP ufficiale di Olostep si integra direttamente in Raycast AI — fornendo al tuo launcher strumenti di dati web live che puoi chiamare da AI Chat, Quick AI e AI Commands con una semplice menzione @olostep. Olostep è una voce ufficiale nel registro MCP di Raycast, quindi puoi aggiungerlo in pochi clic — senza file di configurazione da modificare.

Funzionalità

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

Scrape Website

Estrai contenuti da qualsiasi URL singolo come Markdown, HTML, JSON o testo — con rendering JavaScript e targeting per paese.

Search Web

Esegui una ricerca web e ottieni risultati strutturati basati su parser (titoli, URL, frammenti).

Answers (AI)

Fai una domanda in linguaggio naturale e ottieni una risposta basata sul web con fonti citate e output strutturato opzionale.

Batch Scrape URLs

Elabora fino a 100.000 URL in un singolo lavoro parallelo — ideale per estrazioni su larga scala.

Crawl Websites

Parti da un URL, segui i link e fai scraping di interi siti o sezioni automaticamente.

Map Site URLs

Scopri ogni URL su un sito senza fare scraping — perfetto per pianificare un crawl o un lavoro batch.

Prima di iniziare

  • Una chiave API di Olostep: ottieni una gratuitamente, non è richiesta la carta di credito. I tuoi primi 500 crediti sono inclusi.
  • Raycast installato, con Raycast AI disponibile nel tuo piano. Gli strumenti MCP funzionano tramite Raycast AI (AI Chat, Quick AI e AI Commands).
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. Scegline uno — mescolare le due modalità di autenticazione è l’errore di configurazione più comune.

Installazione

1

Ottieni la tua chiave API

Copia la tua chiave dalla dashboard di Olostep. La incollerai in Raycast nel passaggio successivo.
2

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 dallo Store di Raycast (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 di Olostep quando richiesto.
Raycast salva la configurazione, avvia la connessione e carica gli strumenti automaticamente.
3

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 + ↵).
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.
4

Verifica e inizia a usarlo

Apri il comando Manage MCP Servers — olostep dovrebbe apparire come Running con i suoi 10 strumenti. Poi, in AI Chat o Quick AI, digita @olostep per indirizzare una richiesta a esso:

Strumenti disponibili

In Raycast puoi invocare strumenti in linguaggio naturale — menziona @olostep, descrivi ciò che desideri, 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 con JavaScript e supporta il targeting per paese e parser specializzati.

search_web

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

answers

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

batch_scrape_urls

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

create_crawl

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

create_map

Elenca ogni URL su un sito senza fare scraping dei contenuti — utile per la scoperta prima di un crawl o un lavoro batch.
Batch e crawl eseguono in modo asincrono. Ognuno avvia un lavoro e restituisce un ID, che Raycast recupera con il suo strumento complementare (get_batch_results, get_crawl_results). Insieme a get_webpage_content e get_website_urls, il server espone 10 strumenti in totale. Vedi il riferimento del Server MCP di Olostep per l’elenco completo e i parametri.

Flussi di lavoro di esempio

Ricerca rapida sui concorrenti

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

Trasforma una pagina in appunti puliti

Salvalo come comando AI riutilizzabile

Una volta connesso Olostep, puoi incorporare un prompt in un AI Command con un solo tasto. Ad esempio, crea un comando chiamato “Riassumi URL” con l’istruzione:
Ora puoi eseguirlo da qualsiasi parte in Raycast con un URL e ottenere un riassunto istantaneo.

Risoluzione dei problemi

La tua chiave API non è valida o è limitata. Verificala nella dashboard di Olostep. Per l’endpoint ospitato, l’intestazione deve essere esattamente Authorization: Bearer YOUR_API_KEY — senza virgolette intorno al valore e senza spazi extra.
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.
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 avviata da Raycast.
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 invece a api.olostep.com.
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.

Scopri di più

Raycast

Il launcher Raycast

Manuale Raycast MCP

Come Raycast connette e gestisce i server MCP

Server MCP di Olostep

Configurazione completa MCP, riferimento strumenti e parametri

Repository del Server MCP

Sorgente, problemi e note di rilascio

Correlati

API Scrapes

Riferimento completo per l’endpoint di scraping

API Batches

Come funzionano i lavori batch e come recuperare i risultati

API Crawls

Configurazione del crawl e recupero dei risultati

API Maps

Scoperta degli URL e opzioni di filtraggio

Inizia

Pronto a portare i dati web live in Raycast?

Ottieni una chiave API gratuita

Iscriviti e prendi la tua chiave API di Olostep — 500 crediti inclusi

Sfoglia i server MCP di Raycast

Trova Olostep e altri server nel registro MCP di Raycast
Connetti Olostep con Raycast e metti lo scraping web, la ricerca e il crawling a una menzione @olostep di distanza.