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

> Füge Web-Scraping, Suche, Crawling und KI-Antworten zu Raycast AI mit dem offiziellen Olostep MCP-Server hinzu

Raycast ist der Produktivitätsstarter, der von Entwicklern, Operatoren und KI-Power-Usern genutzt wird. Mit Raycasts nativer Unterstützung für das Model Context Protocol (MCP) integriert sich der **offizielle Olostep MCP-Server** direkt in Raycast AI — und bietet deinem Starter Live-Web-Daten-Tools, die du aus AI Chat, Quick AI und AI Commands mit einer einfachen `@olostep`-Erwähnung aufrufen kannst.

Olostep ist ein [offizieller Eintrag im MCP-Register von Raycast](https://www.raycast.com/), sodass du es mit ein paar Klicks hinzufügen kannst — keine Konfigurationsdateien zum Bearbeiten.

## Funktionen

Der Olostep MCP-Server gibt deinem Raycast AI Zugriff auf die Kern-Web-Daten-Funktionen von Olostep:

<CardGroup cols={2}>
  <Card title="Website auslesen" icon="file-lines">
    Extrahiere Inhalte von jeder einzelnen URL als Markdown, HTML, JSON oder Text — mit JavaScript-Rendering und Länderzielausrichtung.
  </Card>

  <Card title="Web durchsuchen" icon="magnifying-glass">
    Führe eine Websuche durch und erhalte strukturierte, parserbasierte Ergebnisse (Titel, URLs, Snippets).
  </Card>

  <Card title="Antworten (KI)" icon="sparkles">
    Stelle eine Frage in natürlicher Sprache und erhalte eine webbasierte Antwort mit zitierten Quellen und optionalem strukturiertem Output.
  </Card>

  <Card title="URLs stapelweise auslesen" icon="layer-group">
    Verarbeite bis zu 10.000 URLs in einem einzigen parallelen Job — ideal für großflächige Extraktion.
  </Card>

  <Card title="Websites crawlen" icon="spider-web">
    Starte von einer URL, folge Links und scrappe ganze Websites oder Abschnitte automatisch.
  </Card>

  <Card title="Site-URLs abbilden" icon="map">
    Entdecke jede URL auf einer Website ohne Scraping — perfekt für die Planung eines Crawls oder Stapeljobs.
  </Card>
</CardGroup>

## Bevor du beginnst

* **Ein Olostep API-Schlüssel:** [kostenlos erhalten](https://olostep.com/dashboard/api-keys), keine Kreditkarte erforderlich. Deine ersten 500 Credits sind inklusive.
* **Raycast installiert**, mit [Raycast AI](https://manual.raycast.com/ai) verfügbar in deinem Plan. MCP-Tools laufen über Raycast AI (AI Chat, Quick AI und AI Commands).

<Note>
  Olostep unterstützt zwei Verbindungsmodi. Der **gehostete Endpunkt** (`https://mcp.olostep.com/mcp`) verwendet einen `Authorization: Bearer YOUR_API_KEY`-Header. Die **lokale stdio**-Option (`npx -y olostep-mcp`) verwendet `OLOSTEP_API_KEY` als Umgebungsvariable. Wähle einen — das Mischen der beiden Authentifizierungsmodi ist der häufigste Einrichtungsfehler.
</Note>

## Installation

<Steps>
  <Step title="Hole dir deinen API-Schlüssel">
    Kopiere deinen Schlüssel aus dem [Olostep-Dashboard](https://olostep.com/dashboard/api-keys). Du wirst ihn im nächsten Schritt in Raycast einfügen.
  </Step>

  <Step title="Installiere Olostep in Raycast (empfohlen)">
    Da Olostep ein offizieller Eintrag im MCP-Register von Raycast ist, ist der schnellste Weg ein Klick:

    1. Installiere die **Model Context Protocol Registry**-Erweiterung aus dem Raycast Store (suche nach "MCP" oder "Model Context Protocol").
    2. Führe den **Search Servers**-Befehl aus, suche nach **Olostep** und wähle es aus.
    3. Wähle **Installieren**, dann gib deinen Olostep API-Schlüssel ein, wenn du dazu aufgefordert wirst.

    Raycast speichert die Konfiguration, startet die Verbindung und lädt die Tools automatisch.
  </Step>

  <Step title="Oder manuell hinzufügen">
    Möchtest du es selbst einrichten? Öffne Raycast, führe **Install MCP Server** (oder **Manage MCP Servers → Install New Server**) aus und fülle das Formular mit diesen Werten aus:

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

    Drücke **Install MCP Server** (`⌘` / `Ctrl` + `↵`).

    <Accordion title="Bevorzugst du eine lokale Installation? (stdio)">
      Wähle stattdessen **Standard Input/Output** als Transport und verwende:

      * **Befehl:** `npx`
      * **Argumente:** `-y olostep-mcp`
      * **Umgebung:** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      Erfordert Node.js 18+ auf deinem Rechner. Wenn der Befehl auf etwas in deinem `PATH` angewiesen ist, starte Raycast neu, nachdem du deine Umgebungsvariablen aktualisiert hast, damit die neuen Werte übernommen werden.
    </Accordion>
  </Step>

  <Step title="Verifizieren und verwenden">
    Öffne den **Manage MCP Servers**-Befehl — `olostep` sollte als **Running** mit seinen **10 Tools** erscheinen. Dann, in AI Chat oder Quick AI, tippe `@olostep`, um eine Anfrage darauf zu beschränken:

    ```txt theme={null}
    @olostep finde die neuesten Preise auf diesen drei Wettbewerberseiten und fasse sie zusammen
    ```
  </Step>
</Steps>

## Verfügbare Tools

In Raycast rufst du Tools in natürlicher Sprache auf — `@`-erwähne `olostep`, beschreibe, was du möchtest, und Raycast AI wählt das richtige Tool. Die folgenden Beispiele zeigen typische Eingabeaufforderungen.

### scrape\_website

Extrahiere Inhalte von einer einzelnen URL in Markdown, HTML, JSON oder Text. Verarbeitet JavaScript-gerenderte Seiten und unterstützt Länderzielausrichtung und spezialisierte Parser.

```txt theme={null}
@olostep scrape https://example.com/pricing und gib mir das saubere Markdown
```

### search\_web

Führe eine Websuche durch und gib strukturierte Ergebnisse für eine Abfrage zurück.

```txt theme={null}
@olostep suche nach den neuesten Nachrichten zur EU-KI-Regulierung
```

### answers

Erhalte eine KI-generierte Antwort auf eine Frage, basierend auf realen Webdaten und mit zitierten Quellen zurückgegeben. Fordere eine bestimmte Form an, um strukturierten Output zu erhalten.

```txt theme={null}
@olostep was sind die Top 5 Konkurrenten von Notion für technische Dokumentationen? Gib Name, Homepage und eine einzeilige Beschreibung mit Quellen zurück.
```

### batch\_scrape\_urls

Scrape eine bekannte Liste von URLs in einem parallelen Job (bis zu 10.000). Läuft asynchron und gibt einen Job zurück, den du abrufen kannst, sobald er abgeschlossen ist.

```txt theme={null}
@olostep scrape diese 200 Produkt-URLs und gib den Titel und Preis für jede als JSON zurück
```

### create\_crawl

Starte von einer URL, folge ihren Links und scrappe passende Seiten über eine ganze Website oder einen Abschnitt. Läuft asynchron.

```txt theme={null}
@olostep crawl https://docs.stripe.com unter /docs und fasse jeden Abschnitt als Markdown zusammen
```

### create\_map

Liste jede URL auf einer Website auf, ohne Inhalte zu scrappen — nützlich zur Entdeckung vor einem Crawl oder Stapeljob.

```txt theme={null}
@olostep mappe alle URLs unter https://example.com/blog
```

<Note>
  **Batch und Crawl laufen asynchron.** Jeder startet einen Job und gibt eine ID zurück, die Raycast mit seinem Begleittool abruft (`get_batch_results`, `get_crawl_results`). Zusammen mit `get_webpage_content` und `get_website_urls` stellt der Server insgesamt **10 Tools** bereit. Siehe die [Olostep MCP Server-Referenz](/integrations/mcp-server) für die vollständige Liste und Parameter.
</Note>

## Beispiel-Workflows

### Schnelle Wettbewerbsrecherche

Sammle und synthetisiere Webdaten in einem Prompt aus AI Chat:

```txt theme={null}
@olostep suche nach den Top-Projektmanagement-Tools im Jahr 2026, dann nutze Antworten, um die 3 am häufigsten genannten mit ihren Preisen und einer Quelle für jede zusammenzufassen.
```

### Eine Seite in saubere Notizen verwandeln

```txt theme={null}
@olostep scrape https://example.com/blog/post und gib mir eine 5-Punkte-Zusammenfassung plus die wichtigsten Zitate.
```

### Als wiederverwendbaren AI-Befehl speichern

Sobald Olostep verbunden ist, kannst du einen Prompt in einen Ein-Klick-[AI-Befehl](https://manual.raycast.com/ai) einbetten. Erstelle zum Beispiel einen Befehl namens **"URL zusammenfassen"** mit der Anweisung:

```txt theme={null}
Verwende @olostep, scrape {argument} als Markdown und gib eine 3-Absatz-Zusammenfassung zurück, die beschreibt, worum es auf der Seite geht, die wichtigsten Details und eventuelle Preise.
```

Jetzt kannst du es von überall in Raycast mit einer URL ausführen und erhältst eine sofortige Zusammenfassung.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Server wird als Running angezeigt, aber listet 0 Tools">
    Dein API-Schlüssel ist ungültig oder rate-limitiert. Überprüfe ihn im [Olostep-Dashboard](https://olostep.com/dashboard/api-keys). Für den gehosteten Endpunkt muss der Header genau `Authorization: Bearer YOUR_API_KEY` sein — keine Anführungszeichen um den Wert und keine zusätzlichen Leerzeichen.
  </Accordion>

  <Accordion title="Olostep erscheint nach der Installation nicht">
    Öffne **Manage MCP Servers** und überprüfe den Status des Servers. Wenn er sich in einem **Error**-Zustand befindet, zeigt das Detailfenster die vollständige Ausgabe des Servers oder Transports. Überprüfe die URL/Header (HTTP) oder Befehl/Umgebung (stdio) erneut und verwende dann die **Neustart**-Aktion.
  </Accordion>

  <Accordion title="Lokale (stdio) Installation startet nicht">
    Stelle sicher, dass Node.js 18+ installiert ist und in deinem `PATH` liegt. Nach der Installation oder Änderung von Umgebungsvariablen starte Raycast vollständig neu, damit die neuen Werte übernommen werden. Unter Windows stelle sicher, dass `npx` in der Shell, die Raycast startet, aufgelöst wird.
  </Accordion>

  <Accordion title="Gehosteter Endpunkt verbindet sich nicht">
    Bestätige, dass `https://mcp.olostep.com/mcp` von deinem Netzwerk aus erreichbar ist (Unternehmensproxies und Firewalls können es blockieren). Wenn es blockiert ist, wechsle zur lokalen stdio-Installation, die stattdessen zu `api.olostep.com` verbindet.
  </Accordion>

  <Accordion title="Tool wird in einer Antwort nicht verwendet">
    Stelle sicher, dass du `@`-olostep in der Nachricht erwähnst (in AI Chat oder Quick AI) und dass die Anfrage klar nach Webdaten verlangt. Du kannst eine Frage an den Server richten, indem du `@` tippst und ihn auswählst.
  </Accordion>
</AccordionGroup>

## Mehr erfahren

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

  <Card title="Raycast MCP-Handbuch" icon="book" href="https://manual.raycast.com/ai/model-context-protocol">
    Wie Raycast MCP-Server verbindet und verwaltet
  </Card>

  <Card title="Olostep MCP-Server" icon="server" href="/integrations/mcp-server">
    Vollständige MCP-Einrichtung, Tool-Referenz und Parameter
  </Card>

  <Card title="MCP-Server-Repository" icon="github" href="https://github.com/olostep/olostep-mcp-server">
    Quelle, Probleme und Versionshinweise
  </Card>
</CardGroup>

## Verwandt

<CardGroup cols={2}>
  <Card title="Scrapes API" icon="file-lines" href="/features/scrapes">
    Vollständige Referenz für den Scrape-Endpunkt
  </Card>

  <Card title="Batches API" icon="layer-group" href="/features/batches">
    Wie Batch-Jobs funktionieren und wie man Ergebnisse abruft
  </Card>

  <Card title="Crawls API" icon="spider-web" href="/features/crawls">
    Crawl-Konfiguration und Ergebnisabruf
  </Card>

  <Card title="Maps API" icon="map" href="/features/maps">
    URL-Entdeckung und Filteroptionen
  </Card>
</CardGroup>

## Loslegen

Bereit, um Live-Web-Daten in Raycast zu bringen?

<CardGroup cols={2}>
  <Card title="Hole dir einen kostenlosen API-Schlüssel" icon="key" href="https://olostep.com/dashboard/api-keys">
    Melde dich an und hole dir deinen Olostep API-Schlüssel — 500 Credits inklusive
  </Card>

  <Card title="Durchsuche Raycast MCP-Server" icon="store" href="https://www.raycast.com">
    Finde Olostep und andere Server im Raycast MCP-Register
  </Card>
</CardGroup>

Verbinde Olostep mit Raycast und bringe Web-Scraping, Suche und Crawling nur eine `@olostep`-Erwähnung entfernt.