Lead Hunter to narzędzie do wyszukiwania potencjalnych klientów na forach, serwisach społecznościowych i platformach ogłoszeniowych. Aplikacja działa jako pojedynczy plik HTML — bez serwera, bez instalacji.

Autor: Michał Stankiewicz | 📞 +48 797 486 355 | ✉️ michalstankiewicz@onet.eu

• Wpisz zapytanie opisujące potrzebę klienta (np. „szukam szkoleń z Excela")
• Aplikacja przeszukuje aktywne i ulubione źródła
• Wyniki z oceną relevancji (%), podglądem fragmentu i wyróżnionymi słowami kluczowymi
• Szybkie zapytania w sidebarze (Szkolenia, IT/Dev, Marketing, Księgowość…)
• Statystyki: liczba wyników, źródeł, gorących leadów

• Dwa widoki: kafelki i lista — oba z grupowaniem Aktywne / Nieaktywne
• Sortowanie: A-Z, Z-A, data dodania
• System ulubionych ⭐ — oznaczone źródła wyświetlane na górze
• Klonowanie źródła jednym kliknięciem (domyślny silnik: Brak)
• Edycja inline — nazwa, typ, ikona i URL edytowalne bezpośrednio na kafelku
• Ustawienia źródła — podfora, opis, logowanie, przypisane skrypty (wiele, z kolejnością)

Każde źródło można podpiąć pod jeden z dostępnych silników:

Konfiguracja Google CSE: zakładka Silniki → 🔑 Konfiguruj (klucz API + CX).

• Skrypty przypisywane do źródeł (wiele skryptów na źródło, z kolejnością)
• Obsługiwane języki: JavaScript, Python, Bash, cURL, PHP, Inny
• Opis i kod z collapsible podglądem (monospace)
• Pełne CRUD: dodaj, edytuj, usuń
• Przełącznik widoku: według skryptów lub według źródeł, do których są podpięte

• Zestawy fraz grupowane w karty (np. „Szkolenia", „IT/Dev", „Marketing")
• Każdy zestaw podłączony do wybranych podlinków źródeł

Pełny backup w pliku .db.json (klienthunter-YYYY-MM-DD.db.json):

• ✅ Źródła (z przypisanymi skryptami)
• ✅ Zestawy fraz i słów kluczowych
• ✅ Skrypty (z kodem)
• ✅ Zapisane leady
• ✅ Ustawienia (harmonogram, bezpieczeństwo)
• ✅ Dane wrażliwe: loginy, klucz Google API (opcjonalnie zaszyfrowane — patrz Security)
• ✅ Google CX (zawsze plain — niesensytywne)

Import z podglądem zawartości; możliwość dołączenia lub zastąpienia danych.

Pliki demo:

• NoPassklienthunter-2026-03-01.db.json — eksport bez hasła
• Pass123klienthunter-2026-03-01.db.json — eksport z hasłem 123

Panel Security (topbar) umożliwia konfigurację:

• Przechowywanie w localStorage lub RAM (wg ustawień Security)
• Lampki statusu przy każdym źródle: 🟢 zalogowany / 🔴 wylogowany / 🟡 niewymagane

• Przycisk ⏱ w topbarze — zielony z pulsującą kropką gdy aktywny
• Konfiguracja: co godzinę / co 2h / co 4h / co 8h / codziennie o wybranej godzinie
• Powiadomienie systemowe (Browser Notification API) z podsumowaniem wyników
• Harmonogram zapisywany w localStorage; wznawia się po odświeżeniu strony

• Dane kontaktowe autora (telefon klikalny, mail klikalny)
• Sekcja donacji: IBAN z kopią do schowka, BLIK, link do Patronite
• Wersja aplikacji widoczna w sidebarze i w panelu

git clone https://github.com/michalstankiewicz4-cell/WyszukiwarkaKlientow.git
cd WyszukiwarkaKlientow

Otwórz index.html w dowolnej nowoczesnej przeglądarce. Nie wymagana instalacja ani serwer.

1. Przejdź do Zarządzaj źródłami
2. Dodaj źródła przyciskiem + Dodaj źródło (podstawowe dane: nazwa, typ, link, ikona)
3. Włącz interesujące Cię źródła (toggle) i oznacz najważniejsze jako ulubione ⭐
4. Kliknij przycisk edycji ✏️ na kafelku, by zmienić nazwę, typ, ikonę lub URL
5. W ustawieniach źródła (⚙) skonfiguruj podfora, silnik i przypisz skrypty

1. Przejdź do Silniki wyszukiwań
2. Kliknij 🔑 Konfiguruj przy karcie Google CSE
3. Wpisz klucz API i identyfikator CX

1. Przejdź do Frazy i słowa kluczowe
2. Utwórz zestaw i wpisz frazy oddzielone przecinkami
3. Podłącz zestaw do wybranych podlinków źródeł

1. Przejdź do Skrypty
2. Kliknij + Dodaj skrypt, wybierz język i wklej kod
3. W ustawieniach źródła przypisz skrypty i ustal ich kolejność

1. Kliknij ⏱ w topbarze
2. Włącz harmonogram i ustaw częstotliwość
3. Przy pierwszym włączeniu przeglądarka poprosi o zgodę na powiadomienia

• Eksport: przycisk „Eksport" w Zarządzaj źródłami → plik .db.json
  • Gdy Szyfrowanie eksportu włączone w Security → hasła i klucz API zaszyfrowane
• Import: przycisk „Import" → wybierz plik, potwierdź co zaimportować

• Eksport leadów do CSV / Excel
• Pipeline leadów (Kanban: Nowy → Kontakt → Zamknięty)
• Tagi i notatki przy leadach
• Historia wyszukiwań
• Dashboard ze statystykami (wykres leadów w czasie)
• Wiele profili użytkownika (pełny snapshot konfiguracji)
• Integracja z CRM (HubSpot, Pipedrive)
• Wersja wielostanowiskowa z backendem

Aplikacja jest darmowa. Jeśli chcesz wesprzeć autora:

• BLIK: 797 486 355
• Przelew: Michał Stankiewicz, PKO BP PL55 1020 1097 0000 7902 0226 5353 Tytuł: „Wyszukiwarka klientów"
• Patronite: patronite.pl/michalstankiewicz

Lead Hunter v0.0.1-alfa — single-file, no backend, no dependencies 🎯