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

> Fornisci agli agenti creati con Composio ricerca web live, scraping, crawling, batch e risposte tramite il toolkit Olostep.

Il [toolkit Olostep su Composio](https://composio.dev/toolkits/olostep) offre ai tuoi agenti 16 strumenti Olostep, sia tramite un server MCP ospitato che direttamente nel codice del tuo agente. [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 live, scraping e crawling per estrarre, pulire e strutturare dati dal web.

[Visualizza su Composio →](https://composio.dev/toolkits/olostep)

## Prima di iniziare

* **Un account Olostep con una chiave API:** [ottienine una gratuita](https://www.olostep.com/dashboard/api-keys), non è richiesta la carta di credito. I tuoi primi 500 crediti sono inclusi.
* **Un account Composio e una chiave API:** iscriviti su [composio.dev](https://composio.dev).

Composio richiede la tua chiave API Olostep quando connetti il toolkit e la memorizza criptata.

## Usa gli strumenti tramite MCP

Composio crea un server MCP con il toolkit Olostep per ciascuno dei tuoi utenti. Questo esempio lo collega all'SDK AI di Vercel:

```bash theme={null}
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

```ts theme={null}
import { Composio } from "@composio/core";
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["olostep"],
  mcp: true,
});

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Crawl competitor website for pricing changes",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Usa gli strumenti direttamente

Puoi anche passare gli strumenti al tuo fornitore di modelli senza MCP. Questo esempio utilizza l'API OpenAI Responses:

```bash theme={null}
npm install @composio/core @composio/openai openai
```

```ts theme={null}
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["olostep"] });
const tools = await session.tools();

let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Crawl competitor website for pricing changes" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

Consulta la [documentazione di Composio](https://docs.composio.dev) per altri framework e per Python.

## Strumenti

| Strumento | Cosa fa |
| - | - |
| `OLOSTEP_SEARCH_WEB` | Cerca sul web e restituisce link |
| `OLOSTEP_SCRAPE_PAGE` | Esegue lo scraping di una pagina e restituisce il suo contenuto, i link e i metadati |
| `OLOSTEP_ANSWER_QUESTION` | Ricerca una domanda sul web e restituisce una risposta con le fonti |
| `OLOSTEP_MAP_WEBSITE` | Elenca gli URL di un sito web, eventualmente classificati per rilevanza |
| `OLOSTEP_START_BATCH` | Avvia uno scraping batch di molti URL e restituisce un ID batch |
| `OLOSTEP_LIST_BATCH_ITEMS` | Ottiene una pagina dei risultati di un batch |
| `OLOSTEP_START_CRAWL` | Avvia un crawl di un sito web e restituisce un ID crawl |
| `OLOSTEP_LIST_CRAWL_PAGES` | Ottiene una pagina degli URL elaborati da un crawl |
| `OLOSTEP_RETRIEVE_CONTENT` | Ottiene il contenuto di una pagina scansionata tramite il suo ID di recupero |
| `OLOSTEP_GET_OPERATION_RESULT` | Ottiene uno scraping, una ricerca, una mappa, una risposta, un crawl o un batch memorizzato tramite il suo ID |
| `OLOSTEP_CREATE_MONITOR` | Monitora una pagina o una query web su un programma, con avvisi opzionali e un webhook |
| `OLOSTEP_LIST_MONITORS` | Elenca i tuoi monitor e le loro impostazioni |
| `OLOSTEP_LIST_MONITOR_EVENTS` | Ottiene gli snapshot di un monitor e i riassunti delle modifiche |
| `OLOSTEP_UPDATE_MONITOR` | Modifica il programma, le notifiche o il webhook di un monitor |
| `OLOSTEP_SET_MONITOR_STATE` | Metti in pausa o riprendi un monitor |
| `OLOSTEP_GET_CREDIT_BALANCE` | Controlla i crediti rimanenti e il piano |

I batch e i crawl vengono eseguiti in background. Avviane uno, quindi utilizza `OLOSTEP_LIST_BATCH_ITEMS` o `OLOSTEP_LIST_CRAWL_PAGES` e `OLOSTEP_RETRIEVE_CONTENT` per leggere le pagine. L'API Olostep accetta fino a 100k URL in un singolo batch e puoi scalare fino a 1M di richieste con 10 batch paralleli.

## Risorse

> [card] [Olostep su Composio](https://composio.dev/toolkits/olostep)
>
> La pagina del toolkit Olostep

> [card] [Documentazione Composio](https://docs.composio.dev)
>
> Sessioni, MCP e framework

> [card] [Sito web Olostep](https://www.olostep.com)
>
> Piani e prezzi

> [card] [Supporto](mailto:info@olostep.com)
>
> [info@olostep.com](mailto:info@olostep.com)


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