LionScraper MCP + CLI Dienst

Was ist das?

LionScraper ist eine Browser-Erweiterung, mit der Sie Listen, Artikel, Links, Bilder und mehr auf Webseiten erfassen können. Dieses Repository bietet den dazugehörigen MCP-Dienst: Sobald Sie ihn mit Ihrer KI-Software (z. B. Cursor) verbinden, können Sie die KI im Chat bitten, die Erweiterung für Sie zu steuern, anstatt jedes Menü manuell anzuklicken.

Man kann es sich wie eine „kleine Brücke“ vorstellen: Die KI-Software befindet sich auf der einen Seite, die Browser-Erweiterung auf der anderen, und dieser Dienst kümmert sich um die Kommunikation dazwischen. Die eigentliche Erfassungslogik findet in der Erweiterung statt; dieser Dienst dient lediglich der Verbindung und Weiterleitung.

Vorbereitung

1. Browser: Chrome oder Edge (je nachdem, was die Erweiterung unterstützt).

2. LionScraper-Erweiterung: Installieren und aktivieren Sie diese aus dem Browser-Store (der Name entspricht der Anzeige im Store).

3. Node.js: Auf Ihrem Computer muss Version 18 oder höher installiert sein. Falls noch nicht geschehen, können Sie das Installationspaket von der offiziellen Node.js-Website herunterladen und den Anweisungen folgen.

4. MCP-fähige KI-Software: Zum Beispiel Cursor, Trae usw. (je nachdem, ob die jeweilige Software MCP unterstützt).

Installation des MCP-Dienstes (npm-Paket)

Dieser Dienst wurde auf npm unter dem Namen lionscraper veröffentlicht. Sie können den Link aufrufen, um Details und Versionsinformationen einzusehen.

Öffnen Sie ein Terminal auf Ihrem Computer (unter Windows die „Eingabeaufforderung“ oder PowerShell) und führen Sie folgenden Befehl aus:

npm install -g lionscraper

Nach erfolgreicher Installation stehen Ihnen zwei Befehle zur Verfügung: lionscraper-mcp (für die Verbindung mit KI-Software) und lionscraper (Terminal-CLI). Beide hängen von demselben lokalen Daemon und der Brücke zur Erweiterung ab. Der PORT (Standard 13808) muss mit dem Brücken-Port in der Erweiterung übereinstimmen.

Falls Sie keine globale Installation wünschen, können Sie den Dienst auch temporär über npx in der MCP-Konfiguration Ihrer KI-Software abrufen (Node.js muss installiert sein). Beispiel-Ansatz: Setzen Sie den Startbefehl auf npx und die Parameter auf -y, -p, lionscraper, lionscraper-mcp (das genaue JSON-Format entnehmen Sie bitte der MCP-Konfigurationsanleitung Ihrer Software).

CLI (Terminal)

Bei einer globalen Installation können Sie lionscraper im Terminal für skriptbasierte Erfassungen oder parallel zum MCP verwenden (beide nutzen denselben lionscraper daemon und PORT):

• lionscraper daemon: Läuft im Hintergrund und stellt HTTP (CLI / einfache MCP-Aufrufe) sowie WebSocket (Verbindung zur Erweiterung) auf demselben Port bereit.

• lionscraper stop: Stoppt den Daemon auf dem konfigurierten Port.

• lionscraper ping: Überprüft, ob die Erweiterung an der Brücke registriert ist (ohne MCP-Dialog).

• lionscraper scrape: Startet die Erfassung; mit --method können Modi wie Liste/Text/E-Mail/Telefon/Link/Bild gewählt werden, entsprechend den MCP-Tool-Fähigkeiten.

Beispiel:

lionscraper daemon
lionscraper ping
lionscraper scrape -u https://www.example.com

Ausführlichere Parameterbeschreibungen, Informationen zu mehreren URLs, Paginierung und Filtern finden Sie im Repository unter packages/node/README_cn.md; die englische Version entspricht der npm-Seite: lionscraper-Paket auf npm.

MCP in KI-Software hinzufügen

Die folgenden Beispiele setzen eine globale Installation voraus (die Benutzeroberfläche der Software kann variieren). In MCP sind alle env-Werte Strings.

Einfache Konfiguration (wenn env weggelassen wird, ist der PORT standardmäßig 13808, muss mit dem Brücken-Port der Erweiterung übereinstimmen):

{
  "mcpServers": {
    "lionscraper": {
      "command": "lionscraper-mcp"
    }
  }
}

Detaillierte Konfiguration (Schlüssel können nach Bedarf entfernt werden; ein leerer String entspricht in etwa dem Weglassen des Schlüssels):

