Skip to main content
Nutzen Sie dieses Tutorial, wenn Sie noch nicht wissen, welche Data App Sie verwenden möchten, oder wenn der Agent für jede Aufgabe selbst eine Funktion finden soll. Die allgemeine Verbindung fügt Ihrem Agenten die Data Hub-Tools zum Suchen und Ausführen hinzu. Nach der Verbindung beschreiben Sie die benötigten Daten, und der Agent sucht eine passende Data App, prüft ihre Parameter und führt sie nach Bestätigung aus.
Die allgemeine Verbindung erfordert keine vorherige App-Auswahl. Dieses Tutorial und die Tutorials „Codex: eine bestimmte App verbinden“ und „Claude Code: eine bestimmte App verbinden“ sind zwei unterschiedliche Nutzungsmuster. Eine Verbindung zu einer bestimmten App passt zu einer klaren, dauerhaft festen Funktion. Die allgemeine Verbindung passt zu wechselnden Anforderungen oder wenn die App noch nicht gewählt ist.

​
Die zwei Verbindungsmethoden verstehen

Beide Methoden rufen dieselben Data Apps auf Data Hub auf. Der einzige Unterschied ist, wo Sie die App wählen. Sie können beide Verbindungsarten behalten, sollten ihnen aber erkennbare Namen geben, damit der Agent nicht das falsche Tool wählt.

​
Was Sie danach tun können

Nach diesem Tutorial können Sie in Ihrem Agenten der Reihe nach:
  1. Data Apps nach Stichwort, Plattform oder Szenario suchen.
  2. Zweck, Eingabeparameter, Ausgabefelder und Abrechnung einer App prüfen.
  3. App und Parameter bestätigen und dann einen Lauf starten.
  4. Den Status einer asynchronen Aufgabe prüfen und das Endergebnis abrufen.
Die vollständigen Parameter und Verarbeitungsregeln für search_data_apps, run_data_app, asynchrone Statusabfragen und das handoff für große Ergebnisse finden Sie unter Data Hub-MCP-Funktionen. Diese Seite konzentriert sich auf Verbindung und erste Nutzung.

​
Bevor Sie beginnen

Halten Sie Folgendes bereit:
  • Ein Octoparse-Konto, mit dem Sie sich anmelden können.
  • Einen Agenten-Client, der Streamable HTTP MCP unterstützt, etwa Claude Code, Codex oder Cursor.
  • Falls Sie die API-Schlüssel-Methode wählen: vorab einen Octoparse-API-Schlüssel erstellen.
  • Ein einfaches Datenziel zum Testen, etwa „finde eine Data App, die Unternehmensinformationen anreichern kann“.
Ein API-Schlüssel ist ein Kontozugangsdatum. Legen Sie einen echten Schlüssel nie in ein Code-Repository, eine geteilte Konfiguration, einen öffentlichen Screenshot oder einen Gruppenchat. Kopieren Sie im OAuth-Modus nie ein temporäres Zugriffstoken aus einer Browsersitzung in eine lokale Konfiguration.

​
Schritt 1: die allgemeine MCP-Verbindung öffnen

1

Zur Data Hub Open Platform gehen

Melden Sie sich auf der Octoparse-Website an, öffnen Sie oben das Menü Data Hub und klicken Sie auf Data Hub Open Platform.
2

MCP connection öffnen

Klicken Sie in der linken Navigation der Open Platform auf MCP connection, um die Seite Data Hub MCP Server zu öffnen. Das auf der Seite angezeigte Standard-Toolset kann jede Data App auf Data Hub suchen und ausführen. Sie müssen vorher keine App im Katalog wählen.
Auch der Abschnitt Integration jeder Data App enthält unten einen Link zur MCP-Verbindung, der hierher führt. Dieser Link ist eine Abkürzung. Er bedeutet nicht, dass Sie diese App zuerst wählen müssen.

​
Schritt 2: eine Authentifizierungsmethode wählen

Die allgemeine Verbindung unterstützt sowohl API-Schlüssel als auch OAuth. Die Wahl betrifft nur die Authentifizierung. Sie ändert nicht, wie Data Apps gesucht oder ausgeführt werden.

​
Option 1: API-Schlüssel (empfohlen)

Ideal für dauerhafte, stabile Nutzung, Kommandozeilen-Clients und Automatisierung. Die von der Seite erzeugte Konfiguration enthält:
Bearer ist lediglich das Header-Format, in dem der API-Schlüssel übergeben wird. Verwenden Sie einen Octoparse-API-Schlüssel, kein temporäres Zugriffstoken aus einer angemeldeten Browsersitzung. Wenn Sie noch keinen Schlüssel haben, erstellen Sie einen im Octoparse-Kontocenter. Ein API-Schlüssel wird meist nur einmal vollständig angezeigt, nämlich bei der Erstellung. Speichern Sie ihn in einem vertrauenswürdigen Passwortmanager.

