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

> Usa Olostep MCP Server come strumento esterno in Kilo per ricerca web, scraping e estrazione di contenuti

Kilo è la piattaforma di ingegneria agentica tutto-in-uno con supporto per server MCP (Model Context Protocol). L'Olostep MCP Server si integra perfettamente con Kilo, fornendo al tuo agente AI potenti capacità di gestione dei dati web.

## Funzionalità

L'Olostep MCP Server offre accesso a 5 capacità principali di Olostep:

<CardGroup cols={2}>
  <Card title="Scrape Website" icon="file-lines">
    Estrai contenuti da qualsiasi URL singolo in più formati (Markdown, HTML, JSON, testo)
  </Card>

  <Card title="Search Web" icon="search">
    Cerca sul web e ottieni risultati strutturati, basati su parser
  </Card>

  <Card title="Answers (AI)" icon="brain">
    Ottieni risposte potenziate dall'AI con query in linguaggio naturale e citazioni
  </Card>

  <Card title="Batch Scrape URLs" icon="layer-group">
    Elabora fino a 10.000 URL in parallelo. Perfetto per l'estrazione di dati su larga scala
  </Card>

  <Card title="Crawl Websites" icon="spider-web">
    Scopri e raschia autonomamente interi siti web seguendo i link
  </Card>
</CardGroup>

## Installazione

### 1. Ottieni la tua API Key

