Smart Search & Magic Search

Smart Search stellt automatisch die Aktualität der Daten sicher, während Magic Search eine Unternehmensanalyse mit nur einem Klick ermöglicht.

🔍 Smart Search

Wenn Sie nach einem Unternehmen suchen, führt Smart Search automatisch folgende Schritte aus:

1. Überprüft die Datenbank auf vorhandene Daten
2. Verifiziert die Aktualität (< 7 Tage = aktuell)
3. Löst Scraping aus, wenn Daten veraltet oder fehlen
4. Gibt Status mit Echtzeit-Fortschritt zurück

API Endpoint

GET /api/search/smart?q=COMPANY&country=COUNTRY&auto_scrape=true

Parameters:

Parameter	Type	Default	Beschreibung
q	string	required	Firmenname zum Suchen
country	string	"de"	Ländercode (de, at, ch)
auto_scrape	bool	true	Automatisches Auslösen von Scraping, wenn veraltet

Response

{
  "status": "found",
  "company_name": "BMW",
  "company_slug": "bmw",
  "data_status": "fresh",
  "review_count": 5621,
  "last_updated": "2025-12-27",
  "scraping_jobs": [],
  "message": "Data is up to date"
}

Statuswerte

Status	Bedeutung
found	Unternehmen existiert mit aktuellen Daten
refreshing	Daten veraltet, Scraping im Gange
scraping	Neues Unternehmen, erster Scraping-Vorgang gestartet
not_found	Unternehmen nicht auf Kununu gefunden
error	Es ist ein Fehler aufgetreten

🚀 Magic Search

Magic Search ist ein Auslöser für Analysen mit einem Klick. Geben Sie einen Firmennamen ein und das System:

1. Ermittelt den Kununu-Slug über einen intelligenten Slug Finder
2. Erstellt 4 Scraping-Jobs (Kununu, Google, Reddit, Vacancies)
3. Gibt Job IDs zurück zur Fortschrittsverfolgung
4. Führt Sentiment Analysis aus, nachdem das Scraping abgeschlossen ist

API Endpoint

POST /api/scraping/magic-search

Request:

{
  "company_name": "Spotify",
  "country": "de",
  "months_back": 24
}

Response (Erfolg):

{
  "status": "scraping_started",
  "company_slug": "spotify-ab1",
  "company_name": "Spotify",
  "jobs_started": 4,
  "job_ids": ["uuid1", "uuid2", "uuid3", "uuid4"],
  "message": "🚀 Analysis started! Check back in 5-10 minutes."
}

Response (Nicht gefunden):

{
  "status": "error",
  "error": "company_not_found",
  "message": "Company 'XYZ' was not found on Kununu."
}

Job Types

Quelle	Gesammelte Daten
Kununu	Mitarbeiterbewertungen (primär)
Google	Google Maps Bewertungen
Reddit	Unternehmensdiskussionen
Vacancies	Indeed Stellenanzeigen

🧭 Slug Finder

Der intelligente Slug Finder ermittelt Kununu Unternehmens-URLs:

Strategie Priorität

1. Database cache – Prüft bestehende company_profiles
2. Direct URL – Versucht einfachen Slug (z.B. klingelnberg)
3. Kununu search – Parst Suchergebnisse mit Smart Matching
4. URL variants – Versucht Suffixe (-ag, -gmbh, -suisse)
5. Google fallback – Letzte Suchoption

Smart Matching

• Vergleicht Suchergebnisse anhand von Similarity Scoring
• Filtert generische Seiten (beste-arbeitgeber, top-companies)
• Mindestschwellenwert von 0.3 für einen Treffer erforderlich

Beispiele:

Abfrage	Gefundener Slug	Methode
Klingelnberg	klingelnberg	Direkt-URL
ALDI	aldi-suisse	Gecached
UBS	ubs-deutschland	Direkt-URL
Swiss Re	null	Nicht auf Kununu ✅

🍕 Pizza Tracker Integration

Während der Magic Search zeigt der Pizza Tracker den Fortschritt in Echtzeit an:

⏳ Unternehmensprofil wird gesucht...
🔍 Kununu-Slug wird ermittelt...
🚀 4 Scraping-Jobs werden gestartet...
📊 Kununu: 0/200 Bewertungen...
📊 Kununu: 50/200 Bewertungen...
📊 Kununu: 150/200 Bewertungen...
✅ Scraping abgeschlossen! KI-Analyse wird ausgeführt...
✅ Analyse abgeschlossen! Bericht anzeigen →

⚙️ Aktualitätsschwellenwerte

Metrik	Schwellenwert	Aktion
Max. Alter	7 Tage	Aktualisierung auslösen, wenn älter
Min. Bewertungen	50	Auslösen, wenn weniger
Sentiment Coverage	80%	Analyse ausführen, wenn darunter

🌍 Regionenfilterung

Magic Search unterstützt regionenspezifisches Scraping:

{
  "company_name": "Lidl",
  "country": "ch"  // Switzerland only
}

Unterstützte Regionen:

• de - Deutschland
• at - Österreich
• ch - Schweiz
• global - Alle Regionen (Standard)

---

Smart Search und Magic Search werden von den search_company- und run_analysis-Tools des AI Agenten betrieben.