​
Option 2: Anmeldung per OAuth

Ideal für interaktive Clients, die MCP OAuth unterstützen. Wenn Sie OAuth wählen, enthält die Konfiguration keinen API-Schlüssel. Beim ersten Verbinden öffnet der Client einen Browser, in dem Sie sich bei Octoparse anmelden und die Autorisierung bestätigen. Die Sitzung kann ablaufen, dann autorisieren Sie erneut.

​
Schritt 3: den allgemeinen Installations-Prompt kopieren

Wählen Sie auf der Seite MCP connection Ihren Agenten-Client und die Authentifizierungsmethode und klicken Sie dann auf Copy install prompt. Copy MCP URL liefert nur die Serveradresse. Kopieren Sie den vollständigen Inhalt, den die Seite gerade erzeugt. Tippen Sie Serveradresse, Tool-Umfang oder Header nicht aus dem Gedächtnis.
Die auf der Seite angezeigte allgemeine Serveradresse basiert auf https://mcp-v2.octoparse.com. Die genaue Konfiguration und die Tool-Parameter können sich ändern, verwenden Sie daher immer das, was die Open Platform aktuell erzeugt.

​
Schritt 4: den Agenten die Konfiguration abschließen lassen

Das folgende Beispiel verwendet Claude Code. Codex und Cursor platzieren die Schaltflächen anders, aber die Kernschritte sind gleich: Installations-Prompt einfügen, Authentifizierungsmethode wählen, Änderungen an der MCP-Konfiguration des aktuellen Benutzers erlauben, dann den Client neu laden.
1

Den Installations-Prompt an den Agenten senden

Starten Sie eine neue Unterhaltung und fügen Sie den vollständigen kopierten Prompt ein. Der Agent sollte vor dem Schreiben der Konfiguration nach der Authentifizierungsmethode fragen. Wenn er versucht, Zugangsdaten in eine Projektdatei zu schreiben, stoppen Sie ihn und verlangen Sie stattdessen die lokale MCP-Konfiguration des aktuellen Benutzers.
2

Die Authentifizierungsmethode bestätigen

Wenn Sie den API-Schlüssel gewählt haben, geben Sie ihn sicher an, sobald der Agent fragt. Wenn Sie OAuth gewählt haben, geben Sie keinen Schlüssel an und lassen Sie den Agenten eine Konfiguration ohne Zugangsdaten schreiben.
3

Den Client neu laden

Laden Sie nach der Konfiguration die MCP-Server neu oder starten Sie den Client neu. Bei OAuth kann die erste Verbindung „Authentifizierung erforderlich“ anzeigen. Das ist erwartet.

​
Schritt 5: die OAuth-Autorisierung abschließen (nur OAuth)

Wenn Sie den API-Schlüssel gewählt haben, springen Sie zum nächsten Schritt.
1

Die Verbindung im Client auslösen

Führen Sie in Claude Code /mcp aus und wählen Sie den gerade hinzugefügten Data Hub-Server, standardmäßig octoparse_datahub genannt. Wenn angezeigt wird, dass eine Authentifizierung nötig ist, wählen Sie die Authentifizierung. Andere Clients zeigen in ihren MCP-Einstellungen eine Schaltfläche Connect oder ähnlich.
2

Im Browser anmelden und autorisieren

Der Browser öffnet die Identitätsseite von Octoparse. Prüfen Sie Domain und aktuelles Konto, lesen Sie den angeforderten Umfang und bestätigen Sie. Folgen Sie der Aufforderung auf der Seite, um zum Client zurückzukehren. Manche Clients kehren automatisch zurück.
3

Bestätigen, dass der Server aktiviert ist

Prüfen Sie zurück im Client, dass der Zustand „Authentifizierung erforderlich“ verschwunden ist und der Server aktiviert ist. Wenn er weiterhin als nicht authentifiziert angezeigt wird, laden Sie den Client neu und versuchen Sie es erneut.

​
Schritt 6: zuerst suchen, noch nicht ausführen

Der Kern der allgemeinen Verbindung ist, dass der Agent zuerst Data Apps entdeckt. Bitten Sie ihn bei der ersten Nutzung ausdrücklich, nur zu suchen und zu vergleichen und noch keine kostenpflichtige Aufgabe anzulegen. Zum Beispiel:
Der Agent ruft meist search_data_apps auf, um den Katalog zu durchsuchen, und dann get_data_app_details, um den vollständigen Vertrag jedes Kandidaten zu lesen.
Anzahl, Namen und Plattformabdeckung der Apps, die ein Agent findet, ändern sich in Echtzeit mit dem Data Hub-Katalog. Diese Dokumentation liefert keine feste Liste. Verlassen Sie sich auf das, was search_data_apps tatsächlich zurückgibt.

