Smart Search та Magic Search

Smart Search автоматично забезпечує актуальність даних, тоді як Magic Search дозволяє аналізувати компанію в один клік.

🔍 Smart Search

Коли ви шукаєте компанію, Smart Search автоматично:

1. Перевіряє базу даних на наявність даних
2. Перевіряє актуальність (< 7 днів = актуально)
3. Запускає scraping, якщо дані застарілі або відсутні
4. Повертає статус з прогресом у реальному часі

API Endpoint

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

Параметри:

Параметр	Тип	За замовчуванням	Опис
q	string	required	Назва компанії для пошуку
country	string	"de"	Код країни (de, at, ch)
auto_scrape	bool	true	Автоматично запускати scraping, якщо застарілі

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

Статус	Значення
found	Компанія існує з актуальними даними
refreshing	Дані застарілі, scraping триває
scraping	Нова компанія, розпочато перший scrape
not_found	Компанія не знайдена на Kununu
error	Щось пішло не так

🚀 Magic Search

Magic Search — це тригер для аналізу в один клік. Введіть назву компанії, і система:

1. Виявляє Kununu slug за допомогою інтелектуального пошуку slug
2. Створює 4 завдання scraping'у (Kununu, Google, Reddit, Vacancies)
3. Повертає job ID для відстеження прогресу
4. Виконує sentiment analysis після завершення scraping'у

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": "🚀 Analysis started! Check back in 5-10 minutes."
}

Response (Not Found):

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

Job Types

Джерело	Зібрані дані
Kununu	Відгуки співробітників (основні)
Google	Відгуки Google Maps
Reddit	Обговорення компанії
Vacancies	Оголошення про вакансії Indeed

🧭 Slug Finder

Інтелектуальний пошук slug виявляє URL-адреси компаній на Kununu:

Strategy Priority

1. Кеш бази даних - Перевіряє існуючі company_profiles
2. Пряма URL-адреса - Спробуйте простий slug (наприклад, klingelnberg)
3. Пошук Kununu - Парсить результати пошуку за допомогою інтелектуального зіставлення
4. Варіанти URL - Спробуйте суфікси (-ag, -gmbh, -suisse)
5. Резервний варіант Google - Пошук як останній засіб

Smart Matching

• Порівнює результати пошуку за допомогою оцінки схожості
• Фільтрує загальні сторінки (beste-arbeitgeber, top-companies)
• Мінімальний поріг 0.3 необхідний для збігу

Приклади:

Запит	Знайдений Slug	Метод
Klingelnberg	klingelnberg	Пряма URL-адреса
ALDI	aldi-suisse	Кешовано
UBS	ubs-deutschland	Пряма URL-адреса
Swiss Re	null	Немає на Kununu ✅

🍕 Pizza Tracker Integration

Під час Magic Search Pizza Tracker показує прогрес у реальному часі:

⏳ Finding company profile...
🔍 Discovering Kununu slug...
🚀 Starting 4 scraping jobs...
📊 Kununu: 0/200 reviews...
📊 Kununu: 50/200 reviews...
📊 Kununu: 150/200 reviews...
✅ Scraping complete! Running AI analysis...
✅ Analysis complete! View report →

⚙️ Freshness Thresholds

Метрика	Поріг	Дія
Максимальний вік	7 днів	Запустити оновлення, якщо старші
Мін. відгуків	50	Запустити, якщо менше
Покриття Sentiment	80%	Запустити аналіз, якщо нижче

🌍 Region Filtering

Magic Search підтримує region-specific scraping:

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

Підтримувані регіони:

• de - Німеччина
• at - Австрія
• ch - Швейцарія
• global - Усі регіони (за замовчуванням)

---

Smart Search та Magic Search працюють за допомогою інструментів search_company та run_analysis AI агента.