> ## Documentation Index > Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Data Hub MCP: Werkzeugreferenz > Referenz zu den sechs stabilen Tools des allgemeinen Data Hub-MCP und zum Standardablauf für das Suchen, Ausführen und Abrufen von Data-App-Ergebnissen. Diese Seite beschreibt das **allgemeine Data Hub-MCP**. Es hilft einem Agenten zuerst, eine passende Data App zu finden, liest dann den aktuellen Vertrag der App und führt sie aus. Es nutzt dieselben Data Hub-Funktionen wie die Tutorials „zuerst eine bestimmte App wählen, dann verbinden“. Der einzige Unterschied ist der Zeitpunkt der App-Auswahl. Anzahl, Namen, Herausgeber, Preise, Ein- und Ausgaben der Data Apps ändern sich laufend. Die MCP-Protokoll-Tools sind vergleichsweise stabil. Diese Seite konzentriert sich daher auf die Tool-Verträge und den allgemeinen Ablauf und behandelt keinen Katalog-Schnappschuss als dauerhafte Liste. ## Zwei Funktionsebenen | Ebene | Inhalt | Verwendung | | ------------------ | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | **Protokollebene** | Sechs Tools: suchen, Details abrufen, ausführen, Status abrufen, Ergebnis abrufen und Lauf abbrechen | Ein stabiler Ablauf für die Integration durch Agenten oder Systeme | | **Datenebene** | Funktion, Preis, Felder, Sichtbarkeit und Laufmodus jeder Data App | Vor jedem Aufruf aktuell suchen und die Details lesen | Für eine dauerhafte Integration mit einer festen App notieren Sie deren `app_id`. Auch `namespace/app_name` referenziert eine App, kann aber ungültig werden, wenn Herausgeber oder App umbenannt werden. ## Die sechs MCP-Tools ### `search_data_apps`: den Katalog durchsuchen Data Apps mit geschäftlichen Stichwörtern entdecken. `query` akzeptiert Stichwörter in jeder Sprache. Lassen Sie es leer, um durch den für Sie sichtbaren Katalog zu blättern. Sie können auch mit `type` nach Erfassungs- oder Abfrage-Apps (`data`) und Verarbeitungs-Apps (`transform`) filtern und mit `scope` zwischen `all`, `public`, `private` oder `shared` wählen. | Parameter | Beschreibung | | ----------------- | ---------------------------------------------------------------------- | | `query` | Optionale geschäftliche Stichwörter. Listet den Katalog auf, wenn leer | | `type` | Optional: `data` oder `transform` | | `scope` | Optionaler Sichtbarkeitsbereich, Standard `all` | | `offset`, `limit` | Blättern. `limit` ist `1-20`, Standard `5` | Jede Ergebniskarte enthält `app_id`, Name, Zusammenfassung, Laufmodus (`sync` / `async`), Hinweise zu Ein- und Ausgabe, Startpreis und Sichtbarkeit. Zuerst suchen und vergleichen. Nicht vor der Bestätigung ausführen. ### `get_data_app_details`: den vollständigen Vertrag lesen Rufen Sie dies vor dem Ausführen auf. Übergeben Sie eine `app_id` oder `/`, um Folgendes zu erhalten: * `input_schema`: das Standard-JSON-Schema, das dieser Lauf erfüllen muss. * `output_schema`: die Felder, die zurückgegeben werden können. * `knowledge`: Funktionsgrenzen, erwartete Latenz und Hinweise. * `pricing`: Beschreibung der Abrechnung. * `examples`: Beispieleingaben als Ausgangspunkt. Am sichersten ist es, ein `input` aus `examples` zu kopieren und anzupassen. Raten Sie Feldnamen nicht aus dem Seitentitel, Chat-Beschreibungen oder alten Aufgaben. ### `run_data_app`: einen Lauf starten Übergeben Sie `app`, ein `input`, das dem `input_schema` entspricht, und bei Bedarf `max_records`, um die Anzahl der Ergebnisse zu begrenzen. Wenn die Eingabe nicht zum Vertrag passt, gibt das Tool sofort `[invalid-input]` zurück und benennt das problematische Feld. Gängige Rückgabewerte sind `run_id`, `state`, `progress`, `usage`, `billing` und `next_step`. Verwenden Sie beim ersten Versuch ein kleines `max_records`, um Daten, Dauer und Kosten zu prüfen. ### `get_run_status`: den Laufstatus prüfen Übergeben Sie eine `run_id`, um Fortschritt, Fehlerdetails, Nutzung und Kosten zu prüfen, ohne Daten zu lesen. Bei asynchronen Aufgaben nutzen Sie `wait_seconds` (`0-60`) für Long Polling. Warten Sie 60 Sekunden pro Aufruf, statt ohne Pause schnell abzufragen. Gängige Zustände sind `QUEUED`, `RUNNING`, `SUCCEEDED`, `PARTIALLY_SUCCEEDED`, `FAILED` und `CANCELLED`. Sehen Sie sich bei einem Fehler `error.code`, `error.category`, `error.message` und `error.retryable` an. ### `get_run_result`: Ergebnisse lesen Liest höchstens 50 Datensätze pro Aufruf. Blättern Sie mit `offset` und fordern Sie mit `fields` eine kommagetrennte Teilmenge der Felder an, etwa `title,price,url`, damit unnötige große Felder die Unterhaltung nicht überfluten. Wenn die Antwort ein `handoff` enthält, ist das Ergebnis groß oder für weiteres Blättern in der Unterhaltung ungeeignet. Folgen Sie dem SDK- oder REST-Befehl im `handoff`, um eine Datei zu exportieren, statt den Agenten das vollständige JSON wiederholt bewegen zu lassen. ### `cancel_run`: einen Lauf abbrechen Übergeben Sie eine `run_id`, um eine wartende oder laufende Aufgabe abzubrechen. Eine laufende Aufgabe braucht möglicherweise einige Sekunden, um kooperativ zu stoppen. Bereits erzeugte Teilergebnisse bleiben erhalten und können weiterhin mit `get_run_result` gelesen werden. Berechnet werden nur die erzeugten Daten. ## Standardablauf ```text theme={null} theme={null} search_data_apps → get_data_app_details → run_data_app → get_run_status (nur async, Long Polling) → get_run_result → cancel_run (wenn Sie abbrechen müssen) ``` ### Synchrone und asynchrone Apps | Laufmodus | Verhalten | Empfehlung | | --------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | `sync` | Abschluss in Sekunden. Kleine Ergebnisse können `records` direkt zurückgeben | Zuerst die Rückgabe prüfen, dann mit `next_step` fortfahren | | `async` | Gibt sofort eine `run_id` zurück und führt die eigentliche Extraktion im Hintergrund aus | Mehrere Ziele nacheinander einreichen, dann mit `get_run_status(wait_seconds=60)` warten | Der Erhalt einer `run_id` für eine asynchrone Aufgabe bedeutet nicht, dass die Extraktion erfolgreich war. Bestätigen Sie den Endzustand, bevor Sie Ergebnisse lesen, und reichen Sie dasselbe Ziel nicht wegen der Wartezeit erneut ein. ## Umgang mit Data Apps Data Apps sind die konkreten Datenfunktionen auf Data Hub. Es kommen neue hinzu und bestehende ändern sich, deshalb führt diese Seite keine feste Liste. Suchen Sie vor der Nutzung mit `search_data_apps` und bestätigen Sie die aktuellen Ein- und Ausgaben, den Preis und die Grenzen mit `get_data_app_details`. ## Hinweise zu Verbindung und Nutzung * **App noch nicht gewählt**: Folgen Sie Allgemeine Verbindung: eine App im Agenten wählen, um zuerst das Data Hub-MCP zu verbinden und dann zu suchen, zu vergleichen und zu bestätigen. * **Feste App dauerhaft im Einsatz**: Nutzen Sie Codex: eine bestimmte App verbinden oder Claude Code: eine bestimmte App verbinden, um den Tool-Umfang einzuschränken. * **Kosten oder große Datenmengen im Spiel**: Rufen Sie zuerst das Detail-Tool auf, um `pricing` und `examples` zu prüfen, testen Sie mit einer kleinen Datenmenge und behandeln Sie das `handoff`, wenn Sie ein großes Ergebnis brauchen. Das allgemeine Data Hub-MCP basiert auf `https://mcp-v2.octoparse.com` und unterstützt API-Schlüssel oder OAuth. Verbindungskonfiguration und aktuelle Parameter sind das, was die Data Hub Open Platform erzeugt. Es unterscheidet sich vom Octoparse-Scraping-MCP Server in der oberen Navigation. Vermischen Sie nicht deren Adressen, Authentifizierung oder Tool-Namen.