​
Schritt 7: die App bestätigen, dann ausführen

Wählen Sie eine App aus den Kandidaten. Lassen Sie den Agenten die Parameter und geplanten Aktionen wiedergeben und dann einen kleinen Test ausführen:
1

Eingaben und Kosten prüfen

Bestätigen Sie Pflichtparameter, Datenumfang, zurückgegebene Felder und Abrechnungseinheit. Wenn etwas unklar ist, lassen Sie den Agenten das Detail-Tool erneut aufrufen, statt Parameter zu raten.
2

Einen kleinen Test ausführen

Erst nach der Bestätigung lassen Sie den Agenten run_data_app aufrufen. Eine synchrone App liefert Ergebnisse direkt. Eine asynchrone App braucht anschließende Statusabfragen.
3

Asynchrone Ergebnisse abrufen

Lassen Sie den Agenten bei asynchronen Aufgaben mit den Status- und Ergebnis-Tools auf den Abschluss warten und dann die endgültigen Daten zurückgeben. Behandeln Sie „Aufgabe eingereicht“ nicht als erfolgreiche Extraktion.
4

Die Ergebnisse prüfen

Prüfen Sie Aufgabenstatus, tatsächliche Anzahl der Datensätze und Schlüsselfelder. Ein fehlendes Feld in einem einzelnen Datensatz kann an Unterschieden in den Quelldaten liegen. Wenn die meisten Datensätze nicht den Erwartungen entsprechen, wechseln Sie die App oder passen Sie die Parameter an.

​
FAQ

Nein. Die allgemeine Verbindung stellt zuerst die Such- und Ausführungs-Tools bereit. Nach der Verbindung nutzt der Agent search_data_apps, um Funktionen zu finden. Nur die Verbindung zu einer bestimmten App erfordert, zuerst eine App im Katalog zu wählen.
Bevorzugen Sie den API-Schlüssel für dauerhafte Nutzung, Kommandozeilen-Clients und Automatisierung. Wählen Sie OAuth, wenn Sie sich über den Browser anmelden möchten und Ihr Client MCP OAuth ausdrücklich unterstützt. OAuth-Sitzungen können ablaufen und eine erneute Autorisierung erfordern.
Prüfen Sie, dass Sie die allgemeine Konfiguration von der Seite MCP connection der Open Platform verwendet haben, nicht die eingeschränkte Konfiguration einer bestimmten App. Kopieren Sie den aktuellen Prompt erneut und laden Sie den Client neu.
Lösen Sie die Verbindung in den MCP-Einstellungen des Clients aus, schließen Sie Anmeldung und Autorisierung im Browser ab und kehren Sie zum Client zurück. Prüfen Sie, ob der Browser die Weiterleitung blockiert hat, und stellen Sie sicher, dass die Autorisierungsseite zum offiziellen Identitätsdienst von Octoparse gehört.
Schreiben Sie „nur suchen und vergleichen, noch nicht ausführen“ ausdrücklich in den Prompt. Wenn Kosten oder große Datenmengen im Spiel sind, bitten Sie den Agenten, vor dem Aufruf von run_data_app auf die Bestätigung zu warten.
Die App ist wahrscheinlich asynchron. Lassen Sie den Agenten den Aufgabenstatus weiter prüfen und die Ergebnisse nach Abschluss abrufen. Reichen Sie dieselbe Aufgabe nicht erneut ein.

​
Checkliste

  • Sie haben den allgemeinen Installations-Prompt von der Seite MCP connection der Data Hub Open Platform kopiert.
  • Sie haben entweder API-Schlüssel oder OAuth gewählt und die beiden Zugangsdaten nicht vermischt.
  • Der Agent hat die allgemeinen Data Hub-Tools geladen und kann search_data_apps verwenden.
  • Sie haben gesucht und App-Details geprüft, bevor Sie einen Lauf bestätigt haben.
  • Sie haben einen echten Aufruf mit der kleinsten Datenmenge abgeschlossen und das Endergebnis geprüft.

​
Sie wissen schon, welche App Sie nutzen wollen?

Wenn Ihr Geschäft dauerhaft eine feste App nutzt, können Sie den Verbindungsumfang einschränken:

Codex: eine bestimmte App verbinden

Zuerst eine bestimmte App wählen, dann als festes Tool in Codex hinzufügen.

Claude Code: eine bestimmte App verbinden

Zuerst eine bestimmte App wählen, dann als festen MCP-Server in Claude Code hinzufügen.
Die tatsächliche Anzahl der Apps, ihre Namen, Herausgeber und Preise in einer Suche ändern sich mit dem Data Hub-Katalog. Verlassen Sie sich auf das, was das Tool bei jedem Aufruf zurückgibt.