1. Ogólne wymagania

• Program musi uruchamiać się ręcznie, działać lokalnie na Windows.

• Używać rzeczywistej przeglądarki Chrome, uruchamiać ją z istniejącymi profilami użytkowników.

• Zabezpieczyć maksymalną imitację zachowania człowieka (opóźnienia, kliknięcia, nawigacja).

• Zabronione jest używanie trybów headless, Selenium/WebDriver, zapytań API, proxy, wielowątkowego równoczesnego uruchamiania.

• Wyniki zapisywać do pliku CSV w odpowiednich kolumnach.

• Program obsługuje do 20 kont podczas jednego uruchomienia.

2. Parametry wejściowe (plik settings.json)

jsonCopyEdit
{
  "chrome_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
  "profiles": [
    {
      "user_data_dir": "C:\\Users\\User\\AppData\\Local\\Google\\Chrome\\User Data",
      "profile_dir": "Profile 1"
    },
    ...
  ],
  "rewards_url": "https://threeplus.three.co.uk/rewards",
  "csv_path": "C:\\path\\to\\accounts.csv",
  "delay_range_seconds": [90, 240]
}

• chrome_path – pełna ścieżka do chrome.exe.

• profiles – tablica obiektów z dwoma parametrami: user_data_dir (katalog główny Chrome) i profile_dir (folder profilu).

• rewards_url – aktualny URL strony z nagrodami.

• csv_path – pełna ścieżka do pliku CSV z kontami.

• delay_range_seconds – tablica z dwoma liczbami, określająca minimalne i maksymalne losowe opóźnienie między działaniami (w sekundach).

3. Format pliku CSV

• Plik zawiera co najmniej następujące kolumny:

  • account — unikalny identyfikator konta (email, login lub inny).

  • code — kolumna do zapisu otrzymanego kodu (początkowo pusta).

4. Logika działania programu

1. Wczytanie konfiguracji

   • Program odczytuje settings.json.

   • Sprawdza dostępność Chrome pod ścieżką chrome_path.

   • Wczytuje listę profili.

2. Wczytanie CSV

   • Odczytuje plik CSV.

   • Wskazuje konta z pustym polem code (nieprzetworzone).

3. Przetwarzanie kont

   • Dla każdego nieprzetworzonego konta (do 20 na jedno uruchomienie) wykonuje:
     a. Uruchamia Chrome przez subprocess z parametrami:

     iniCopyEdit
     --user-data-dir<user_data_dir>  
     --profile-directory<profile_dir>  
     --remote-debugging-port=9222
     

     b. Łączy się z przeglądarką przez CDP (Playwright/Puppeteer).
     c. Przechodzi na stronę rewards_url.
     d. Czeka na pełne załadowanie strony.
     e. Kliknięcie przycisku Get Reward.
     f. Jeśli pojawi się okno modalne z kodem — odczytuje kod (tekstowo lub OCR, jeśli trzeba).
     g. Jeśli jest link Go to My Codes — przechodzi tam i odczytuje kod.
     h. Zapisuje kod do odpowiedniej kolumny code w pliku CSV.
     i. Zamknij przeglądarkę, nie wychodząc z profilu (przeglądarka musi być całkowicie zamknięta).
     j. Czeka losowe opóźnienie w zakresie delay_range_seconds przed kolejnym kontem.

4. Zakończenie pracy

   • Po przetworzeniu do 20 kont zapisuje zaktualizowany CSV.

   • Zakończenie działania.

5. Ważne zakazy

6. Zalecane technologie

7. Dodatkowe wymagania

• Logowanie działań dla diagnostyki (zapis do osobnego pliku log).

• Obsługa błędów: poprawne zakończenie pracy przy awariach, możliwość ponownego uruchomienia od miejsca zatrzymania.

• Zwięzły i zrozumiały interfejs wiersza poleceń (np. informowanie o aktualnym koncie, statusie przetwarzania).