{
  "mcpServers": {
    "lionscraper": {
      "command": "lionscraper-mcp",
      "env": {
        "PORT": "13808",
        "TIMEOUT": "120000",
        "LANG": "zh-CN",
        "TOKEN": "",
        "DAEMON": ""
      }
    }
  }
}

• PORT: HTTP + WebSocket-Port, Standard 13808, muss mit dem Brücken-Port der Erweiterung übereinstimmen.

• TIMEOUT: Millisekunden, die gewartet werden soll, bis eine vorherige Instanz beendet wird, Standard 120000; 0 erzwingt eine sofortige Übernahme.

• LANG: Sprache für Tool-Beschreibungen und stderr-Logs (z. B. zh-CN, en-US).

• TOKEN: Bearer-Token, das mit dem Daemon übereinstimmt; leer lassen bedeutet keine Authentifizierung.

• DAEMON: Nur 0 deaktiviert das automatische Starten des Daemons durch das einfache MCP; leer lassen oder andere Werte verhalten sich wie das Weglassen.

Starten Sie nach dem Speichern der Konfiguration MCP oder die Software neu, damit die Änderungen wirksam werden.

Port in der Browser-Erweiterung abgleichen

1. Öffnen Sie die Einstellungen oder Optionen von LionScraper.

2. Suchen Sie den Brücken-Port (oder eine ähnliche Bezeichnung) und stellen Sie ihn auf denselben Wert wie den PORT in der MCP-Konfiguration (z. B. 13808).

3. Falls Sie den Port geändert haben oder Verbindungsprobleme auftreten, können Sie in der Erweiterung „Neu verbinden“ wählen; falls das nicht hilft, versuchen Sie, die Erweiterung neu zu laden oder den Browser neu zu starten.

Wie nutzt man es im Alltag?

1. Lassen Sie die Erweiterung aktiviert und stellen Sie sicher, dass die zu erfassende Seite im Browser geöffnet ist (oder folgen Sie den Anweisungen der Erweiterung).

2. Beschreiben Sie Ihren Bedarf in natürlicher Sprache im KI-Chat, zum Beispiel:

   • „Überprüfe zuerst, ob die LionScraper-Erweiterung verbunden ist.“

   • „Hilf mir, die Listendaten / den Artikeltext / E-Mails / Telefonnummern / Links / Bilder auf dieser Webseite zu erfassen.“

3. Die KI ruft die Erweiterung über MCP auf; falls eine Meldung über fehlende Verbindung oder Zeitüberschreitung erscheint, bitten Sie die KI, die Verbindung erneut zu prüfen, und stellen Sie sicher, dass der Port korrekt ist und die Erweiterung läuft.

Häufige Fragen

Frage: Meldung, dass die Erweiterung nicht verbunden ist oder die Erfassung fehlgeschlagen ist?

• Ist die Erweiterung geöffnet und nicht deaktiviert?

• Sind der in der KI konfigurierte Port und der Brücken-Port in der Erweiterung exakt identisch?

• Auf demselben Computer sollte im Hintergrund normalerweise nur eine Instanz dieses Dienstes mit der Erweiterung verbunden sein; wenn Sie mehrere MCP-Konfigurationen gleichzeitig verwenden oder das Paket mehrfach installiert haben, kann es zu Konflikten kommen.

Frage: Ich sehe in der KI bereits viele „Tools“, bedeutet das, dass die Verbindung steht?

Nicht unbedingt. Dass Tools sichtbar sind, bedeutet nur, dass die Verbindung zwischen KI und diesem Dienst steht; die Erweiterung muss sich zusätzlich mit demselben Port verbinden und registrieren.

MCP Registry und Verzeichnisse Dritter

Dieses Repository ist in der offiziellen MCP Registry mit zwei Paketen registriert (Metadaten-Dateiname jeweils server.json):

Schritte zur Veröffentlichung in der Registry (erfordert die offizielle CLI, siehe Quickstart):

1. Veröffentlichen Sie das npm / PyPI-Paket mit der Version, die in der jeweiligen server.json unter version angegeben ist (aktuell 1.0.3).

2. Wechseln Sie im Repository-Root in packages/node, führen Sie mcp-publisher login github aus (nur einmalig) und dann mcp-publisher publish.

3. Wechseln Sie dann in packages/python und führen Sie ebenfalls mcp-publisher publish aus (der Login kann übernommen werden).

Für Verzeichnisse Dritter gibt es keinen einheitlichen Zugang. Üblich ist die Einreichung über Glama mittels Add Server gemäß dem dortigen Prozess; Smithery richtet sich primär an öffentliches HTTPS + Streamable HTTP, was sich von der hier verwendeten Form (stdio + npm/pip-Installation) unterscheidet und ggf. ein alternatives Hosting erfordert.

Lizenz

MIT (entspricht der Erklärung des npm-Pakets lionscraper).