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": "Дані актуальні"
}

Значення статусу

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

🚀 Magic Search

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

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

API Endpoint

POST /api/scraping/magic-search

Запит:

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

Відповідь (Успіх):

{
  "status": "scraping_started",
  "company_slug": "spotify-ab1",
  "company_name": "Spotify",
  "jobs_started": 4,
  "job_ids": ["uuid1", "uuid2", "uuid3", "uuid4"],
  "message": "🚀 Аналіз розпочато! Перевірте через 5-10 хвилин."
}

Відповідь (Не знайдено):

{
  "status": "error",
  "error": "company_not_found",
  "message": "Компанію 'XYZ' не знайдено на Kununu."
}

Типи завдань

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

🧭 Slug Finder

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

Пріоритет стратегії

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

Інтелектуальне зіставлення

• Порівнює результати пошуку за допомогою оцінки подібності
• Фільтрує загальні сторінки (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 показує прогрес у реальному часі:

⏳ Пошук профілю компанії...
🔍 Виявлення Kununu slug...
🚀 Запуск 4 завдань scraping-у...
📊 Kununu: 0/200 відгуків...
📊 Kununu: 50/200 відгуків...
📊 Kununu: 150/200 відгуків...
✅ Scraping завершено! Запуск аналізу AI...
✅ Аналіз завершено! Переглянути звіт →

⚙️ Пороги свіжості

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

🌍 Фільтрація за регіонами

Magic Search підтримує scraping для конкретних регіонів:

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

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

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

---

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