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
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.
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 <namespace>/<app_name>, 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.
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
Synchrone und asynchrone Apps
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 mitsearch_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
pricingundexampleszu prüfen, testen Sie mit einer kleinen Datenmenge und behandeln Sie dashandoff, 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.