Scrapling mit Claude Code einrichten

Ein Prompt richtet alles für dich ein

Starte Claude Code, füge unseren Einrichtungs-Prompt ein und lass Claude die Installation übernehmen.

Nach der einmaligen Einrichtung schreibst du nur noch, welche Informationen du aus Webseiten benötigst. Claude sammelt die Daten und erstellt eine fertige Excel-Datei.

Ablauf ansehen
Ablauf
  1. 1Prompt kopieren
  2. 2Claude richtet Scrapling ein
  3. 3Claude Code neu starten
  4. 4Excel-Dateien erstellen

Ein Startbefehl, ein Prompt, ein Neustart. Mehr machst du nicht.

So funktioniert es
01 Du brauchst nur wenige Schritte Den Rest macht Claude
Schritt 1
📁

Ordner öffnen

Erstelle einen leeren Ordner für deine Webseiten- und Excel-Aufgaben.

Schritt 2
>_

Claude Code starten

Öffne Claude Code in diesem Ordner.

Schritt 3

Prompt einfügen

Kopiere den Einrichtungs-Prompt von dieser Seite und füge ihn in Claude Code ein.

Schritt 4

Befehle erlauben

Claude zeigt dir, welche Befehle ausgeführt werden. Bestätige sie und starte Claude Code anschließend einmal neu.

i

Du musst keine Installationspfade suchen und keine Konfigurationsdateien bearbeiten.

02 Bevor du beginnst Zwei Dinge, sonst nichts
Voraussetzungen
Claude Code ist installiert. nötig
Python 3.10 oder neuer ist installiert. nötig

Nicht sicher? Claude prüft beides beim Start der Einrichtung. Wenn du trotzdem selbst nachsehen willst, kopiere einen dieser Befehle in dein Terminal.

claude --version
python3 --version macOS, Linux
python --version Windows

Diese Prüfungen sind freiwillig. Fehlt etwas, sagt Claude dir während der Einrichtung genau, was du nachinstallieren musst, und wie du danach weitermachst.

Einmal einrichten

Die Einrichtung besteht aus einem Startbefehl und einem Prompt.

03 Projektordner erstellen und Claude starten Schritt 1
{{ tabTitle }}
{{ tabShell }}
mkdir webseiten-zu-excel
cd webseiten-zu-excel
claude

Claude Code öffnet sich jetzt in einem eigenen Arbeitsordner. In diesem Ordner werden später auch deine Excel-Dateien gespeichert.

03b Einrichtungs-Prompt kopieren Schritt 2 · das Herzstück
Einrichtungs-Prompt
Prompt für Claude Code
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.

Füge diesen Text vollständig in Claude Code ein und sende ihn ab.

03c Claude übernimmt die Installation Schritt 3
Einrichtungsassistent

Claude Code wird dich um Erlaubnis bitten, einige Terminalbefehle auszuführen. Prüfe den angezeigten Befehl und bestätige ihn.

  • {{ st.n }} {{ st.label }}
i
Diese Liste zeigt, was Claude der Reihe nach erledigt. Du bestätigst nur die Befehle, die dir Claude Code anzeigt.
04 Einmal neu starten, dann testen Schritt 4 und 5
Neustart und Verbindungstest

Einmal neu starten

Nachdem Claude die Einrichtung abgeschlossen hat, beendest du Claude Code vollständig und startest es im selben Ordner erneut.

claude

Der Neustart ist nötig, damit Claude Code den neu eingerichteten Scrapling-Server lädt.

Verbindung prüfen

Schick Claude nach dem Neustart diesen kurzen Test.

Test-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.
Scrapling ist bereit.

Wenn diese Antwort kommt, ist die Einrichtung durch. Ab hier brauchst du keine Befehle mehr.

Excel erstellen
05 Jetzt beschreibst du nur noch das Ergebnis Erste Excel-Datei
Claude Code · webseiten-zu-excel
Beispiel-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.
Fertig
output/vergleich.xlsx
vergleich.xlsx Blatt 1
Name Preis Anbieter Link Modell A 249,00 € Anbieter 1 Produktseite Modell B 279,90 € Anbieter 2 Produktseite Modell C 312,50 € Anbieter 3 Produktseite

Die Kopfzeile ist formatiert, die erste Zeile bleibt beim Scrollen stehen, Filter sind aktiv und die Links lassen sich anklicken. Darum musst du dich nicht kümmern, das steht in den Projektregeln.

06 Du kannst auch ganz normal schreiben Fünf Vorlagen
Vorlagen
Produktvergleich
Vergleiche diese Produktseiten und erstelle mir eine Excel-Datei mit Preis, Versand, Lieferzeit und Link:

[Links einfügen]
Stellenanzeigen
Sammle diese Stellenanzeigen in einer Excel-Datei. Ich brauche Unternehmen, Position, Arbeitsort, Gehalt, Anforderungen und Bewerbungslink:

[Links einfügen]
Wohnungen
Vergleiche diese Wohnungen in Excel. Verwende Kaltmiete, Warmmiete, Größe, Zimmer, Stadtteil und Link:

[Links einfügen]
Lieferanten
Erstelle aus diesen Anbieterseiten eine Excel-Datei mit Anbieter, Produkt, Preis, Mindestmenge, Lieferzeit und Kontakt:

[Links einfügen]
Eigene Aufgabe
Öffne diese Webseiten:

[Links einfügen]

Erstelle eine Excel-Datei mit:
- [gewünschte Spalte]
- [gewünschte Spalte]
- [gewünschte Spalte]
06b Wer macht was Nach der Einrichtung
Du schreibst
  • ·welche Webseiten geöffnet werden sollen
  • ·welche Spalten du möchtest
  • ·wie die Datei heißen soll
Claude erledigt
  • Webseiten öffnen
  • Informationen finden
  • Daten sortieren
  • doppelte Einträge entfernen
  • Excel-Datei anlegen
  • Tabelle formatieren
  • Links einfügen
  • Datei speichern
  • Speicherort nennen

Nach der Einrichtung brauchst du keine Terminalbefehle mehr.

Hilfe
07 Wenn etwas hakt Ein Prompt pro Fall
Hilfe
Claude erklärt nur die Installation, führt sie aber nicht aus
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
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
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
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
Überarbeite die Excel-Datei.

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

Quellen zum Nachlesen: Scrapling auf GitHub und die offizielle Dokumentation zum MCP-Server.