filmod Playbook za 39 zł

Darmowy poradnik / Automatyzacja firmy

Agent do researchu klientów w Claude Code

Profil klienta idealnego, subagent do researchu firm z publicznych źródeł, tabela z oceną dopasowania i szkice wiadomości z myślą o polskim prawie.

Słowo z filmu: klienci · około 3 min czytania

Filip Modzelewski

Pokazuję po polsku, jak budować z AI: Claude, Claude Code i automatyzacje.

Napisz

Szukanie klientów to w dużej części czytanie: stron firm, ogłoszeń, rejestrów. Tę część możesz oddać agentowi w Claude Code. Agent sprawdza firmy w publicznych źródłach, zapisuje notatki z linkami i ocenia dopasowanie. Decyzję, do kogo się odezwać i co napisać, podejmujesz ty. Poradnik jest dla freelancera albo małej firmy usługowej B2B. Nie masz jeszcze Claude Code? Zacznij od Claude Code od zera.

Co zbudujesz

klienci/
  klient-idealny.md          kogo szukasz i jak oceniasz
  prospekty.csv              jedna tabela wszystkich firm
  notatki/<firma>.md         jedna notatka na firmę, ze źródłami
  szkice/<firma>.md          szkice pierwszej wiadomości
  .claude/agents/research-firm.md
  .claude/skills/pierwsza-wiadomosc/SKILL.md

Krok 1: profil klienta idealnego

Bez profilu agent przyniesie przypadkowe firmy. Uzupełnij szablon własnymi słowami:

# Klient idealny

## Moja usługa
Co robię, w jednym zdaniu. Jaki problem klienta rozwiązuję.

## Kogo szukam
- Branże:
- Region:
- Wielkość: (np. zespół kilku-kilkunastu osób, własna strona, aktywność w sieci)
- Sygnały potrzeby: (np. oferty pracy na stanowisko, które moja usługa częściowo zastępuje)

## Kogo pomijam
- (np. firmy w trakcie likwidacji, branże, z którymi nie pracuję)

## Skala dopasowania 1-5
5 - wszystkie kryteria i wyraźny sygnał potrzeby
4 - prawie wszystkie kryteria, sygnał potrzeby pośredni
3 - pasuje branża i wielkość, brak sygnału potrzeby
2 - pasuje jedno kryterium
1 - nie pasuje

Skala jest twoja. Ważne, żeby była zapisana, bo wtedy oceny z różnych tygodni da się porównać.

Krok 2: subagent do researchu

Subagent to plik Markdown w .claude/agents/ z nagłówkiem (name, description, opcjonalnie tools) i instrukcją w treści. Pracuje we własnym kontekście, więc wyniki wyszukiwania nie zapychają głównej rozmowy. Szczegóły są w dokumentacji subagentów, a o całych zespołach agentów jest poradnik Pierwszy zespół agentów.

Plik .claude/agents/research-firm.md:

---
name: research-firm
description: Sprawdza jedną firmę w publicznych źródłach i zapisuje notatkę ze źródłami. Użyj przy researchu potencjalnych klientów.
tools: WebSearch, WebFetch, Read, Write
---

Najpierw przeczytaj klient-idealny.md.

Zasady:
- Tylko publiczne źródła: strona firmy, KRS lub CEIDG, ogłoszenia firmy, artykuły. Nie loguj się, nie omijaj zabezpieczeń. Gdy regulamin serwisu zabrania automatycznego pobierania danych, pomiń ten serwis.
- Zbierasz dane o firmie, nie o ludziach. Imię i nazwisko tylko wtedy, gdy ktoś publicznie występuje jako kontakt firmy. Żadnych prywatnych profili, numerów ani informacji o życiu prywatnym.
- Każdy fakt ma link. Czego nie ma w źródłach, wpisz "brak danych". Nie zgaduj.

Zapisz notatki/<nazwa-firmy>.md:

# <Nazwa firmy>
Data researchu: RRRR-MM-DD
## Czym się zajmują
## Sygnały wielkości
## Dlaczego mogą potrzebować usługi
## Publiczny kanał kontaktu (formularz, ogólna skrzynka firmy)
## Źródła

Na koniec zwróć jeden wiersz CSV według nagłówka z prospekty.csv.

Narzędzia WebSearch i WebFetch są wbudowane w Claude Code (lista narzędzi). Domyślnie Claude pyta o zgodę przed ich użyciem. W liście nie ma narzędzi do poczty ani wiadomości i tak ma zostać: ten agent tylko czyta i notuje.

Krok 3: jedna tabela

Plik prospekty.csv zaczyna się od nagłówka:

firma,strona,branza,region,sygnaly_wielkosci,dopasowanie,powody_oceny,kanal_kontaktu,notatka,status,data_researchu

