Scrapling mit Claude Code: Aus Webseiten werden Excel-Dateien

Worum es geht

Preise von Lieferanten vergleichen, Stellenanzeigen sammeln, Anbieterlisten aufbauen – meist heißt das: Webseite öffnen, abtippen, nächste Webseite. Scrapling ist ein Werkzeug, das Webseiten öffnet und deren Inhalte ausliest. Als MCP-Server (eine Schnittstelle, über die Claude Code Werkzeuge bedienen kann) wird es zu einem Helfer, dem du nur noch sagst, welche Informationen du brauchst. Claude öffnet die Seiten, sammelt die Daten und erstellt eine fertige Excel-Datei mit formatierter Kopfzeile, Filtern und anklickbaren Links.

Die Einrichtung übernimmt Claude Code selbst. Du kopierst einen Prompt, bestätigst die Befehle, startest einmal neu. Danach brauchst du keine Terminalbefehle mehr.

Für wen das sinnvoll ist

Einkauf und Vertrieb, die regelmäßig Produkt- oder Lieferantenvergleiche brauchen.
Personalabteilungen, die Stellenanzeigen oder Gehaltsangaben zusammentragen.
Alle, die Daten aus mehreren Webseiten in einer Tabelle haben wollen, ohne Programmierkenntnisse.

Voraussetzungen: Claude Code ist installiert, Python 3.10 oder neuer ebenfalls. Nicht sicher? Claude prüft beides beim Start. Wer selbst nachsehen will, tippt claude --version und python3 --version (Windows: python --version) ins Terminal.

So gehst du vor

Projektordner anlegen und Claude starten. In diesem Ordner landen später auch deine Excel-Dateien.

Terminal

mkdir webseiten-zu-excel
cd webseiten-zu-excel
claude

Einrichtungs-Prompt einfügen. Kopiere diesen Text vollständig in Claude Code und sende ihn ab. Claude bittet dich um Erlaubnis für einige Terminalbefehle – prüfen und bestätigen.

Prompt

Richte in diesem Projekt Scrapling vollständig für die Verwendung mit Claude Code ein.

Wichtig:
Führe die Einrichtung selbstständig über das Terminal durch. Erkläre mir nicht nur die einzelnen Befehle, sondern führe sie nach meiner Freigabe tatsächlich aus.

Arbeite in dem Ordner, in dem Claude Code aktuell geöffnet ist.

Gehe in dieser Reihenfolge vor:

1. Erkenne mein Betriebssystem.

2. Prüfe, ob Claude Code verfügbar ist.

3. Prüfe, ob Python 3.10 oder neuer verfügbar ist.
Verwende unter Windows je nach Installation `python` oder `py`.
Verwende unter macOS und Linux je nach Installation `python3` oder `python`.

4. Falls eine Voraussetzung fehlt, nenne mir nur:
- was fehlt,
- welchen einzelnen Installationsschritt ich ausführen muss,
- wie ich danach fortfahren kann.

5. Falls alle Voraussetzungen vorhanden sind, erstelle im aktuellen Projektordner eine lokale virtuelle Python-Umgebung mit dem Namen `.venv`.

6. Verwende ab diesem Punkt ausschließlich Python und Pip aus dieser `.venv`.
Verändere nicht die globale Python-Installation.

7. Aktualisiere Pip innerhalb der `.venv`.

8. Installiere innerhalb der `.venv`:
- `scrapling[ai]`
- `openpyxl`

9. Installiere danach über die Scrapling-Datei aus der `.venv` die benötigten Browser-Komponenten mit:
`scrapling install`

10. Ermittle automatisch den vollständigen absoluten Pfad zur ausführbaren Scrapling-Datei innerhalb der `.venv`.

11. Prüfe mit `claude mcp --help`, welche MCP-Befehle in meiner installierten Claude-Code-Version verfügbar sind.

12. Prüfe, ob bereits ein MCP-Server mit dem Namen `ScraplingServer` eingetragen ist.

