Zum Hauptinhalt springen
Der Olostep MCP Server bietet jedem MCP-kompatiblen KI-Client (Claude, Cursor, Windsurf, VS Code, Claude Code, etc.) 10 einsatzbereite Tools für das Live-Web — Scraping, Suche, KI-Antworten mit Zitaten, Batch-Jobs, Site-Crawling und URL-Entdeckung.

Scrape & extrahieren

Markdown, HTML, JSON oder Text von jeder URL mit optionalem JS-Rendering abrufen

KI-Antworten

Web-basierte Antworten mit Quellen und strukturiertem Output

Batch & Crawl

Bis zu 100k URLs parallel oder autonom eine ganze Seite entdecken

Karte & Suche

Finde jede URL auf einer Seite oder führe parserbasierte Websuche durch

Bevor du startest

Du benötigst einen Olostep API-Schlüssel. Hol dir einen vom Olostep Dashboard — die kostenlose Stufe deckt die private Nutzung ab.

Wähle einen Setup-Pfad

Der schnellste Weg für jeden Client ist der gehostete Endpunkt unter https://mcp.olostep.com/mcp. Keine Installationen, kein Node, kein Docker — einfach eine URL und deinen API-Schlüssel einfügen. Wenn du es vollständig lokal (offline Nutzung, Unternehmensproxy, abgeschottet) betreiben musst, unterstützt jeder Client auch eine lokale stdio-Installation über npx. Jeder Abschnitt unten zeigt beides.
Gehosteter Endpunkt verwendet Authorization: Bearer <YOUR_API_KEY>. Lokale stdio verwendet OLOSTEP_API_KEY als Umgebungsvariable. Verwechsle sie nicht — falscher Auth-Modus ist der häufigste Onboarding-Fehler.

Client-Setup

Ein-Klick-Installation (empfohlen):Olostep MCP Server zu Cursor hinzufügenErsetze <YOUR_API_KEY> in der resultierenden Konfiguration durch deinen echten Schlüssel.Manuelles Setup:Erstelle oder bearbeite .cursor/mcp.json in deinem Projektstamm (oder ~/.cursor/mcp.json für global):
Erfordert Node.js 18+ auf deinem Rechner.
Verifizieren: Öffne Cursor → Einstellungen → MCP. Du solltest olostep mit 8 Tools einschließlich scrape_website sehen. Wenn du “Verbunden, 0 Tools” siehst, ist dein API-Schlüssel falsch.

Das richtige Tool auswählen

Der MCP-Server stellt 8 Tools bereit. Verwende diesen Entscheidungsbaum, um das richtige auszuwählen — der Agent verwendet die gleiche Logik:
Eine ganze Seite scrapen? Verwende create_crawl, nicht batch_scrape_urls. Crawl entdeckt UND scrapet. Batch ist für eine bekannte Liste von URLs, die du bereits hast.

Tool-Details