Ottieni la tua API key Olostep dal [Dashboard Olostep](https://olostep.com/dashboard/api-keys).

### 2. Configura Kilo

Nel tuo progetto, crea o modifica `.kilocode/mcp.json` per aggiungere l'Olostep MCP Server:

<CodeGroup>
  ```json Remote Hosted MCP (Recommended) theme={null}
  {
    "mcpServers": {
      "olostep": {
        "url": "https://mcp.olostep.com/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_OLOSTEP_API_KEY"
        }
      }
    }
  }
  ```

  ```json Local/Stdio MCP theme={null}
  {
    "mcpServers": {
      "olostep": {
        "command": "npx",
        "args": ["-y", "olostep-mcp"],
        "env": {
          "OLOSTEP_API_KEY": "YOUR_OLOSTEP_API_KEY"
        }
      }
    }
  }
  ```
</CodeGroup>

Sostituisci `YOUR_OLOSTEP_API_KEY` con la tua effettiva API key dal Dashboard Olostep.

### 3. Verifica l'Installazione

Esegui Kilo e gli strumenti Olostep dovrebbero essere automaticamente disponibili:

```bash theme={null}
kilo
```

## Strumenti Disponibili

Una volta configurato, i seguenti strumenti Olostep sono disponibili per il tuo agente Kilo:

### scrape\_website

Estrai contenuti da un singolo URL. Supporta più formati e rendering JavaScript.

**Esempio di prompt:**

```
Raschia il contenuto da https://example.com e dammi la versione markdown
```

**Parametri:**

* `url` - URL del sito web da raschiare (obbligatorio)
* `format` - Formato di output: `markdown`, `html`, `json`, o `text` (predefinito: markdown)
* `country` - Codice paese per contenuti specifici della località (es. "US", "GB")
* `wait_before_scraping` - Tempo di attesa in millisecondi per il rendering JavaScript (0-10000)
* `parser` - ID parser opzionale per estrazione specializzata (es. "@olostep/amazon-product")

### search\_web

Cerca sul web e restituisci risultati strutturati, basati su parser.

**Esempio di prompt:**

```
Cerca le ultime notizie sui regolamenti AI nell'UE
```

**Parametri:**

* `query` - Query di ricerca (obbligatoria)
* `country` - Codice paese per risultati specifici della località

### answers

Ottieni risposte potenziate dall'AI da ricerche web con fonti e citazioni.

**Esempio di prompt:**

```
Quali sono le 5 principali tendenze emergenti dell'AI nel 2026? Dammi risposte strutturate con fonti.
```

**Parametri:**

* `query` - Domanda in linguaggio naturale (obbligatoria)
* `format` - Formato di output per le risposte (struttura JSON a tua scelta)
* `country` - Codice paese per ricerche specifiche della località

### batch\_scrape\_urls

Elabora più URL in parallelo. Perfetto per l'estrazione di dati su larga scala.

**Esempio di prompt:**

```
Raschia questi 50 URL di prodotti ed estrai titolo, prezzo e descrizione in formato JSON
```

**Parametri:**

* `urls` - Array di URL da raschiare (obbligatorio)
* `format` - Formato di output per tutti gli URL
* `country` - Codice paese per contenuti specifici della località
* `parser` - ID parser opzionale per tutti gli URL

### create\_crawl

Scopri e raschia autonomamente interi siti web seguendo i link da un URL iniziale.

**Esempio di prompt:**

```
Raschia il sito web a partire da https://example.com ed estrai tutte le pagine dei prodotti
```

**Parametri:**

* `start_url` - URL iniziale per il crawl (obbligatorio)
* `max_pages` - Numero massimo di pagine da raschiare (predefinito: 10). Imposta su `1` per raschiare solo l'URL iniziale.

### create\_map

Estrai tutti gli URL da un sito web per analisi della struttura del sito e scoperta dei contenuti.

**Esempio di prompt:**

```
Mappa tutti gli URL su https://example.com per comprendere la struttura del sito
```

**Parametri:**

* `website_url` - Sito web da mappare (obbligatorio)
* `search_query` - Query opzionale per filtrare i risultati
* `top_n` - Limita il numero di URL restituiti

## Esempi di Flussi di Lavoro

### Compito di Ricerca con Ricerca Web

Lascia che l'agente Kilo raccolga informazioni dal web:

```
Usa lo strumento search_web per trovare articoli recenti sulla sicurezza LLM,
poi usa lo strumento answers per sintetizzare i risultati chiave con fonti.
Dammi un riassunto completo.
```

### Estrazione Dati di Prodotto

Raschia più pagine di prodotti:

```
Ho 100 URL di prodotti da un sito e-commerce. Usa batch_scrape_urls
per estrarre titolo, prezzo, descrizione e disponibilità da ciascuno.
Formatta i risultati come JSON.
```

### Scoperta e Analisi del Sito Web

Raschia e analizza la struttura di un sito web:

```
Voglio comprendere la struttura di https://example.com.
Prima, usa create_map per ottenere tutti gli URL, poi raschia le sezioni principali
e dammi un riassunto dell'organizzazione dei contenuti del sito.
```

## Variabili d'Ambiente

Quando utilizzi la configurazione locale/stdio, assicurati che il tuo ambiente abbia impostato l'API key:

```bash theme={null}
export OLOSTEP_API_KEY="your_api_key_here"
kilo
```

Oppure nel tuo file `.env`:

```
OLOSTEP_API_KEY=your_api_key_here
```

## Risoluzione dei Problemi

**Strumenti non appaiono in Kilo:**

* Verifica che il `.kilocode/mcp.json` sia formattato correttamente (JSON valido)
* Assicurati che la tua API key sia corretta nella configurazione
* Prova a riavviare Kilo dopo le modifiche alla configurazione

**Errori di autenticazione API key:**

* Ricontrolla la tua API key dal [Dashboard Olostep](https://olostep.com/dashboard/api-keys)
* Assicurati che non ci siano spazi extra o caratteri speciali nella chiave

**MCP ospitato remoto non si connette:**

* Verifica la tua connessione internet
* Controlla che `https://mcp.olostep.com/mcp` sia accessibile
* Assicurati che il formato dell'header Authorization sia corretto: `Bearer YOUR_KEY`

## Scopri di Più

* [Sito Web Kilo](https://kilo.ai/)
* [Documentazione Kilo](https://docs.kilo.ai/)
* [Repository Olostep MCP Server](https://github.com/olostep/olostep-mcp-server)
* [Specifiche del Model Context Protocol (MCP)](https://modelcontextprotocol.io/)