Smart Search & Magic Search

Smart Search gewährleistet automatisch die Aktualität der Daten, während Magic Search eine Unternehmensanalyse mit 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. Überprüft die Aktualität (< 7 Tage = aktuell)
3. Löst Scraping aus, wenn Daten veraltet oder fehlend sind
4. Gibt den Status zurück mit Echtzeitfortschritt

API Endpoint

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

Parameters:

Parameter	Type	Default	Description
q	string	required	Firmenname, nach dem gesucht werden soll
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"
}

Status Values

Status	Meaning
found	Unternehmen existiert mit aktuellen Daten
refreshing	Daten veraltet, Scraping läuft
scraping	Neues Unternehmen, erster Scrape gestartet
not_found	Unternehmen nicht auf Kununu
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. Findet 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 (Success):

{
  "status": "scraping_started",
  "company_slug": "spotify-ab1",
  "company_name": "Spotify",
  "jobs_started": 4,
  "job_ids": ["uuid1", "uuid2", "uuid3", "uuid4"],
  "message": "🚀 Analyse gestartet! Bitte überprüfen Sie in 5-10 Minuten erneut."
}

Response (Not Found):

{
  "status": "error",
  "error": "company_not_found",
  "message": "Unternehmen 'XYZ' wurde auf Kununu nicht gefunden."
}

Job Types

Source	Data Collected
Kununu	Mitarbeiterbewertungen (primär)
Google	Google Maps Bewertungen
Reddit	Unternehmensdiskussionen
Vacancies	Indeed Stellenanzeigen

🧭 Slug Finder

Der intelligente Slug Finder findet Kununu Unternehmens-URLs:

Priorität der Strategie

1. Datenbank-Cache - Bestehende company_profiles prüfen
2. Direkte URL - Einfachen Slug versuchen (z.B. klingelnberg)
3. Kununu-Suche - Suchergebnisse mit Smart Matching parsen
4. URL-Varianten - Suffixe versuchen (-ag, -gmbh, -suisse)
5. Google-Fallback - Letzter Suchversuch

Smart Matching

• Vergleicht Suchergebnisse mittels Ähnlichkeitsbewertung
• Filtert generische Seiten (beste-arbeitgeber, top-companies)
• Mindestschwelle von 0.3 für eine Übereinstimmung erforderlich

Examples:

Query	Found Slug	Method
Klingelnberg	klingelnberg	Direkte URL
ALDI	aldi-suisse	Im Cache
UBS	ubs-deutschland	Direkte URL
Swiss Re	null	Nicht auf Kununu ✅

🍕 Pizza Tracker Integration

Während der Magic Search zeigt der Pizza Tracker den Echtzeitfortschritt an:

⏳ Firmenprofil wird gesucht...
🔍 Kununu Slug wird gefunden...
🚀 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 ansehen →

⚙️ Aktualitätsschwellenwerte

Metric	Threshold	Action
Maximales Alter	7 days	Aktualisierung auslösen, wenn älter
Mindestbewertungen	50	Auslösen, wenn weniger
Sentiment-Abdeckung	80%	Analyse ausführen, wenn darunter

🌍 Regionale Filterung

Magic Search unterstützt regionsspezifisches Scraping:

{
  "company_name": "Lidl",
  "country": "ch" // Nur Schweiz
}

Unterstützte Regionen:

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

---

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