dopasowanie to liczba ze skali 1-5, a powody_oceny to jedno zdanie, które ją uzasadnia. status przyjmuje kilka stałych wartości: nowy, szkic, kontakt, odrzucony. Wiersze do tabeli dopisuje główna rozmowa, z wyników subagentów, więc kilka równoległych researchów nie nadpisze sobie pliku.

Krok 4: szkice wiadomości, nigdy wysyłka

Szkice robi skill uruchamiany tylko ręcznie. Pole disable-model-invocation: true sprawia, że Claude nie włączy go automatycznie, a ty wywołujesz go komendą /pierwsza-wiadomosc (dokumentacja skilli). Więcej o skillach znajdziesz w poradniku Skille do Claude.

Plik .claude/skills/pierwsza-wiadomosc/SKILL.md:

---
name: pierwsza-wiadomosc
description: Pisze szkic pierwszej wiadomości do firmy z prospekty.csv na podstawie jej notatki.
disable-model-invocation: true
---

Dla firm ze statusem "nowy" i dopasowaniem 4 lub 5:
1. Przeczytaj notatkę firmy i klient-idealny.md.
2. Zapisz szkic w szkice/<nazwa-firmy>.md. Najwyżej 5 zdań, po polsku, bez przymiotników typu "najlepszy".
3. Pierwsza wiadomość nie jest reklamą: bez oferty, cennika, rabatów i linków sprzedażowych. Jedno konkretne pytanie związane z tym, co firma publicznie napisała.
4. Dopisz: skąd mam adres, że zapisuję tylko nazwę firmy i ten kanał kontaktu, i że na prośbę usunę te dane.
5. Zmień status na "szkic". Niczego nie wysyłaj.

Szkic czytasz, poprawiasz i ewentualnie wysyłasz ręcznie. Przeczytaj najpierw sekcję o prawie, bo od niej zależy, czy w ogóle możesz napisać.

Krok 5: cotygodniowa rutyna

Raz w tygodniu uruchom claude w folderze klienci i wklej:

Cotygodniowy research klientów.
1. Przeczytaj klient-idealny.md i prospekty.csv.
2. Znajdź do 10 nowych firm pasujących do profilu, których nie ma w tabeli.
3. Dla każdej uruchom subagenta research-firm. Dopisz zwrócone wiersze do prospekty.csv.
4. Usuń notatki i wiersze firm ze statusem "odrzucony" starsze niż miesiąc.
5. Pokaż tabelę firm z dopasowaniem 4-5 i powodami oceny. Nie pisz szkiców, nie wysyłaj niczego.

Szkice robisz osobno, komendą /pierwsza-wiadomosc, po przejrzeniu listy.

Prawo: przeczytaj, zanim napiszesz do kogokolwiek

To nie jest porada prawna. Przed startem skonsultuj swój sposób kontaktu z prawnikiem.

Publiczne źródła i regulaminy. Że coś jest w sieci, nie znaczy, że wolno to automatycznie pobierać. Szanuj regulaminy serwisów.

RODO dotyczy też danych publicznych. Imię i nazwisko, imienny e-mail czy telefon to dane osobowe, nawet gdy leżą na stronie firmy. Przy jednoosobowej działalności dane firmy to często dane konkretnej osoby. UODO nałożyło karę na firmę, która zbierała dane przedsiębiorców z publicznych rejestrów i nie informowała ich o tym, a NSA podtrzymał ten kierunek (komunikat UODO). W praktyce:

Zgoda na informację handlową. Od 10 listopada 2024 r. obowiązuje Prawo komunikacji elektronicznej. Jego art. 398 zakazuje używania urządzeń końcowych, w tym e-maila, telefonu i komunikatorów, do przesyłania informacji handlowej, także marketingu bezpośredniego, bez uprzedniej zgody odbiorcy. Zastąpił on dawny art. 10 ustawy o świadczeniu usług drogą elektroniczną (uchylony) i art. 172 Prawa telekomunikacyjnego (uchylonego w całości). Zakaz dotyczy także firm, nie tylko osób prywatnych, a naruszenie jest czynem nieuczciwej konkurencji (tekst ustawy). Informacja handlowa to wszystko, co bezpośrednio lub pośrednio promuje twoje usługi albo wizerunek, więc zimny e-mail z ofertą czy telefon sprzedażowy bez zgody odpadają.

Bezpieczniejsze pierwsze kroki:

Granica między pytaniem a reklamą nie zawsze jest oczywista, a prawnicy różnie oceniają na przykład prośbę o zgodę wysłaną e-mailem. Ofertę wysyłaj dopiero wtedy, gdy ktoś o nią poprosi.

Od czego zacząć

Wypełnij klient-idealny.md, dodaj subagenta i przetestuj go na trzech firmach, które już znasz. Sprawdź, czy każdy fakt w notatce ma działający link. Dopiero potem uruchom cotygodniową rutynę.

Więcej darmowych poradników

Wszystkie