Extrahiere Inhalte von einer einzelnen URL. Unterstützt markdown, html, json, text. Optional country für geo-targetierte Anfragen, wait_before_scraping (0–10000 ms) für JS-lastige Seiten und parser (z.B. @olostep/amazon-product) für strukturierte Extraktion. Seiteninhalt ist auf max_characters (Standard 20.000) begrenzt; längere Seiten werden abgeschnitten und das Ergebnis sagt dies.
Websuche, wenn du noch keine URL hast. Gibt bis zu limit Ergebnisse zurück (1–25, Standard 10), jedes mit seiner URL, Titel und Beschreibung. Verwende include_domains / exclude_domains, um die Suche einzugrenzen. Setze scrape_results: true, um auch den Inhalt jeder Ergebnis-Seite als Markdown im gleichen Aufruf zu erhalten (begrenzt auf max_characters, Standard 20.000; jede gescrapete Seite verbraucht zusätzliche Credits).
KI-gestützte Antwort auf eine task mit Quellen und Zitaten. Übergebe ein json-Argument, um die Antwort in einer bestimmten Form zu erhalten — entweder ein JSON-Schema oder eine kurze natürliche Sprachbeschreibung.
Asynchrones Scraping von 2–100k URLs, die du bereits hast. Gibt eine batch_id zurück — dann rufe get_batch_results auf, um Inhalte abzurufen. Setze wait_for_completion_seconds (bis zu 900), wenn du einen einzigen blockierenden Aufruf anstelle von Abfragen möchtest. Empfohlen: 60 für Batches unter 50 URLs, 300–600 für 50–1k, 0 (separat abfragen) für größere Batches.
Ruft den Status und den gescrapeten Inhalt für eine batch_id ab. Gibt processing zurück, bis abgeschlossen, dann completed mit dem Element-Array.
Asynchrones Crawling, das Links von einer start_url folgt. Verwende include_url_patterns / exclude_url_patterns (Glob-Syntax wie /blog/**), um den Umfang festzulegen. Gibt eine crawl_id zurück — dann rufe get_crawl_results auf.
Ruft den Status und die Seiten für eine crawl_id ab. Unterstützt Pagination über cursor und items_limit (max. 100 pro Aufruf). Gibt in_progress zurück, bis abgeschlossen.
Erhalte eine Liste von URLs auf einer Seite. Nur URL-Entdeckung — kein Scraping. Verwende dies, wenn du Kandidaten-URLs anzeigen möchtest (z.B. dem Benutzer erlauben, eine Teilmenge auszuwählen). Unterstützt include_url_patterns / exclude_url_patterns und search_query.

Fehlerbehebung

Dein API-Schlüssel ist ungültig oder rate-limitiert. Öffne das API-Schlüssel-Dashboard und überprüfe den Schlüssel. Wenn du den gehosteten Endpunkt verwendest, muss der Header genau Authorization: Bearer sk_... sein — keine Anführungszeichen um den Wert, keine zusätzlichen Leerzeichen.
Node.js ist nicht installiert (oder nicht in deinem PATH). Installiere Node 18+ von nodejs.org, dann starte dein Terminal und deinen MCP-Client neu. Unter Windows wechsle zu einem CMD/PowerShell, das Node im PATH hat.
Du befindest dich wahrscheinlich hinter einem Unternehmensproxy oder einer Firewall, die den Host blockiert. Wechsle zur lokalen stdio-Installation (npx -y olostep-mcp) — sie stellt ausgehende Anfragen an api.olostep.com, was normalerweise erlaubt ist.
Der Client hat die alte Konfiguration zwischengespeichert. Vollständig beenden und neu starten — nicht nur das Fenster schließen. Claude Desktop bleibt insbesondere in der Menüleiste/System Tray aktiv.
Wenn npx beim Starten des Servers unter Windows Fehler ausgibt, verwende die CMD-umwickelte Form:
Du hast den gehosteten Endpunkt ohne Auth-Header (oder mit falschem Format) aufgerufen. Füge den Header deiner Client-Konfiguration genau so hinzu, wie im Setup-Tab gezeigt.

Rezepte

Copy-Paste-Prompts, die gut mit den Tools funktionieren:
  • Eine Liste von Produkt-URLs scrapen: “Ich habe eine CSV mit 200 Amazon-Produkt-URLs. Batch scrape sie mit parser=@olostep/amazon-product und gib sie als JSON zurück.”
  • Eine Dokumentationsseite crawlen: “Crawl https://stripe.com/docs mit max_pages=50 und include_url_patterns=['/docs/**']. Fasse jeden Abschnitt als Markdown zusammen.”
  • Wettbewerber finden: “Verwende answers, um die Top 5 Wettbewerber von Notion für technische Dokumentationsseiten zu finden. Gib Name, Homepage und 1-Zeilen-Positionierung zurück.”
  • Karte erstellen und dann scrapen: “Führe create_map auf https://example.com gefiltert auf /blog/** aus, dann batch_scrape_urls auf den Top 20 Ergebnissen.”

Quelle & Versionen