Lead Scraper — Frappe Custom App

Google Places Lead Scraper für Frappe CRM. Sucht Firmen über die Google Places API, scannt deren Website/Impressum und legt sie als CRM Lead in Frappe CRM an.

Läuft als Custom App innerhalb der Frappe-Bench aus Docker-Stacks/frappe-crm-erp — kein eigener Container, kein REST-Client, direkter Zugriff auf Frappes ORM.

Ausführliche Installationsanleitung, Verzeichnis-Übersicht (was wo liegt) und Troubleshooting: siehe docs/install.md.

---

Kurzreferenz

# Konfigurieren (im Frappe-Desk, nicht per Datei):
#   Lead Scraper Settings -> Google API Key setzen

# Suchen + importieren in einem Rutsch
bench --site crm.localdomain leadscraper-run --query "Polsterei" --regions BY

# Nur suchen, Ergebnis als JSON zur Durchsicht speichern
bench --site crm.localdomain leadscraper-search --query "Polsterei" --regions BY --output leads.json

# Aus der JSON-Datei importieren
bench --site crm.localdomain leadscraper-import --input /pfad/leads.json --query "Polsterei"

---

Contributing

Dieses App-Repo nutzt pre-commit für Formatierung/Linting:

cd apps/leadscraper
pre-commit install

Konfigurierte Tools: ruff, eslint, prettier, pyupgrade.

Lizenz

Copyright (C) 2026 Christian Säum – web-seo-consulting.eu

Dieses Projekt steht unter der GNU Affero General Public License, Version 3 oder (nach deiner Wahl) einer späteren Version (AGPL-3.0-or-later). Der vollständige Lizenztext steht in der Datei LICENSE.

Du darfst die Software nutzen, weitergeben und – auch kommerziell – verkaufen. Gibst du eine veränderte Fassung weiter oder betreibst du sie über ein Netzwerk (z. B. als Dienst), muss deren vollständiger Quellcode ebenfalls unter der AGPL-3.0-or-later verfügbar sein. Der Copyright-Hinweis und die Nennung des ursprünglichen Autors dürfen nicht entfernt werden.

Diese Angabe betrifft nur die in diesem Repository enthaltenen eigenen Dateien (Konfiguration, Skripte, Anpassungen). Eingebundene Fremdsoftware und Container-Images unterliegen weiterhin ihren eigenen Lizenzen.