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 unterhttps://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
- Cursor
- Claude Code
- Claude Desktop
- VS Code
- Windsurf
- Docker
- Metorial
Ein-Klick-Installation (empfohlen):
Ersetze
Erfordert Node.js 18+ auf deinem Rechner.Verifizieren: Öffne Cursor → Einstellungen → MCP. Du solltest
Ersetze <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):Lokale stdio-Installation (optional)
Lokale stdio-Installation (optional)
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:Tool-Details
scrape_website
scrape_website
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.search_web
search_web
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).answers
answers
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.batch_scrape_urls
batch_scrape_urls
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.get_batch_results
get_batch_results
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.create_crawl
create_crawl
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.get_crawl_results
get_crawl_results
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.create_map
create_map
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
Server erscheint, zeigt aber 0 Tools
Server erscheint, zeigt aber 0 Tools
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.npx: command not found oder command not found: olostep-mcp
npx: command not found oder command not found: olostep-mcp
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.
Verbindung verweigert oder DNS-Fehler bei mcp.olostep.com
Verbindung verweigert oder DNS-Fehler bei mcp.olostep.com
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.Bearbeitete Konfiguration, aber die Tool-Liste ist veraltet
Bearbeitete Konfiguration, aber die Tool-Liste ist veraltet
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.
Windows-spezifische npx-Fehler
Windows-spezifische npx-Fehler
Wenn
npx beim Starten des Servers unter Windows Fehler ausgibt, verwende die CMD-umwickelte Form: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-productund gib sie als JSON zurück.” - Eine Dokumentationsseite crawlen: “Crawl https://stripe.com/docs mit
max_pages=50undinclude_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_mapauf https://example.com gefiltert auf/blog/**aus, dannbatch_scrape_urlsauf den Top 20 Ergebnissen.”