13. Falls ein alter oder fehlerhafter Eintrag vorhanden ist, aktualisiere oder entferne ihn mit den verfügbaren Claude-Code-MCP-Befehlen.

14. Registriere anschließend Scrapling mit dem vollständigen absoluten Pfad als MCP-Server.

Das gewünschte Ergebnis entspricht sinngemäß:

`claude mcp add ScraplingServer "<vollständiger-pfad-zur-scrapling-datei>" mcp`

Verwende dabei den tatsächlich ermittelten Pfad und keinen Beispielpfad.

15. Prüfe danach mit den verfügbaren Claude-Code-Befehlen, ob `ScraplingServer` registriert ist.

16. Erstelle im aktuellen Projektordner einen Ordner mit dem Namen:

`output`

17. Erstelle außerdem eine Datei mit dem Namen:

`CLAUDE.md`

Schreibe dort folgende dauerhafte Projektregeln hinein:

- Wenn ich Informationen aus Webseiten sammeln möchte, verwende nach Möglichkeit den Scrapling-MCP-Server.
- Frage mich nicht nach CSS-Selektoren, solange du die benötigten Inhalte selbst erkennen kannst.
- Wenn ich eine Excel-Datei verlange, erstelle eine echte `.xlsx`-Datei mit OpenPyXL.
- Speichere fertige Dateien im Ordner `output`.
- Verwende verständliche Dateinamen.
- Nutze eine klar formatierte Kopfzeile.
- Aktiviere automatische Filter.
- Fixiere die oberste Tabellenzeile.
- Passe die Spaltenbreiten an den Inhalt an.
- Speichere URLs als anklickbare Hyperlinks.
- Formatiere Preise und Zahlen als echte Zahlenwerte.
- Formatiere Datumsangaben als echte Excel-Datumswerte.
- Verwende pro Datensatz eine Zeile.
- Verwende bei unterschiedlichen Kategorien bei Bedarf mehrere Tabellenblätter.
- Nenne mir nach der Erstellung immer den vollständigen Pfad zur fertigen Datei.
- Gib nicht nur eine Markdown-Tabelle im Chat aus, wenn ich ausdrücklich eine Excel-Datei verlange.

18. Erstelle eine kleine Testdatei mit OpenPyXL unter:

`output/excel-test.xlsx`

Die Testdatei soll enthalten:
- eine formatierte Kopfzeile,
- zwei Beispielzeilen,
- einen Filter,
- fixierte Kopfzeile,
- angepasste Spaltenbreiten,
- einen anklickbaren Link.

19. Prüfe, ob die Testdatei erfolgreich erstellt wurde.

20. Lösche die Testdatei nach erfolgreicher Prüfung wieder.

21. Fasse am Ende nur verständlich zusammen:
- ob Scrapling installiert wurde,
- ob die Browser-Komponenten installiert wurden,
- ob OpenPyXL funktioniert,
- ob ScraplingServer registriert wurde,
- welchen Ordner du für Excel-Dateien angelegt hast.

22. Falls Claude Code neu gestartet werden muss, sage mir deutlich:

„Die Einrichtung ist abgeschlossen. Beende Claude Code jetzt vollständig, öffne es erneut im selben Ordner und fahre anschließend mit dem Test-Prompt fort.“

Verändere keine Dateien außerhalb dieses Projektordners, außer der notwendigen Claude-Code-MCP-Konfiguration.

Installiere nichts global, wenn es innerhalb der lokalen `.venv` möglich ist.

Frage nur dann nach, wenn eine notwendige Berechtigung fehlt oder ein Installationsschritt ohne meine Entscheidung nicht fortgesetzt werden kann.

Beginne jetzt mit der Prüfung und Einrichtung.

Einmal neu starten. Beende Claude Code vollständig und starte es im selben Ordner mit claude erneut – erst dann lädt es den neuen Scrapling-Server.
Verbindung prüfen. Kommt die Antwort „Scrapling ist bereit.", ist die Einrichtung durch.

Prompt

