Skip to content

robin14tamba-create/lead-scraper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎯 Lead Scraper

Hol dir qualifizierte B2B-Leads aus Google Maps — automatisch gefiltert und mit personalisiertem Outreach-Aufhänger pro Lead. Am Ende steht eine fertige Excel/CSV, die du direkt in dein CRM importierst.

Das Tool läuft in Claude Code. Du brauchst nur einen Apify-Account (kostenlos). Claude steuert alles: ein kurzes Interview richtet den Scraper auf dein Business ein, dann scrapt, filtert und bewertet er die Leads für dich.


Was du brauchst

  1. Claude Codehttps://claude.com/claude-code (CLI oder VS-Code-Extension)
  2. Python 3.10+https://www.python.org/downloads/ (bei Installation „Add to PATH" anhaken)
  3. Apify-Account (gratis) — https://console.apify.com/sign-up

Installation (einmalig)

# 1. Repository klonen
git clone https://github.com/<dein-user>/lead-scraper.git
cd lead-scraper

# 2. Python-Pakete installieren
pip install -r requirements.txt

# 3. Apify-Token eintragen
#    .env.example zu .env kopieren ...
cp .env.example .env          # Windows: copy .env.example .env
#    ... dann .env öffnen und deinen Token eintragen.

Apify-Token holen: In der Apify-Console → Settings → Integrations → API-Token kopieren (https://console.apify.com/settings/integrations) und in .env bei APIFY_TOKEN= einfügen.


Benutzung

  1. Öffne den Ordner in Claude Code (cd lead-scraper, dann claude — oder den Ordner in der VS-Code-Extension öffnen).
  2. Schreib einfach start (oder /start). Das genügt — Claude kennt den Rest.
  3. Claude führt dich durch ein kurzes Interview (dein Angebot, Zielkunde, Region, Kriterien) und richtet den Scraper auf dein Business ein. Beim nächsten Mal reicht wieder start.
  4. Du nennst eine Region oder Stadt und wie viele Leads du willst — Claude zeigt dir die geschätzten Kosten, bevor etwas gescraped wird.
  5. Am Ende liegen die Ergebnisse in output/:
    • qualified_leads.xlsx / qualified_leads.csv — deine fertigen Leads
    • rejected.csv — aussortierte Leads inkl. Grund (Transparenz)

Region statt Stadt

Sag z.B. „Rhein-Main-Gebiet, 500 Leads" — Claude verteilt die Leads schlau auf die Städte der Region (größere Städte = mehr Leads) und lässt dich die Verteilung bestätigen.


Was in der Lead-Liste steht

Name · Kategorie · Adresse · Stadt · PLZ · Telefon · Email · GF-Name · Direktkontakt-Email · Durchwahl · Website · Rating · Anzahl Reviews · Preisniveau · Auslastung · Öffnungszeiten · Google-Maps-Link · Fit-Score · Fit-Begründung · Outreach-Hook · Status

Der Outreach-Hook ist ein fertiger 1-Satz-Aufhänger pro Lead, mit dem du direkt in die Ansprache gehen kannst. GF-Name / Direktkontakt-Email / Durchwahl werden nur gefüllt, wenn du die tiefe Anreicherung aktivierst (siehe unten).


Tiefe Kontakt-Anreicherung (optional)

Standardmäßig kommen die Kontaktdaten von Google Maps + von der Lead-Website (Emails/Telefon). Optional kann Claude die Websites der qualifizierten Leads noch tiefer analysieren — Startseite + Impressum + Kontakt + Team — und daraus den Geschäftsführer-Namen, eine Direkt-Email und die Durchwahl ziehen. Besonders wertvoll z.B. bei Immobilienmaklern.

  • Claude-Anreicherung (Default, gratis): Läuft komplett über deine Claude-Subscription (Max-Abo), keine extra Kosten und kein zusätzlicher Account. Claude fetcht die Seiten parallel über mehrere Sub-Agenten. Dauert etwas länger, dafür bessere Qualität. Claude zeigt dir vorher eine Aufwandsschätzung und fragt, ob du es willst.
  • Grenze: Websites, die rein per JavaScript laden (z.B. manche Baukasten-Seiten), kann diese Methode nicht lesen. Für solche Fälle gibt es die optionalen Upgrades unten.

Optionale Upgrades (nur bei Bedarf, etwas Setup nötig)

Upgrade Kosten Setup Wann sinnvoll
Apify-Fallback nutzt dein vorhandenes $5-Guthaben keins (gleicher Token) JS-Seiten, die Claude nicht lesen konnte
Firecrawl gratis 1.000 Seiten/Monat Account + API-Key + MCP mehr Zuverlässigkeit bei JS-Seiten
Playwright-MCP gratis lokaler Browser-Download technisch versiert, keine externen Dienste
Crawl4AI gratis, unbegrenzt Python-Paket + Browser große Listen, voll selbst-gehostet

Sag Claude einfach, welches Upgrade du nutzen willst — er erklärt dir die Einrichtung.


Kosten & Grenzen (wichtig)

  • Apify rechnet pro Ergebnis ab (~$2,10 / 1.000 Orte).
  • Gratis-Plan: $5 pro Monat (≈ 2.500 Orte). Das Guthaben läuft nicht über und Runs werden blockiert, sobald es aufgebraucht ist. Claude zeigt dir vor jedem Run die Schätzung.
  • Emails liefert Google Maps nicht direkt — sie werden von den Websites der Leads geholt. Nur Leads mit Website können eine Email haben; die Abdeckung ist nie 100%.
  • Google-Maps-Daten können veraltet sein (tote Nummern/Websites). Keine Live-Prüfung.
  • Wichtig: Apify reserviert vor jedem Run einen Sicherheits-Puffer. Ist dein Guthaben fast leer (z.B. < ~30 Cent), wird der Run blockiert (not-enough-usage-to-run-paid-actor) — auch wenn die echten Kosten nur Cent betragen würden. Halte etwas Guthaben vor.

In dein CRM importieren

qualified_leads.csv lässt sich in praktisch jedes CRM importieren (HubSpot, Pipedrive, Notion, Excel, Google Sheets). Beim Import die Spalten den CRM-Feldern zuordnen. Die Datei ist UTF-8 mit BOM kodiert — Umlaute erscheinen in Excel korrekt.


Fehlerbehebung

Problem Lösung
„Kein gültiger APIFY_TOKEN" .env anlegen und echten Token eintragen
„No module named ..." pip install -r requirements.txt ausführen
Run endet mit FAILED / 0 Ergebnisse Suchbegriffe/Region prüfen; Apify-Guthaben checken
Umlaute kaputt in Excel .xlsx-Datei nutzen (statt CSV doppelklicken)

Dieses Tool liefert öffentlich verfügbare Geschäftsdaten. Für die Art der Nutzung (insbesondere Kontaktaufnahme) bist du selbst verantwortlich.

About

Qualifizierte B2B-Leads aus Google Maps scrapen & filtern — gesteuert durch Claude Code. Nur Apify-Token noetig.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages