Pierwsze krokiTwoja firmaWyszukiwarkaKarta firmyListy i arkuszePoziomy agentów i kredytyTwoje kredyty i płatnościSygnały zakupoweSprawozdania finansoweTryb dzwonieniaPrzygotowanie rozmowyIntegracje z CRMClaude (MCP)Szybkie pobieranie sprawozdań z RDFLimity i zasady korzystania z danychDla administratoraAPINowości: wyszukiwanie z AI, sygnały, arkusz, CRMKonta użytkowników i uprawnienia (administrator)Weryfikacja dwuetapowa (2FA)
Instrukcja obsługi SalesTT Prospecting
SalesTT Prospecting to wyszukiwarka polskich firm B2B (spółki z KRS, a docelowo także firmy jednoosobowe z CEIDG) z danymi z rejestrów, stron WWW i publicznych źródeł sygnałów zakupowych. Pomaga odpowiedzieć na trzy pytania handlowca: do kogo dzwonić, dlaczego właśnie teraz i co powiedzieć.
Pierwsze kroki
- Otwórz link z zaproszenia, ustaw hasło i zaakceptuj regulamin.
- Uzupełnij zakładkę Twoja firma (5 minut, albo jedno kliknięcie „Uzupełnij ze strony WWW”). Na niej opiera się dopasowanie firm, priorytety i notatki do rozmów.
- W Wyszukiwarce zaznacz „⭐ pasuje do mojego profilu”, dodaj filtry i zapisz wyniki na liście.
- Na liście dodaj kolumny AI (np. ocena dopasowania 1–10), posortuj po ocenie i uruchom Tryb dzwonienia.
- Przed telefonem kliknij Przygotuj rozmowę, po rozmowie zapisz wynik i datę następnego kroku.
Język interfejsu przełączasz w prawym górnym rogu (PL | EN) albo w zakładce Twoja firma. Dane z rejestrów (nazwy PKD, opisy projektów, tytuły sygnałów) pozostają po polsku.
Twoja firma
Profil Twojej firmy to podstawa dopasowania. Pola:
- Co sprzedajesz i jakie problemy klientów rozwiązujesz – z tego AI ocenia, czy firma pasuje, i układa pierwsze zdania rozmowy.
- Kim są Twoi klienci – branże, typy i wielkość firm.
- Z kim rozmawiasz u klienta – stanowiska; notatka do rozmowy podpowie, o którą rolę poprosić w recepcji.
- Kiedy klient Cię potrzebuje – zdarzenia (nowa hala, nowa linia, dotacja na automatyzację, rekrutacja w utrzymaniu ruchu). AI łączy je z sygnałami firmy w powód do kontaktu.
- Czym się wyróżniasz, referencje, typowy pierwszy krok – trafiają do argumentów, odpowiedzi na zastrzeżenia i propozycji następnego kroku.
- Docelowe działy / kody PKD, regiony i minimalne przychody klienta – służą do filtra „pasuje do mojego profilu” i podnoszą priorytet pasujących firm.
Przycisk ✨ Uzupełnij ze strony WWW czyta Twoją stronę i proponuje treść pustych pól (bez kredytów, do 5 razy dziennie). Propozycję zawsze sprawdź i zapisz.
Firma, z której dzwonisz
Na górze strony Twoja firma podaj NIP swojej firmy:
- spółka – łączymy konto z jej kartą i uzupełniamy puste pola profilu (nazwa, strona, opis działalności),
- jednoosobowa działalność (albo spółka cywilna) – zaznaczona domyślnie zgoda pozwala dodać ją do bazy, żeby mogli Cię znaleźć inni użytkownicy. Firma pojawia się w wyszukiwarce po weryfikacji przez administratora (sprawdzamy, czy konto należy do tej firmy). Zgodę wycofasz przez formularz Sprzeciw / usunięcie danych.
Firmy spoza bazy pobieramy z białej listy VAT (nazwa, KRS, REGON, adres działalności – bez adresu zamieszkania). Podana strona WWW trafia do zatwierdzenia jak każda zgłoszona strona.
Wyszukiwarka
Na wierzchu są podstawowe filtry (opis, PKD, województwo, miejscowość); pozostałe kryteria są pod „Więcej filtrów”. Wyniki można sortować: najlepiej dopasowane, największe przychody, największy kapitał, najświeższy sygnał, najmłodsze lub najstarsze firmy, nazwa A–Z.
Wyszukiwanie z AI
Na górze wyszukiwarki opisz własnymi słowami, jakich firm szukasz (np. „zakłady wtrysku tworzyw dla motoryzacji, śląskie, przychody powyżej 10 mln”) i kliknij Szukaj z AI. Przycisk Na podstawie mojego profilu szuka potencjalnych klientów z profilu „Twoja firma” (co sprzedajesz, komu, jakie problemy rozwiązujesz).
AI (poziom Solo, 1 kr.) przygotowuje plan wyszukiwania, który widać nad wynikami: kody PKD z uzasadnieniem, słowa szukane w opisach firm (opis ze strony WWW, słowa kluczowe, nazwa, opis PKD – także odmiany słów) oraz filtry wynikające z opisu (województwo, przychody, kapitał). Firma pasuje, gdy ma któryś z kodów PKD (przeważający albo dodatkowy) albo opis z tymi słowami; najwyżej są firmy spełniające oba warunki. Przy wynikach widać, dlaczego firma pasuje (PKD ✓, opis ✓). Wyniki zawęzisz zwykłymi filtrami, dodasz do listy, wyeksportujesz albo obserwujesz – za stronicowanie, filtry i powtórkę tego samego opisu (30 dni, lista „Ostatnie”) kredytów nie pobieramy.
- Czego szukasz – wyszukiwanie pełnotekstowe w nazwach, opisach i słowach kluczowych ze stron firm (po polsku, np. „obróbka CNC aluminium”).
- Filtry rejestrowe: dział i kod PKD (także dodatkowe PKD), województwo, miejscowość, forma (spółki / jednoosobowe), typ działalności (producent, dystrybutor, usługi…), rok założenia, kapitał zakładowy, przychody, zysk netto.
- Filtry jakościowe: ma telefon / e-mail, czynny VAT, większa firma (sprawozdanie badane przez biegłego), kapitał zagraniczny, strona w obcym języku, certyfikat ISO.
- Sygnały i inwestycje: sygnał zakupowy w ostatnich N dniach, pomoc publiczna, projekt z dotacją UE, pozwolenie na budowę, VAT-UE.
- ⭐ pasuje do mojego profilu – docelowe PKD, regiony i minimalne przychody z zakładki Twoja firma.
Wyniki zapiszesz na liście („Dodaj zaznaczone” albo „Dodaj wszystkie wyniki”, do 1000 firm) albo wyeksportujesz do CSV / XLSX w ramach miesięcznego limitu eksportu.
Karta firmy
Na górze karty są telefony (kliknięcie dzwoni z telefonu lub komputera), e-maile i strona WWW, pod nimi opis działalności. „Dodaj do listy” dodaje firmę do wybranej albo nowej listy bez wychodzenia z karty. „← wróć” prowadzi tam, skąd przyszedłeś: do wyników wyszukiwania (z tymi samymi filtrami i sortowaniem), do listy albo do sygnałów.
Karta zbiera wszystko o firmie:
- Komu i dlaczego teraz – powody do kontaktu i priorytet 0–100 (gorący ≥ 40, ciepły ≥ 15). Liczymy je bez AI z sygnałów z ostatnich 180 dni, trwających projektów unijnych, wzrostu przychodów i dopasowania do Twojego profilu.
- Przygotowanie rozmowy – notatka AI (patrz niżej) i historia rozmów.
- Dane kontaktowe (wyłącznie z CEIDG albo ze strony firmy), adres, NIP / REGON / KRS, PKD, kapitał, zarząd (liczba osób), status VAT i VAT-UE, dane ze strony WWW (języki, ISO, sklep).
- Finanse z e-sprawozdań i pełne sprawozdania finansowe (bilans, rachunek zysków i strat, wskaźniki), jeśli zostały wczytane.
- Projekty z dotacją UE, pozwolenia na budowę, pomoc publiczna (SUDOP) i sygnały.
Wyświetlenie karty liczy się do miesięcznego limitu kart firm (każda firma raz w miesiącu).
Baza rośnie, gdy z niej korzystasz
- Otwierasz kartę firmy bez strony WWW albo dodajesz taką firmę do listy – aplikacja sama szuka jej strony w tle (zwykle do 2 minut): sprawdza typowe adresy domen. Stronę przyjmuje tylko z dowodem (NIP, adres lub telefon firmy na stronie). Znaleziona strona, telefon i e-mail są od razu na karcie i dla wszystkich użytkowników.
- Kolumny AI na poziomie Duo i Quattro oraz notatki do rozmów czytają podstrony firmy. Telefony i e-maile z jej strony kontaktowej dopisujemy przy okazji do bazy.
- Gdy bezpłatne szukanie nie znajdzie strony, na karcie pojawia się przycisk Szukaj strony w wyszukiwarce (2 kr.): pytamy wyszukiwarkę o NIP firmy, potem o jej nazwę. Kredyty wracają, jeśli strony nie znajdziemy. Znalezioną stronę i kontakt widzą od razu wszyscy użytkownicy. O tę samą firmę można zapytać ponownie po 30 dniach.
- Tej samej firmy nie szukamy bezpłatnie ponownie przez 90 dni; dziennie sprawdzamy bezpłatnie do 500 firm (reszta czeka w kolejce, płatne szukanie ma pierwszeństwo).
Wspólne analizy AI
Dane bazowe (rejestry, strona, kontakty, sygnały, sprawozdania, opis firmy) są w abonamencie. Analizy AI, za które ktoś wcześniej zapłacił, są dostępne dla innych za 1 kr.:
- odpowiedzi z gotowych szablonów kolumn (Profil, Typ, Technologie, Eksport, Rekrutacje, Automatyzacja) na poziomie Duo lub Quattro – tylko gdy pytanie nie zostało zmienione,
- fakty z internetu z przygotowania rozmowy na poziomie Quattro (z datami i źródłami).
Na karcie firmy, w sekcji Analizy AI, odblokujesz pojedynczą analizę albo wszystkie naraz. Kolumna z szablonem sama bierze gotową analizę (do 90 dni) za 1 kr. zamiast pełnej ceny, a różnica wraca po zakończeniu kolumny.
Wyjątek: odpowiedź z szablonu Profil (czym firma się zajmuje) jest wspólnym opisem firmy dla wszystkich bez kredytów – pokazuje się na górze karty, gdy firma nie ma innego opisu.
Uczciwie dla zamawiającego: ma do swojej analizy dostęp zawsze i pozostaje anonimowy. Zwroty za wkład w bazę dostaje każdy, kto coś do niej wnosi: analizy z szablonów, fakty z internetu, stronę WWW znalezioną za kredyty albo zgłoszoną i zatwierdzoną, artykuły z płatnego szukania w mediach, wgrane sprawozdanie. Za każdego innego użytkownika, który skorzysta (odblokuje analizę albo doda firmę do swojej listy), wraca 1 kr. – do połowy tego, co zapłacił, co najmniej 1 kr. Suma zwrotów jest na stronie Twoje kredyty. Twoje własne pytania, notatki do rozmów, ocena dopasowania i wyniki rozmów nigdy nie są dzielone.
Kontakty: do wspólnej bazy trafiają tylko skrzynki i numery firm (biuro@, sprzedaz@, numer centrali). Imienne adresy pracowników (np. jan.kowalski@, piotr@) są odfiltrowywane – to dane osobowe.
Oznaczanie kontaktów
Przy każdym telefonie i e-mailu jest ✕ – „numer nie działa albo nie należy do firmy”, „adres nie działa”. Po zgłoszeniach od dwóch różnych osób kontakt jest przekreślony i przesunięty na koniec dla wszystkich; jedno zgłoszenie to tylko ostrzeżenie. Własne zgłoszenie cofasz przyciskiem ↺. W trybie dzwonienia odbyta rozmowa potwierdza, że numer działa, a wynik „zły numer” przy jedynym numerze zgłasza go automatycznie. „To nie jest strona tej firmy” i „Firma nie działa?” trafiają do administratora – odrzucona strona znika z karty, a crawler nie przyjmie jej ponownie. Kto zgłosił, nie jest pokazywane.
Uzupełnianie danych o firmie
Każdy użytkownik może rozbudować bazę – bez kredytów:
- Strona WWW – „Znasz stronę tej firmy? Zgłoś ją” (albo „Zgłoś inną stronę”). Crawler sprawdza ją od razu (NIP, adres, telefon, nazwa), ale do wyszukiwarki trafia dopiero po zatwierdzeniu przez administratora. Status zgłoszenia widzisz przy polu „Strona WWW”.
- Sprawozdanie finansowe – wgraj plik XML lub ZIP z RDF; plik innej firmy (inny NIP / KRS) zostanie odrzucony. Sprawozdanie od razu widzą wszyscy.
- Wiadomość o firmie – w sekcji Sygnały: „Dodaj wiadomość o firmie” (adres artykułu, tytuł, data). Widzą ją od razu wszyscy użytkownicy; usunąć ją może autor albo administrator. Przycisk Szukaj w mediach wyszukuje artykuły o firmie na żądanie.
Listy i arkusze
Lista działa jak arkusz: wiersze to firmy, kolumny to dane z bazy, kolumny z importu i kolumny, które dodajesz.
Rodzaje kolumn:
- Pytanie AI – krótka odpowiedź z uzasadnieniem i źródłami.
- Ocena 1–10 – AI ocenia firmę według Twojego kryterium; po ocenie sortujesz i filtrujesz.
- Wybór z listy – AI przypisuje jedną z Twoich kategorii.
- Znajdź stronę WWW – szukanie i weryfikacja strony firmy (rejestr, zgadywanie domen, wyszukiwarka).
- Formuła – liczy się sama, jak w Excelu, np.
ZAOKR({Dopasowanie 1-10}*0,6 + {Automatyzacja 1-10}*0,4; 1). Funkcje:JEŻELI,ORAZ,LUB,SUMA,ŚREDNIA,MIN,MAX,ZAOKR,ZŁĄCZ,ZAWIERA,PUSTE,DŁ,MAŁE,WIELKIE,LICZBA(działają też nazwy angielskie:IF,AND,ROUND…). Argumenty oddzielasz średnikiem, ułamki przecinkiem. - Ręczna – wpisujesz sam (status, notatka, handlowiec).
- Wiadomość – AI pisze wiadomość do każdej firmy na podstawie jej profilu, strony i sygnałów, profilu Twojej firmy oraz celu, który wpiszesz („co chcesz zaproponować”). Kanały: e-mail z prośbą o zgodę na kontakt (domyślnie – zgodnie z Prawem komunikacji elektronicznej, bez oferty w treści), e-mail do firmy, która wyraziła zgodę, list na adres firmy, wiadomość LinkedIn, skrypt pierwszego telefonu. Do wyboru ton, długość i język; w komórce temat, po rozwinięciu treść z przyciskiem „Kopiuj”.
Wskazówki:
- W pytaniu możesz odwołać się do innych kolumn w nawiasach klamrowych, np.
{Profil},{Przychody},{Sygnały},{Dotacje UE}, a do opisu własnej firmy przez{Moja firma}. - Uruchom tylko gdy – kolumna przetwarza tylko wiersze spełniające warunek (np.
{Dopasowanie 1-10} >= 7); pominięte wiersze nie kosztują kredytów. - Zakres: zacznij od „test: 3 pierwsze wiersze”, a gdy pytanie działa, kliknij ▶ przy kolumnie, żeby dokończyć resztę.
- 🔄 Odświeżaj (płatne kredytami) – kolumna AI uruchamia się ponownie: codziennie, co tydzień albo gdy firma dostanie nowy sygnał (np. artykuł, dotację, przetarg). Kliknięcie 🔄 w nagłówku zmienia tryb. Odświeżenie kosztuje tyle co zwykły przebieg (błędy są zwracane), komórek zmienionych ręcznie nie nadpisuje, a przy braku kredytów kolumna czeka z komunikatem w podpowiedzi 🔄. Odświeżanie uruchamia się raz dziennie razem z pobieraniem sygnałów.
- ⚡ – kolumna sama przetwarza nowe wiersze. 👁 Obserwuj wyszukiwanie – lista sama dopisuje nowe firmy pasujące do wyszukiwania, z którego powstała.
- Dwuklik na komórce pozwala ją edytować (Enter zapisuje, Esc anuluje); zmienione ręcznie komórki mają znak ✎.
- Import CSV / XLSX (do 5000 wierszy): firmy dopasowujemy po NIP, KRS, REGON, domenie lub e-mailu, a na końcu po nazwie i miejscowości. Wiersze bez dopasowania zostają w eksporcie.
- Eksport CSV listy zawiera kolumny z importu, dane z bazy i wszystkie kolumny AI.
Poziomy agentów i kredyty
Wszędzie, gdzie działa AI (kolumny w arkuszach, wiadomości, przygotowanie rozmowy), wybierasz jeden z trzech poziomów:
| Poziom | Co robi | Kolumna AI / wiadomość | Przygotowanie rozmowy |
|---|---|---|---|
| Solo | dane z bazy i tekst strony zebrany przez crawler; do klasyfikacji i prostych pytań | 1 kr. za wiersz | 2 kr. |
| Duo | dodatkowo czyta do 8 podstron strony firmy (oferta, produkty, park maszynowy, kariera) | 5 kr. | 5 kr. |
| Quattro | dodatkowo sam szuka w internecie (aktualności, przetargi, katalogi branżowe) | 20 kr. | 20 kr. |
Pozostałe: Znajdź stronę WWW – 2 kr. za wiersz, Szukaj w mediach na karcie firmy – 1 kr. (zwrot, gdy nic nie znaleziono). Bez kredytów: profil Twojej firmy ze strony WWW oraz dodawanie stron, sprawozdań i wiadomości o firmach.
Przed każdym działaniem zużywającym kredyty aplikacja pokazuje okno z kosztem i saldem – nic nie jest pobierane bez potwierdzenia. Przy włączaniu odświeżania kolumny i automatycznego uruchamiania dla nowych wierszy okno podaje koszt jednego przebiegu lub jednego wiersza. Koszt rezerwujemy przy uruchomieniu i zwracamy za wiersze pominięte przez warunek oraz za błędy. Saldo widać w nagłówku (kliknięcie otwiera Cennik z pakietami kredytów: Start 500 kr. – 59 zł, Pro 2000 kr. – 199 zł, Zespół 10 000 kr. – 799 zł). Agenci nie podają danych osobowych (imion, nazwisk, prywatnych kontaktów).
Twoje kredyty i płatności
Saldo w nagłówku prowadzi do strony Twoje kredyty: saldo, z czego się składa i do kiedy jest ważne, historia zużycia i płatności.
- Pakiety (Start, Pro, Zespół) kupisz kartą, BLIK-iem lub Przelewy24 – kredyty dopisują się zaraz po płatności i nie wygasają.
- Abonament daje co miesiąc pulę kredytów. Pula z danego miesiąca przechodzi na następny miesiąc, a to, co z niej zostanie, wygasa z jego końcem (np. pula z listopada działa w listopadzie i grudniu). Najpierw zużywamy kredyty, które wygasają najwcześniej; 14 dni przed terminem strona przypomina o wygasających kredytach.
- Faktury, zmiana karty i rezygnacja – przycisk „Faktury, karta i rezygnacja (portal Stripe)”. Po rezygnacji abonament działa do końca opłaconego okresu.
Sygnały zakupowe
Strona Sygnały pokazuje firmy, które właśnie coś zmieniają. Sygnały aktualizujemy automatycznie raz dziennie. Źródła:
- Nowa spółka i zmiana w KRS (kapitał, zarząd, PKD, siedziba, nazwa, likwidacja) – Biuletyn API KRS.
- Wygrany przetarg – e-Zamówienia (BZP) i TED (UE).
- Ogłoszenie o pracę – Centralna Baza Ofert Pracy (bez agencji pracy).
- Pomoc publiczna – SUDOP (UOKiK): dotacje, gwarancje, ulgi, de minimis.
- Dotacja UE – lista projektów Funduszy Europejskich 2021–2027 (aktualizacja co miesiąc).
- Pozwolenie na budowę – rejestr GUNB (wnioski i decyzje; hale, rozbudowy zakładów).
- Rejestracja VAT-UE – VIES (firma zaczyna handel w UE).
- Wiadomość w mediach – artykuły z ostatniego miesiąca o firmach, które mają inne świeże sygnały (Brave News; nazwa firmy musi pojawić się w tytule lub opisie). Każdą firmę sprawdzamy najwyżej raz w tygodniu.
Dotacje UE i pozwolenia nie zawierają NIP, więc dopasowujemy spółki po pełnej nazwie z formą prawną i tylko jednoznacznie. Zaznaczone sygnały dodasz do arkusza; filtr „sygnał w ostatnich N dniach” jest też w wyszukiwarce.
Sprawozdania finansowe
Na karcie firmy, przy sprawozdaniach, wybierz rok, żeby zobaczyć bilans (aktywa i pasywa), rachunek zysków i strat z porównaniem do roku poprzedniego oraz wskaźniki: dynamikę przychodów, rentowność netto i operacyjną, udział kapitału własnego, płynność bieżącą, wynagrodzenia i amortyzację. Kwoty w tysiącach złotych są przeliczane na złote. Przycisk „pokaż wszystkie pozycje” rozwija szczegóły, a oryginalny plik XML można pobrać.
Tryb dzwonienia
Uruchomisz go z listy („📞 Tryb dzwonienia”) albo z menu Dzwonienie (licznik pokazuje firmy z terminem na dziś).
- Kolejka pokazuje jedną firmę naraz: najpierw te z terminem następnego kroku na dziś, potem nowe, od najwyższego priorytetu „komu i dlaczego teraz”.
- Na ekranie są klikalne telefony, e-maile, strona, powody do kontaktu i notatka do rozmowy.
- Po rozmowie wybierz wynik: nie odebrał, oddzwonić, zainteresowany – wysłać ofertę, umówione spotkanie, nie teraz, nie zainteresowany, zły numer. Data następnego kroku podpowiada się sama (np. nie odebrał: jutro, nie teraz: za 90 dni) i możesz ją zmienić.
- Zaznacz zgodę na dalszy kontakt, jeśli rozmówca ją wyraził – zostaje w historii rozmów.
- „Pomiń” odkłada firmę do ponownego otwarcia kolejki. Wynik rozmowy widać w kolumnie „Rozmowa” w arkuszu, a historię na karcie firmy.
Przygotowanie rozmowy
Przycisk Przygotuj rozmowę (na karcie firmy i w trybie dzwonienia) tworzy notatkę AI. Obok wybierasz poziom: Solo (dane z bazy, kilka sekund), Duo (dodatkowo podstrony strony firmy, do minuty) albo Quattro (dodatkowo aktualne fakty z internetu ze źródłami, 1–3 minuty). Notatka zawiera:
- czym firma się zajmuje i jaka jest jej skala,
- powód do kontaktu teraz (z datami sygnałów),
- dopasowanie do Twojej oferty (1–10) z uzasadnieniem,
- o kogo poprosić (rola, nie nazwisko) i zdanie do recepcji,
- pierwsze zdania rozmowy, 3–5 pytań, możliwe zastrzeżenia z odpowiedziami i następny krok.
Notatka powstaje w języku interfejsu na podstawie danych z bazy, strony firmy i profilu Twojej firmy. Fakty sprawdź przed rozmową.
Integracje z CRM
W zakładce Twoja firma → Integracje z CRM połączysz HubSpot (token aplikacji prywatnej) albo Salesforce (aplikacja połączona z OAuth Client Credentials: adres My Domain, Consumer Key, Consumer Secret). Dokładne kroki są opisane przy formularzu.
- Wysyłka firm: w arkuszu „Wyślij zaznaczone do CRM” albo „Wyślij cały arkusz do CRM”, na karcie firmy „Wyślij do HubSpot / Salesforce”. Rekordy nie dublują się: najpierw szukamy po NIP, potem po domenie. Istniejącym rekordom uzupełniamy tylko puste pola, nie nadpisujemy danych handlowców.
- Co trafia do CRM: nazwa, strona, telefon, adres, przychody, opis, NIP, KRS, PKD, priorytet i powody „komu i dlaczego teraz”, link do karty w SalesTT. W HubSpot jako osobne pola w grupie „SalesTT Prospecting”, w Salesforce NIP w polu Account Number, reszta w opisie.
- Wyniki rozmów: po zaznaczeniu „wysyłaj wyniki rozmów” każda rozmowa z trybu dzwonienia trafia do CRM jako notatka (HubSpot) albo zakończone zadanie (Salesforce) – wynik, notatka, następny krok i zgoda na kontakt.
- Przy firmie w arkuszu pojawia się link do rekordu (HS ↗ / SF ↗); ostatnie wysyłki i błędy widać w Integracjach. Dane dostępowe przechowujemy zaszyfrowane.
Claude (MCP)
SalesTT można podłączyć do Claude (Claude Desktop, Claude Code) przez MCP i pytać o bazę zwykłym językiem, np. „znajdź producentów z PKD 25 w śląskim, którzy dostali dotację UE w tym roku, i dodaj ich do listy”, „co nowego u firm z mojej listy Targi ITM?”, „kogo mam dziś oddzwonić?”. Claude korzysta z tych samych danych i limitów co aplikacja: wyszukiwanie firm, karta firmy z „komu i dlaczego teraz”, sygnały, Twoje listy z kolumnami AI, dodawanie firm do list i terminy rozmów.
Połączenie zdalne wymaga klucza API (wydaje go administrator). W Claude Code: claude mcp add --transport http salestt https://app.salestt.com/mcp --header "Authorization: Bearer <klucz>". Instrukcję połączenia lokalnego (Claude Desktop na komputerze z bazą) zawiera README.md.
Szybkie pobieranie sprawozdań z RDF
Repozytorium Dokumentów Finansowych nie ma publicznego API, więc pliki pobiera się w przeglądarce, a resztę robi aplikacja. Tempo: ok. 20–30 sekund na firmę.
Przygotowanie (raz):
- W Chrome: Ustawienia → Pobrane pliki → wyłącz „Pytaj, gdzie zapisać każdy plik”, żeby pliki trafiały od razu do folderu Pobrane.
- Uruchom
obserwuj-sprawozdania.bat(zostaw okno otwarte) – każdy pobrany XML / ZIP ze sprawozdaniem wczyta się sam. - Otwórz dwie karty: Admin → Sprawozdania do pobrania oraz Repozytorium Dokumentów Finansowych (przycisk na tej stronie albo prs.ms.gov.pl → Krajowy Rejestr Sądowy → Przeglądarka dokumentów finansowych).
Dla każdej firmy:
- W kolejce kliknij „Kopiuj KRS”.
- W RDF wklej numer KRS (Ctrl+V) i wyszukaj.
- Na liście dokumentów wybierz najnowsze roczne sprawozdanie finansowe (rok jak w kolumnie „Złożone w KRS”) i otwórz jego szczegóły.
- Pobierz plik sprawozdania w formacie XML albo paczkę ZIP (plik podpisu .xades nie jest potrzebny, ale nie przeszkadza; PDF-y i skany nie zawierają danych do odczytu).
- Wróć do kolejki – po „Odśwież listę” firma zniknie, a na jej karcie pojawi się bilans, rachunek zysków i strat i wskaźniki.
Wskazówki: jedno sprawozdanie zawiera dwa lata (bieżący i poprzedni), więc wystarczy najnowsze; zacznij od firm z Twoich list (są na górze kolejki); jeśli plik trafi do podfolderu „bez-dopasowania”, firmy nie ma w bazie albo sprawozdanie dotyczy innej spółki.
Limity i zasady korzystania z danych
- Miesięczne limity: eksport (domyślnie 500 rekordów) i wyświetlenia kart firm (domyślnie 2000). Stan widać pod formularzem wyszukiwarki.
- Dane kontaktowe pochodzą wyłącznie z CEIDG albo ze stron firm. Wolno ich używać tylko do kontaktu B2B, zgodnie z regulaminem, RODO i Prawem komunikacji elektronicznej.
- Marketing telefonem i e-mailem wymaga uprzedniej zgody odbiorcy. Pierwszy kontakt planuj tak, żeby o tę zgodę zapytać, i zapisuj ją w trybie dzwonienia.
- Przedsiębiorca może zgłosić sprzeciw albo żądanie usunięcia danych przez formularz „Sprzeciw / usunięcie danych”. Firma znika wtedy z wyszukiwarki od razu.
Dla administratora
- Admin → Klucze API i testy wzbogacania – test połączenia z API Anthropic. Administrator wzbogaca arkusze bez kredytów (koszt idzie z klucza API).
- Użytkownicy – zaproszenia (link ważny 7 dni), kredyty, limity, reset hasła, blokada konta.
- Sygnały pobiera serwer automatycznie raz dziennie; użytkownicy widzą datę ostatniej aktualizacji. Administrator może pobrać je ręcznie: przyciskiem Sygnały → Pobierz sygnały teraz (w tle) albo w terminalu poleceniem
python -m prospecting signals– wszystkie źródła naraz, każde z paskiem postępu i podsumowaniem na końcu (--only krs,tenderswybiera źródła,--sequentialuruchamia je po kolei). - E-sprawozdania – wgrywanie plików XML / ZIP z Repozytorium Dokumentów Finansowych (na karcie firmy albo hurtem w panelu). Szybciej: uruchom na komputerze
obserwuj-sprawozdania.bat(obserwuje folder Pobrane) i pracuj z listy Sprawozdania do pobrania (/sprawozdania/do-pobrania, dostępna dla wszystkich użytkowników) – spółki, które złożyły w KRS sprawozdanie, którego jeszcze nie mamy (najpierw z Twoich list). Kopiujesz KRS, pobierasz plik w RDF, a on sam wczytuje się do bazy i trafia do podfolderu „zaimportowane”. RDF nie ma publicznego API i chroni się przed automatami, dlatego samo pobranie zostaje w przeglądarce. - Test crawlerów – dwuklik na
test-crawlerow.bat(albopython -m prospecting crawl-test) sprawdza na próbce z Twojej bazy wszystkie sposoby szukania: zgadywanie domen (300 firm), wyszukiwarkę po NIP-ie i nazwie (100 firm, do 200 zapytań Brave), przeglądarkę (200 stron), kolejkę na żądanie (20 firm) i kontakty z podstron (100 stron). Zwykle trwa 30–60 minut. Wyniki zapisuje jak w normalnej pracy, a w folderzelogs\crawl-test-<data>zostawiapodsumowanie.txtido-sprawdzenia.csv(nowe strony z linkiem i dowodami do ręcznej kontroli). Rozmiary zmienisz opcjami, np.--search 50, etap pominiesz:--skip search. - Opisy firm – „czym firma się zajmuje” pisze AI (tani model, Batch API) na podstawie tekstu strony. Nocny przebieg opisuje do 5000 stron bez opisu (najpierw firmy z list użytkowników);
--describe Nzmienia liczbę,--describe 0wyłącza. Strona znaleziona na żądanie użytkownika albo zatwierdzona w Zgłoszeniach dostaje opis od razu. Ręcznie:python -m prospecting describe. - Kontakty z podstron –
python -m prospecting contactsczyta podstrony kontaktowe potwierdzonych stron, które nie mają telefonu albo e-maila, i dopisuje znalezione dane (bez AI, bez kosztu). Nocny przebieg robi to sam dla 2000 stron (--contacts Nzmienia liczbę,--contacts 0wyłącza). - Wyszukiwarka Brave nie działa?
python -m prospecting brave-checkwysyła jedno zapytanie testowe i mówi, co jest nie tak (klucz, plan, limit). Z--reset-hours 48cofa znacznik „szukana” firmom, przy których żadne zapytanie nie przeszło, więc kolejne wyszukiwanie obejmie je ponownie. - Strony w przeglądarce – część stron pokazuje telefon, adres albo NIP dopiero po uruchomieniu JavaScriptu i zwykły crawler ich nie widzi. Polecenie
python -m prospecting render(albonocny-przebieg.ps1 -Opcje "--render 2000") otwiera je w przeglądarce: najpierw „prawie trafienia” (nazwa pasuje, brak NIP-u), potem potwierdzone strony bez telefonu.--dry-runtylko mierzy, ile by to dało. Wymaga jednorazowopython -m playwright install chromium. - Zgłoszenia → Zgłoszone błędy – „to nie jest strona tej firmy” (Odrzuć stronę / Zgłoszenie bezzasadne) i „firma nie działa” (Zamknij zgłoszenie).
- JDG w wersji podstawowej – jednoosobowe działalności z przemysłu i hurtu (PKD 10–33, 46) widać w wyszukiwarce bez danych osobowych: nazwa bez imienia i nazwiska właściciela, miejscowość, branża, data rozpoczęcia, status VAT, strona WWW i opis. NIP, adres i kontakty są ukryte (także w eksporcie i CRM); kontakt przez stronę firmy. Znany NIP wpisany w wyszukiwarkę znajdzie firmę, ale NIP się nie wyświetli. Pełne dane pojawiają się po wysłaniu informacji z art. 14 albo za zgodą właściciela.
- Zgłoszenia (menu, licznik oczekujących) – strony WWW zgłoszone przez użytkowników z wynikiem automatycznego sprawdzenia (zgodność 0–100, NIP, adres, telefon, tytuł strony): Zatwierdź publikuje stronę w wyszukiwarce, Odrzuć (z powodem) – zgłaszający widzi status, ↻ sprawdza ponownie. Niżej zgody właścicieli JDG, którzy dodali swoją firmę: zatwierdź, gdy konto należy do tej firmy (np. domena e-maila, nazwa).
- Sprzeciwy – ręczne dodanie sprzeciwu lub usunięcia.
- Polecenia konsoli, wdrożenie na serwer i kopie zapasowe opisują
README.mdorazdeploy/README.mdw repozytorium.
API
Dostęp programistyczny: /api/v1 z nagłówkiem Authorization: Bearer <klucz>. Klucz tworzy administrator (python -m prospecting api-token <email>). Dostępne operacje: konto i saldo (/me), poziomy agentów (/levels), wyszukiwanie firm (/companies), listy (tworzenie, import, odczyt), kolumny i komórki, wzbogacanie (/enrichments). Limity są te same co w aplikacji.
Nowości: wyszukiwanie z AI, sygnały, arkusz, CRM
- Wyszukiwanie z AI rozumie warunki z opisu – „tylko firmy z numerem telefonu”, „z e-mailem”, „tylko spółki”, „z Gdańska”, „założone po 2020”, „które wygrały przetarg w ostatnim kwartale”, „z dotacją UE”, „z ISO” itd. zamieniają się w filtry (widać je przy planie i w „Więcej filtrów”, można je zmienić). Zbyt ogólne słowa (np. „import”, „hurtow”) są przekreślone: same nie kwalifikują firmy, tylko podnoszą pozycję.
- „Najlepiej dopasowane” – najpierw firmy, które pasują i kodem PKD, i własnym opisem (nazwa, słowa kluczowe, opis ze strony), potem sam opis albo sam kod PKD. Przełącznik „PKD i opis (najtrafniejsze)” zostawia tylko pierwszą grupę.
- Sygnały: wyszukiwarka – słowa w tytule i szczegółach (przedmiot zamówienia, zamawiający, CPV, program; przecinek = „albo”), konkretna firma po nazwie albo NIP, tylko firmy z wybranej listy, wartość od–do w złotych i sortowanie po wartości.
- Kolumny AI znają Twoją ofertę – profil „Twoja firma” jest dołączany do każdego własnego pytania (np. „czy firma może być zainteresowana moją ofertą”);
{Moja firma}nadal działa. Wyjątek: gotowe szablony, których wynik trafia do wspólnej bazy. - Ręczna kolumna – wartość wpisujesz jednym kliknięciem w komórkę (Enter zapisuje). W kolumnach AI ołówek ✎ w rogu komórki albo dwuklik.
- Profil ze strony WWW – przy polach, które już wypełniłeś, pojawia się propozycja ze strony z przyciskiem „Wstaw”.
- HubSpot / Salesforce – „Eksport do HubSpot” u góry arkusza (cały arkusz; zaznaczone – pod tabelą), „Wyślij do HubSpot” w trybie dzwonienia, a przy notatce „Przygotowanie rozmowy” przycisk, który wysyła firmę razem z notatką. Najpierw połącz CRM: Twoja firma → Integracje.
- Edycja kolumny – ✎ w nagłówku kolumny otwiera jej ustawienia (pytanie, typ odpowiedzi, kategorie, poziom AI, warunek, nazwa, odświeżanie, formuła). „Zakres” decyduje, co dalej: tylko zapisz, uruchom ponownie dla błędów / braku danych / pominiętych, dla 3 pierwszych wierszy (test), wszystkich albo zaznaczonych. Komórek poprawionych ręcznie nie nadpisujemy, chyba że zaznaczysz „nadpisz komórki poprawione ręcznie”. Kredyty jak za nowe wiersze, błędy i pominięte wracają.
- Podstawa kontaktu (jak w HubSpot) – przy każdej firmie zapisujesz podstawę przetwarzania danych (uzasadniony interes – potencjalny / obecny klient, wykonanie umowy, zgoda) oraz zgodę na kontakt marketingowy osobno dla telefonu i e-maila: udzielona, odmowa / wycofana albo brak informacji, z tym jak i kiedy ją uzyskano i kto jej udzielił (stanowisko, bez nazwisk). W trybie dzwonienia przy pierwszym kontakcie z firmą podstawę trzeba wybrać, żeby zapisać wynik rozmowy; potem można ją zmienić na karcie firmy. Każda zmiana zostaje w historii. W arkuszu „⚖ ?” oznacza brak podstawy. Podstawa trafia do eksportu arkusza oraz do HubSpot / Salesforce (pole „Podstawa kontaktu i zgody (SalesTT)” przy firmie i notatka z rozmowy). Dane są prywatne.
Konta użytkowników i uprawnienia (administrator)
- Nowe konto: Admin → Użytkownicy: e-mail, rola (użytkownik / administrator), kredyty powitalne oraz poziomy AI i limity → „Zaproś”. Osoba dostaje link (ważny 7 dni; bez skonfigurowanej poczty link pokazuje się w panelu do przekazania), ustawia hasło i akceptuje regulamin. Z terminala:
python -m prospecting add-user email [--admin]. - Przy każdym koncie: kredyty (± korekta), limity eksportu i kart firm na miesiąc, poziomy AI: Solo / Duo / Quattro włączone lub wyłączone i miesięczny limit zapytań dla każdego poziomu (puste = bez limitu), obok zużycie w tym miesiącu; link do ustawienia hasła, blokada konta.
- Co widzi użytkownik: wyłączony poziom jest wyszarzony w arkuszu (dodawanie i edycja kolumny) i w „Przygotowaniu rozmowy”; przy poziomie z limitem widać, ile zapytań zostało. Zlecenie ponad limit jest odrzucane z komunikatem (także przez API i MCP).
- Zapytanie to jeden wiersz kolumny AI (również dokończenie, ponowne uruchomienie i odświeżanie) albo jedno przygotowanie rozmowy. Wiersze z błędem i pominięte przez warunek oraz nieudane notatki wracają do puli. Limit liczy się od początku miesiąca kalendarzowego. Administrator nie ma ograniczeń.
Weryfikacja dwuetapowa (2FA)
- Gdzie: 🔐 w menu → „Bezpieczeństwo konta”. Pasek na górze strony przypomina o włączeniu, dopóki jej nie masz („Później” ukrywa go do końca sesji).
- Metody: aplikacja uwierzytelniająca (Google / Microsoft Authenticator, 1Password, Bitwarden – zeskanuj kod QR i wpisz kod) albo kod e-mailem przy każdym logowaniu. Po włączeniu dostajesz 10 jednorazowych kodów zapasowych – zapisz je.
- Logowanie: po haśle wpisujesz kod. „Zapamiętaj to urządzenie” – przez 30 dni bez kodu na tym komputerze (listę zaufanych urządzeń wyczyścisz w ustawieniach). Gdy nie masz telefonu: „Wyślij kod e-mailem” albo kod zapasowy.
- Administrator: kolumna „2FA” w Admin → Użytkownicy; „wyłącz 2FA” dla osoby, która zgubiła telefon i kody. W
.env:TWO_FACTOR=1włącza drugi krok (domyślnie tylko na serwerze; lokalnie wyłączony),TWO_FACTOR_REQUIRED=none|admins|all– kto musi ją mieć.