> ## 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 + Raycast-integratie

> Voeg webscraping, zoeken, crawlen en AI-antwoorden toe aan Raycast AI met de officiële Olostep MCP-server

Raycast is de productiviteitslauncher die wordt gebruikt door ontwikkelaars, operators en AI-powergebruikers. Met Raycast's native ondersteuning voor het Model Context Protocol (MCP) sluit de **officiële Olostep MCP-server** direct aan op Raycast AI — waardoor je launcher live webdatatools krijgt die je kunt oproepen vanuit AI Chat, Quick AI en AI Commands met een simpele `@olostep` vermelding.

Olostep is een [officiële vermelding in Raycast's MCP-register](https://www.raycast.com/), dus je kunt het in een paar klikken toevoegen — geen configuratiebestanden om te bewerken.

## Functies

De Olostep MCP-server geeft je Raycast AI toegang tot Olostep's kernwebdatamogelijkheden:

<CardGroup cols={2}>
  <Card title="Website Scrapen" icon="file-lines">
    Extraheer inhoud van elke enkele URL als Markdown, HTML, JSON of tekst — met JavaScript-rendering en landgerichte targeting.
  </Card>

  <Card title="Web Zoeken" icon="magnifying-glass">
    Voer een webzoekopdracht uit en krijg gestructureerde, parser-gebaseerde resultaten (titels, URL's, fragmenten).
  </Card>

  <Card title="Antwoorden (AI)" icon="sparkles">
    Stel een vraag in natuurlijke taal en krijg een web-gebaseerd antwoord met geciteerde bronnen en optionele gestructureerde output.
  </Card>

  <Card title="Batch Scrapen van URL's" icon="layer-group">
    Verwerk tot 10.000 URL's in een enkele parallelle taak — ideaal voor grootschalige extractie.
  </Card>

  <Card title="Websites Crawlen" icon="spider-web">
    Begin vanaf een URL, volg links en scrape automatisch hele sites of secties.
  </Card>

  <Card title="Site-URL's in Kaart Brengen" icon="map">
    Ontdek elke URL op een site zonder te scrapen — perfect voor het plannen van een crawl of batchtaak.
  </Card>
</CardGroup>

## Voordat je begint

* **Een Olostep API-sleutel:** [haal er gratis een](https://olostep.com/dashboard/api-keys), geen creditcard vereist. Je eerste 500 credits zijn inbegrepen.
* **Raycast geïnstalleerd**, met [Raycast AI](https://manual.raycast.com/ai) beschikbaar in je plan. MCP-tools draaien via Raycast AI (AI Chat, Quick AI en AI Commands).

<Note>
  Olostep ondersteunt twee verbindingsmodi. De **gehoste eindpunt** (`https://mcp.olostep.com/mcp`) gebruikt een `Authorization: Bearer YOUR_API_KEY` header. De **lokale stdio** optie (`npx -y olostep-mcp`) gebruikt `OLOSTEP_API_KEY` als een omgevingsvariabele. Kies er een — het mixen van de twee authenticatiemodi is de meest voorkomende instellingsfout.
</Note>

## Installatie

<Steps>
  <Step title="Haal je API-sleutel op">
    Kopieer je sleutel van het [Olostep-dashboard](https://olostep.com/dashboard/api-keys). Je plakt het in Raycast in de volgende stap.
  </Step>

  <Step title="Installeer Olostep in Raycast (aanbevolen)">
    Omdat Olostep een officiële vermelding is in Raycast's MCP-register, is de snelste weg één klik:

    1. Installeer de **Model Context Protocol Registry** extensie uit de Raycast Store (zoek naar "MCP" of "Model Context Protocol").
    2. Voer het **Search Servers** commando uit, zoek naar **Olostep** en selecteer het.
    3. Kies **Install**, en voer je Olostep API-sleutel in wanneer daarom gevraagd wordt.

    Raycast slaat de configuratie op, start de verbinding en laadt de tools automatisch.
  </Step>

  <Step title="Of voeg het handmatig toe">
    Liever zelf instellen? Open Raycast, voer **Install MCP Server** uit (of **Manage MCP Servers → Install New Server**), en vul het formulier in met deze waarden:

    * **Naam:** `olostep`
    * **Transport:** HTTP
    * **URL:** `https://mcp.olostep.com/mcp`
    * **HTTP Header:** `Authorization` → `Bearer YOUR_API_KEY`

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

    <Accordion title="Liever een lokale installatie? (stdio)">
      Kies in plaats daarvan **Standard Input/Output** als transport, en gebruik:

      * **Commando:** `npx`
      * **Argumenten:** `-y olostep-mcp`
      * **Omgeving:** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      Vereist Node.js 18+ op je machine. Als het commando afhankelijk is van iets op je `PATH`, herstart Raycast nadat je je omgevingsvariabelen hebt bijgewerkt zodat de nieuwe waarden worden opgepikt.
    </Accordion>
  </Step>

  <Step title="Verifieer en begin het te gebruiken">
    Open het **Manage MCP Servers** commando — `olostep` zou als **Running** moeten verschijnen met zijn **10 tools**. Typ vervolgens in AI Chat of Quick AI `@olostep` om een verzoek eraan te koppelen:

    ```txt theme={null}
    @olostep vind de laatste prijzen op deze drie concurrentiepagina's en vat het samen
    ```
  </Step>
</Steps>

## Beschikbare tools

In Raycast roep je tools aan in natuurlijke taal — `@`-vermeld `olostep`, beschrijf wat je wilt, en Raycast AI kiest de juiste tool. De voorbeelden hieronder tonen typische prompts.

### scrape\_website

Extraheer inhoud van een enkele URL in Markdown, HTML, JSON of tekst. Verwerkt JavaScript-gerenderde pagina's en ondersteunt landgerichte targeting en gespecialiseerde parsers.

```txt theme={null}
@olostep scrape https://example.com/pricing en geef me de schone markdown
```

### search\_web

Voer een webzoekopdracht uit en retourneer gestructureerde resultaten voor een query.

```txt theme={null}
@olostep zoek naar het laatste nieuws over EU AI-regulering
```

### answers

Krijg een AI-gegenereerd antwoord op een vraag, gebaseerd op echte webgegevens en geretourneerd met geciteerde bronnen. Vraag om een specifieke vorm om gestructureerde output te krijgen.

```txt theme={null}
@olostep wat zijn de top 5 concurrenten van Notion voor technische documentatie? Retourneer naam, homepage en een eenregelige beschrijving, met bronnen.
```

### batch\_scrape\_urls

Scrape een bekende lijst van URL's in één parallelle taak (tot 10.000). Draait asynchroon en retourneert een taak die je ophaalt zodra deze voltooid is.

```txt theme={null}
@olostep scrape deze 200 product-URL's en retourneer de titel en prijs voor elk als JSON
```

### create\_crawl

Begin vanaf een URL, volg de links en scrape overeenkomende pagina's over een hele site of sectie. Draait asynchroon.

```txt theme={null}
@olostep crawl https://docs.stripe.com onder /docs en vat elke sectie samen als markdown
```

### create\_map

Lijst elke URL op een site zonder inhoud te scrapen — handig voor ontdekking voorafgaand aan een crawl of batchtaak.

```txt theme={null}
@olostep map alle URL's onder https://example.com/blog
```

<Note>
  **Batch en crawl draaien asynchroon.** Elk start een taak en retourneert een ID, die Raycast ophaalt met zijn bijbehorende tool (`get_batch_results`, `get_crawl_results`). Samen met `get_webpage_content` en `get_website_urls` stelt de server in totaal **10 tools** bloot. Zie de [Olostep MCP Server-referentie](/integrations/mcp-server) voor de volledige lijst en parameters.
</Note>

## Voorbeeldworkflows

### Snelle concurrentieonderzoek

Verzamel en syntheseer webgegevens in één prompt vanuit AI Chat:

```txt theme={null}
@olostep zoek naar de top projectmanagementtools in 2026, gebruik dan antwoorden
om de 3 meest genoemde samen te vatten met hun prijzen en een bron voor elk.
```

### Zet een pagina om in schone notities

```txt theme={null}
@olostep scrape https://example.com/blog/post en geef me een samenvatting in 5 punten
plus de belangrijkste citaten.
```

### Sla het op als een herbruikbaar AI-commando

Zodra Olostep is verbonden, kun je een prompt inbakken in een eenmalig [AI Command](https://manual.raycast.com/ai). Maak bijvoorbeeld een commando genaamd **"Samenvatten URL"** met de instructie:

```txt theme={null}
Gebruik @olostep, scrape {argument} als markdown en retourneer een samenvatting in 3 paragrafen
over waar de pagina over gaat, de belangrijkste details en eventuele prijzen.
```

Nu kun je het overal in Raycast uitvoeren met een URL en krijg je direct een samenvatting.

## Problemen oplossen

<AccordionGroup>
  <Accordion title="Server toont als Running maar vermeldt 0 tools">
    Je API-sleutel is ongeldig of beperkt in gebruik. Verifieer het in het [Olostep-dashboard](https://olostep.com/dashboard/api-keys). Voor het gehoste eindpunt moet de header precies `Authorization: Bearer YOUR_API_KEY` zijn — geen aanhalingstekens rond de waarde en geen extra spaties.
  </Accordion>

  <Accordion title="Olostep verschijnt niet na installatie">
    Open **Manage MCP Servers** en controleer de status van de server. Als het in een **Error** staat verkeert, toont het detailvenster de volledige uitvoer van de server of transport. Controleer de URL/header (HTTP) of commando/omgeving (stdio) opnieuw, en gebruik dan de **Restart** actie.
  </Accordion>

  <Accordion title="Lokale (stdio) installatie start niet">
    Zorg ervoor dat Node.js 18+ is geïnstalleerd en op je `PATH` staat. Na installatie of verandering van omgevingsvariabelen, herstart Raycast volledig zodat de nieuwe waarden worden opgepikt. Op Windows, zorg ervoor dat `npx` wordt herkend in de shell die Raycast start.
  </Accordion>

  <Accordion title="Gehoste eindpunt maakt geen verbinding">
    Bevestig dat `https://mcp.olostep.com/mcp` bereikbaar is vanuit je netwerk (bedrijfsproxy's en firewalls kunnen het blokkeren). Als het geblokkeerd is, schakel dan over naar de lokale stdio-installatie, die in plaats daarvan verbinding maakt met `api.olostep.com`.
  </Accordion>

  <Accordion title="Tool wordt niet gebruikt in een reactie">
    Zorg ervoor dat je `@`-vermelding `olostep` in het bericht (in AI Chat of Quick AI), en dat het verzoek duidelijk vraagt om webgegevens. Je kunt een vraag aan de server koppelen door `@` te typen en deze te selecteren.
  </Accordion>
</AccordionGroup>

## Meer leren

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

  <Card title="Raycast MCP Handleiding" icon="book" href="https://manual.raycast.com/ai/model-context-protocol">
    Hoe Raycast MCP-servers verbindt en beheert
  </Card>

  <Card title="Olostep MCP Server" icon="server" href="/integrations/mcp-server">
    Volledige MCP-instelling, toolreferentie en parameters
  </Card>

  <Card title="MCP Server Repository" icon="github" href="https://github.com/olostep/olostep-mcp-server">
    Bron, problemen en release-opmerkingen
  </Card>
</CardGroup>

## Gerelateerd

<CardGroup cols={2}>
  <Card title="Scrapes API" icon="file-lines" href="/features/scrapes">
    Volledige referentie voor het scrape-eindpunt
  </Card>

  <Card title="Batches API" icon="layer-group" href="/features/batches">
    Hoe batchtaken werken en hoe resultaten op te halen
  </Card>

  <Card title="Crawls API" icon="spider-web" href="/features/crawls">
    Crawlconfiguratie en resultaatophaling
  </Card>

  <Card title="Maps API" icon="map" href="/features/maps">
    URL-ontdekking en filteropties
  </Card>
</CardGroup>

## Aan de slag

Klaar om live webgegevens naar Raycast te brengen?

<CardGroup cols={2}>
  <Card title="Haal een gratis API-sleutel" icon="key" href="https://olostep.com/dashboard/api-keys">
    Meld je aan en pak je Olostep API-sleutel — 500 credits inbegrepen
  </Card>

  <Card title="Blader door Raycast MCP-servers" icon="store" href="https://www.raycast.com">
    Vind Olostep en andere servers in het Raycast MCP-register
  </Card>
</CardGroup>

Verbind Olostep met Raycast en breng webscraping, zoeken en crawlen binnen handbereik met een `@olostep` vermelding.