Oto końcowa zaktualizowana treść specyfikacji technicznej, już z uwzględnieniem wszystkich poprawek, obejmująca jedyny sposób uzyskania kodu przez "My Codes", bez OCR i okien modalnych:

🎯 Cel

Stworzyć program desktopowy (w Pythonie lub Node.js), który automatycznie otwiera rzeczywiste profile Chrome, loguje się na 20 kontach Three+, klika Get Reward, przechodzi do My Codes, wyciąga kod w formacie TH3DC\d{9,} i dodaje go do odpowiedniego wiersza CSV.

⚙️ Funkcjonalność

• Uruchamia się ręcznie na Windows (bez automatycznego uruchamiania lub usług).

• Działa przez prawdziwy Chrome z lokalnymi profilami (user-data-dir + profile-directory).

• Nie używa trybu headless, Selenium, żądań HTTP ani proxy.

• Imituje działania ludzkie: uruchomienie przeglądarki, kliknięcia, przejścia, pauzy.

• Obsługuje do 20 kont na jedno uruchomienie (określane w konfiguracji).

• Pomija konta, które mają już kod w CSV.

🔄 Algorytm działania

Krok 1: Załadowanie konfiguracji

• Wczytuje settings.json (ścieżka do Chrome, lista profili, ścieżka CSV, opóźnienia).

• Wczytuje CSV, identyfikuje konta bez kodu.

Krok 2: Przetwarzanie każdego profilu

1. Uruchamia Chrome z podanym profilem:

   iniCopyEdit--user-data-dir=<user_data_dir>
   --profile-directory=<profile_dir>
   --remote-debugging-port=9222

2. Łączy się przez CDP (Playwright lub Puppeteer).

3. Otwiera rewards_url.

4. Czeka na pełne załadowanie strony.

5. Kliknięcie przycisku Get Reward (prawdziwy klik, nie .click()): rzeczywisty klik (przez Playwright/Puppeteer z mouse.move + mouse.down + mouse.up, bez .click()).

6. Czeka 3–5 sekund.

Krok 3: Odczyt kodu z My Codes

7. Przechodzi na stronę https://threeplus.three.co.uk/my-rewards
   (lub klika Go to my codes, jeśli pojawiła się po Get Reward).

8. Szukuje ostatniego kodu w formacie TH3DC\d{9,} w DOM (przez innerText / textContent).

9. Zapisuje w CSV w formacie:

   CopyEditProfile_01,TH3DC103897998490

10. Zamyka przeglądarkę (ale nie wylogowuje się z konta).

11. Czeka losowe opóźnienie (20–40 sekund).

12. Powtarza do 20 kont.

🧠 Jak dokładnie odczytywany jest kod (jasny algorytm)

• OCR, zrzuty ekranu i okna modalne nie są używane.

• Kod zawsze odczytywany jest ze strony My Codes - po kliknięciu "Get Reward"

• Wygląd kodu: TH3DC103897998490 (wzorzec: TH3DC\d{9,}).

• Odczyt: przez DOM (innerText, textContent, evaluate()).

⚙️ Konfiguracja (settings.json)

jsonCopyEdit{
  "chrome_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
  "profiles": [
    {
      "user_data_dir": "C:\\Users\\User\\AppData\\Local\\Google\\Chrome\\User Data",
      "profile_dir": "Profile 1"
    }
    // ...
  ],
  "rewards_url": "https://threeplus.three.co.uk/rewards",
  "csv_path": "C:\\path\\to\\accounts.csv",
  "delay_range_seconds": [90, 240]
}

📄 Format CSV

csvCopyEditaccount,code
profile_01,
profile_02,

• account — identyfikator profilu

• code — pole, do którego wpisywany będzie otrzymany kod

🚫 Zabronione

📦 Oczekiwane pliki wyjściowe

• .exe dla Windows (1 plik).

• Pełny kod źródłowy z komentarzami.

• README.md z instrukcją.

• Przykład settings.json.

🛠️ Zalecane technologie