Prüfe, ob der ScraplingServer verfügbar ist. Antworte nur mit:

„Scrapling ist bereit.“

Falls er nicht verfügbar ist, prüfe die MCP-Konfiguration und behebe den Eintrag selbstständig.

Erste Excel-Datei erstellen. Ab hier beschreibst du nur noch das Ergebnis.

Prompt

Nutze Scrapling und öffne die folgenden Webseiten:

[Links hier einfügen]

Erstelle daraus eine Excel-Datei mit diesen Spalten:
- Name
- Preis
- Anbieter
- Beschreibung
- Link

Speichere die fertige Datei im Ordner `output` als `vergleich.xlsx`.

Verwende pro Ergebnis eine Zeile.
Entferne doppelte Einträge.
Formatiere die Kopfzeile.
Aktiviere Filter.
Fixiere die oberste Zeile.
Passe die Spaltenbreiten an.
Speichere die Links als anklickbare Hyperlinks.

Nenne mir anschließend den vollständigen Pfad zur Excel-Datei.

Vorlagen für den Alltag

Du kannst auch ganz normal schreiben. Die Formatierung steht in den Projektregeln, darum musst du dich nicht kümmern.

Prompt

Vergleiche diese Produktseiten und erstelle mir eine Excel-Datei mit Preis, Versand, Lieferzeit und Link:

[Links einfügen]

Prompt

Sammle diese Stellenanzeigen in einer Excel-Datei. Ich brauche Unternehmen, Position, Arbeitsort, Gehalt, Anforderungen und Bewerbungslink:

[Links einfügen]

Prompt

Vergleiche diese Wohnungen in Excel. Verwende Kaltmiete, Warmmiete, Größe, Zimmer, Stadtteil und Link:

[Links einfügen]

Prompt

Erstelle aus diesen Anbieterseiten eine Excel-Datei mit Anbieter, Produkt, Preis, Mindestmenge, Lieferzeit und Kontakt:

[Links einfügen]

Prompt

Öffne diese Webseiten:

[Links einfügen]

Erstelle eine Excel-Datei mit:
- [gewünschte Spalte]
- [gewünschte Spalte]
- [gewünschte Spalte]

Stolpersteine

Für jeden Fall ein Prompt.

Claude erklärt nur, führt aber nicht aus:

Prompt

Führe die beschriebenen Installationsschritte jetzt selbst über das Terminal aus. Erkläre sie nicht erneut. Bitte mich nur um die notwendigen Berechtigungen.

ScraplingServer ist nach dem Neustart nicht verfügbar:

Prompt

Prüfe die aktuelle MCP-Konfiguration von Claude Code.

Finde den vollständigen Scrapling-Pfad in der lokalen `.venv`, repariere den Eintrag `ScraplingServer` und prüfe anschließend die Verbindung.

Claude zeigt nur eine Tabelle im Chat:

Prompt

Erstelle daraus jetzt eine echte `.xlsx`-Datei mit OpenPyXL.

Speichere sie im Ordner `output` und nenne mir den vollständigen Dateipfad.

Eine Seite wird nicht richtig geladen:

Prompt

Versuche die Webseite erneut mit dem browserbasierten Werkzeug von Scrapling zu öffnen. Warte, bis die sichtbaren Inhalte geladen wurden, und erstelle danach die Excel-Datei.

Die Excel-Datei ist unübersichtlich:

Prompt

Überarbeite die Excel-Datei.

Formatiere die Kopfzeile, aktiviere Filter, fixiere die erste Zeile, passe die Spaltenbreiten an und speichere URLs als anklickbare Links.

Werkzeuge und Kosten

Scrapling und OpenPyXL werden als Python-Pakete in eine lokale .venv installiert, die globale Python-Installation bleibt unangetastet. Dazu brauchst du Claude Code und Python 3.10 oder neuer. Nach der einmaligen Einrichtung fallen keine weiteren Befehle an – du schreibst nur noch, welche Webseiten geöffnet werden sollen, welche Spalten du möchtest und wie die Datei heißen soll.