Płatność za rozwiązanie · API

Rozwiązywanie reCAPTCHA v3

CapMonster Cloud to usługa automatycznego rozwiązywania reCAPTCHA v3 przez API. Określ minimalny wynik (minScore), otrzymaj gotowy do użycia token i kontynuuj automatyzację bez ręcznych działań.

Przetestuj za darmo: saldo testowe $0.10 ↓

Czas odpowiedzi API

≤ 2 s

Wskaźnik sukcesu

do 99%

za 1000 tokenów

$ 0.90

Cennik rozwiązywania reCAPTCHA v3

CAPTCHA	Cena (USD)	Powodzenie
reCAPTCHA v3 99%	$ 0.90 1000 tokenów	99%

Czym jest Google reCAPTCHA v3

reCAPTCHA v3 to niewidoczna ochrona Google, która odróżnia prawdziwych użytkowników od botów bez konieczności zaznaczania pola „Nie jestem robotem”. Na stronie działa ukryty skrypt analizujący zachowanie odwiedzającego i zwracający współczynnik zaufania (score) od 0,0 do 1,0. Programista ustala próg, poniżej którego może być wymagana dodatkowa weryfikacja lub blokada, co zapewnia ochronę bez zbędnych działań po stronie użytkownika.

1. Ukryty skrypt

Skrypt załadowany z kluczem witryny działa w tle na każdej stronie, która go używa. Odwiedzający nie widzi pola wyboru i nie wykonuje żadnej czynności.

2. Wynik zaufania

Na podstawie zebranych danych o zachowaniu Google przyznaje odwiedzającemu wynik pokazujący, jak bardzo prawdopodobne jest, że to człowiek. Próg ustala właściciel witryny.

3. Próg serwera

Witryna porównuje wynik z własnym progiem. Poniżej niego może zażądać dodatkowej weryfikacji lub zablokować żądanie.

Przebieg weryfikacji reCAPTCHA v3

Krok 1. Ładowanie skryptu

Strona ładuje skrypt reCAPTCHA v3 z kluczem witryny i wywołuje grecaptcha.execute dla akcji.

Krok 2. Wydanie tokena

Google zwraca token dla tej akcji.

Krok 3. Token na backend

Strona wysyła token na serwer wraz z danymi formularza. Token jest ważny przez około 2 minuty.

Krok 4. Siteverify

Serwer wysyła tajny klucz i token do endpointu siteverify Google.

Krok 5. Sprawdzenie score i action

Serwer sprawdza, że success ma wartość true, score spełnia próg, a action się zgadza. Ważny token z niskim score nadal może zostać odrzucony.

Score reCAPTCHA v3: co oznacza i jak ustawić minScore

Score reCAPTCHA v3 mieści się w zakresie od 0.0 (prawdopodobny bot) do 1.0 (prawdopodobny człowiek). Google sugeruje próg 0.5. Najpierw obserwuj realny ruch, zanim go wymusisz lub zmienisz.

Google obsługuje 11 poziomów score. Darmowy Essentials zwraca 0.1, 0.3, 0.7 i 0.9; po włączeniu rozliczeń dostępne są wszystkie poziomy i kody przyczyn. Score w stagingu i w pierwszym tygodniu może różnić się od produkcji.

Parametr CapMonster Cloud minScore (0.1–0.9) ustawia minimalny score tokena. Dopasuj go do progu witryny; wysokie wartości, np. 0.9, zwiększają liczbę nieudanych prób.

pageAction musi odpowiadać action w grecaptcha.execute. Dozwolone są tylko litery, cyfry, ukośniki i podkreślenia. Witryny mogą odrzucać niedopasowania. Przekazuj zarówno minScore, jak i pageAction.

Zakres score

0.0–1.0

Domyślny próg

0.5

minScore

0.1–0.9

Test score reCAPTCHA v3: jak sprawdzić score

Test score wymaga backendu: score przychodzi w odpowiedzi siteverify.

1. Na stronie testowej użyj site key i wywołaj grecaptcha.execute z action.
2. Wyślij token i tajny klucz z backendu na https://www.google.com/recaptcha/api/siteverify.
3. Porównaj zwrócony score z progiem i zweryfikuj action.

Wypróbuj naszą stronę demo reCAPTCHA v3 bez budowania własnej strony testowej.

Porównanie solverów reCAPTCHA v3

Tabela przedstawia cenę, czas odpowiedzi API i skuteczność rozwiązań czterech usług rozwiązywania reCAPTCHA v3.

Parametr	CapMonster Cloud	2Captcha	CapSolver	DeathByCaptcha
Cena za 1000 rozwiązań (od)	$ 0.90	$1.45	$1.00	$2.89
Czas odpowiedzi API	≤ 2 s	≤ 2 s	< 3 s	≤ 3 s
Skuteczność rozwiązania	do 99%	~77–92%	~95–98%	~64–90%

Zastrzeżenie: 2Captcha, CapSolver i DeathByCaptcha są znakami towarowymi ich właścicieli. CapMonster Cloud nie jest powiązany z tymi podmiotami. Wskaźniki wydajności i porównanie cen opierają się na publicznie dostępnych danych oraz wewnętrznych testach z 28.09.2026.

Przetestuj za darmo

$0.10

Nowi użytkownicy otrzymują $0.10 salda testowego, aby wypróbować CapMonster Cloud.

1. Zarejestruj się w CapMonster Cloud.
2. Napisz do supportu przez czat na żywo lub na support@capmonster.cloud, podając e-mail powiązany z kontem.

Jak rozwiązać reCAPTCHA v3 za pomocą CapMonster Cloud

CapMonster Cloud przyjmuje parametry captchy, przetwarza je na swoich serwerach i zwraca gotowy token. Wstaw ten token do formularza, aby przejść weryfikację bez udziału użytkownika. Zadanie RecaptchaV3TaskProxyless działa na własnych serwerach proxy CapMonster Cloud, więc nie przekazujesz parametrów proxy.

Twój skrypt

CapMonster Cloud API

Strona docelowa

Tworzenie zadania

Na tym etapie przekazujesz swój klucz API, typ captchy i jej parametry. Usługa zwróci unikalny taskId, na podstawie którego później można pobrać wynik.

Wysyłanie żądania API

W żądaniu rozwiązania reCAPTCHA v3 należy podać następujące parametry:

Parametr	Opis
type `string`Wymagany	`RecaptchaV3TaskProxyless`
websiteURL `string`Wymagany	adres strony, na której rozwiązywana jest captcha
websiteKey `string`Wymagany	identyfikator klucza (sitekey) podany na stronie twojej witryny z captchą `https://www.google.com/recaptcha/api.js?render=SITE_KEY` `6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob`
isEnterprise `boolean`Opcjonalny	Dla reCAPTCHA v3 Enterprise ustaw `isEnterprise: true` w `RecaptchaV3TaskProxyless` (true/false lub 1/0). CapMonster Cloud przetwarza to jak `RecaptchaV3EnterpriseTask`.
minScore `double`Opcjonalny	może przyjmować wartość od 0.1 do 0.9
pageAction `string`Opcjonalny	wartość parametru action przekazywana przez widżet ReCaptcha w Google. Wartość domyślna: verify `grecaptcha.execute('site_key', {action: 'login_test'})`

Więcej o parametrach i ich automatycznym pozyskiwaniu znajdziesz w dokumentacji CapMonster Cloud.

Adres do wysyłania zadań:

text

https://api.capmonster.cloud/createTask

Przykład żądania:

json

{
  "clientKey": "API_KEY",
  "task": {
    "type": "RecaptchaV3TaskProxyless",
    "websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
    "websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
    "minScore": 0.3,
    "pageAction": "myverify"
  }
}

Odpowiedź:

json

{
  "errorId":0,
  "taskId":407533072
}

Odebranie wyniku

Po utworzeniu zadania regularnie sprawdzaj status rozwiązania.

Adres do otrzymania wyniku:

text

https://api.capmonster.cloud/getTaskResult

Przykład żądania:

json

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

Odpowiedź:

json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
  }
}

Odpowiedź z userAgent

json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
    "gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
    "cookies": {
      "nocookies": "true"
    }
  }
}

WAŻNE

Na niektórych stronach rozwiązanie zawiera również userAgent. Użyj tego UserAgent przy przesyłaniu tokenu lub potwierdzaniu rozwiązania, nawet jeśli różni się od używanego przez przeglądarkę lub skrypt.

Umieszczenie tokenu na stronie

Otrzymany token (wartość "gRecaptchaResponse") można wstawić do ukrytego pola formularza lub wywołać funkcję JS na stronie w celu potwierdzenia rozwiązania. Po tym serwer przyjmie formularz jako poprawnie wypełniony. Do automatyzacji i testowania wygodnie jest używać Puppeteer, Selenium lub Playwright, które pozwalają emulować działania użytkownika, wstawiać tokeny i wysyłać formularze.

Wypróbuj na stronie demonstracyjnej

Jak znaleźć sitekey i pageAction

Zadanie reCAPTCHA v3 wymaga klucza witryny (websiteKey) i nazwy akcji (pageAction).

1. Kliknij stronę prawym przyciskiem i wybierz Inspect.
2. W Elements lub Network znajdź api.js?render=SITE_KEY. Wartość po render= to websiteKey. reCAPTCHA Enterprise używa enterprise.js?render=SITE_KEY.
3. Znajdź grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION to pageAction. Enterprise używa grecaptcha.enterprise.execute. Jeśli pominięto, zadanie domyślnie używa verify.
4. Przechwyć grecaptcha.execute w przeglądarce headless, np. Playwright, aby zebrać obie wartości. Przykłady w JavaScript, Python i C# znajdziesz w dokumentacji CapMonster Cloud.

Niektóre parametry są generowane na nowo przy każdym załadowaniu strony, dlatego rozwiąż zadanie zaraz po ich zebraniu.

SDK do rozwiązywania reCAPTCHA v3: Python, Node.js, C#

Usługa CapMonster Cloud udostępnia gotowe biblioteki ułatwiające pracę w językach Python, JavaScript (Node.js) oraz C#.

Python

JavaScript

python
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY")  # Podaj swój klucz API CapMonster Cloud
cap_monster_client = CapMonsterClient(options=client_options)
# W razie potrzeby możesz sprawdzić saldo
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
    websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",  # URL Twojej strony z captchą
    websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",  # Zastąp poprawną wartością
    minScore=0.7,  # Minimalny próg współczynnika zaufania
    pageAction="myverify"  # Akcja na stronie
)
async def solve_captcha():
    return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)

Python SDK

Node.js SDK

.NET SDK

Możesz też przetestować rozwiązywanie captcha za pomocą rozszerzenia przeglądarkowego CapMonster Cloud dla Chrome i Firefox.

Do czego zespoły używają solvera reCAPTCHA v3

QA i testy end-to-end

Uruchamiaj scenariusze rejestracji, checkoutu i formularzy w CI/CD z Playwright, Puppeteer lub Selenium na stronach, które należą do Ciebie lub które możesz testować.

Monitoring

Sprawdzaj, czy chronione formularze i endpointy działają po releasach i zmianach progów.

Dane publicznie dostępne

Zbieraj publicznie dostępne dane z otwartych stron z kontrolą opartą na score.

Dostępność

Wspieraj zautomatyzowane scenariusze wspomagające na stronach z niewidocznymi kontrolami botów.

Agenci AI

Agent może poprosić o token przez MCP, gdy scenariusz dojdzie do captchy.

Tylko legalne użycie

Używaj CapMonster Cloud do danych publicznych oraz na stronach, które należą do Ciebie lub które możesz testować. Zbieranie cudzych danych za logowaniem lub paywallem bez zgody jest zabronione.

reCAPTCHA v3 i reCAPTCHA v3 Enterprise

Essentials4 poziomy

0.1 · 0.3 · 0.7 · 0.9

reCAPTCHA Enterprise używa kontroli opartych na score: Essentials zwraca cztery poziomy.

Premium · Enterprise11 poziomów

Przyczyny przypisanej oceny ryzyka

Premium i Enterprise zwracają 11, z podstawowymi i zaawansowanymi powodami explainability.

RecaptchaV3TaskProxylessisEnterprise: true

Dla reCAPTCHA v3 Enterprise ustaw isEnterprise: true w RecaptchaV3TaskProxyless (true/false lub 1/0). CapMonster Cloud przetwarza to jak RecaptchaV3EnterpriseTask.

Przydatne materiały

Zadanie reCAPTCHA v3 Enterprise (docs) (EN)reCAPTCHA v2 vs v3 vs Enterprise (blog) (EN)Wsparcie isEnterprise (blog) (EN)

Weryfikacja tokena reCAPTCHA v3 na własnej stronie

POST https://www.google.com/recaptcha/api/siteverify

secret=YOUR_SECRET_KEY
response=TOKEN

Na własnej stronie wyślij secret i response na https://www.google.com/recaptcha/api/siteverify. Tokeny wygasają po 2 minutach i działają raz. Sprawdź success, score i action; Google sugeruje próg 0.5.

Zobacz Captcha API (Google reCAPTCHA v3) po przykłady Node.js i Python, obsługę błędów oraz działania oparte na score.

Błędy reCAPTCHA v3 i sposoby ich naprawy

Nieprawidłowa strona lub klucz

Captcha nie ładuje się lub zwraca błąd invalid-input-secret.

Przekroczony czas rozwiązania

Serwer nie doczekał się odpowiedzi, zwiększ czas oczekiwania.

Pusty token

Błąd przy przekazywaniu wyniku na stronę.

Odpowiedź success=false

Token wygasł, został użyty ponownie lub sfałszowany. Do diagnostyki włącz logowanie żądań i sprawdzaj pole error-codes w odpowiedzi od Google.

Niski score (np. <0.5)

Może prowadzić do odrzucenia nawet przy success=true, ponieważ Google ocenia zaufanie do użytkownika na podstawie wyniku.

Sprawdź action

Aby upewnić się, że token jest przeznaczony dla konkretnej akcji na stronie

Kody błędów Google siteverify

siteverify · response

{
  "success": false,
  "error-codes": [
    "timeout-or-duplicate"
  ]
}

W razie błędu Google zwraca tablicę error-codes

secretSecret key

missing-input-secret

Brak parametru secret

secretSecret key

invalid-input-secret

Parametr secret jest nieprawidłowy lub źle sformatowany

responseToken

missing-input-response

Brak tokena

responseToken

invalid-input-response

Token jest nieprawidłowy lub źle sformatowany

requestRequest

bad-request

Żądanie jest nieprawidłowe lub źle sformatowane

responseCzas życia tokena

timeout-or-duplicate

Token jest zbyt stary lub został już użyty

Inne captche rozwiązywane przez CapMonster Cloud

Przydatne linki

Dokumentacja reCAPTCHA v3 (EN) →

Dokumentacja reCAPTCHA v3 Enterprise (EN) →

Jak rozwiązać ReCaptcha v3 w Pythonie z użyciem Selenium & CapMonster Cloud (EN) →

Jak rozwiązać ReCaptcha v3 w JavaScripcie z użyciem Selenium & CapMonster Cloud (EN) →

Jak rozwiązać ReCaptcha v3 w C# z użyciem Selenium & CapMonster Cloud (EN) →

Captcha API (Google reCAPTCHA v3): dokumentacja i przewodnik integracji dla programistów (EN) →

Najczęściej zadawane pytania o reCAPTCHA v3

Jaką wartość minScore ustawić dla zadania reCAPTCHA v3?

Parametr minScore przyjmuje wartości od 0.1 do 0.9 i informuje CapMonster Cloud o minimalnym trust score, jaki musi mieć zwracany token. 0.3 to rozsądny punkt wyjścia. Zbyt wysoka wartość (np. 0.9) zwiększa ryzyko błędów rozwiązania; zbyt niska może zwracać tokeny ze score, które i tak powinien odrzucić próg po stronie serwera. Dostosuj wartość do rzeczywistych wskaźników odrzuceń w środowisku testowym.

Jak znaleźć sitekey i action dla zadania reCAPTCHA v3?

Otwórz stronę i znajdź api.js?render=SITE_KEY w inspektorze. Wartość po render= to sitekey. Wartość action znajduje się w wywołaniu grecaptcha.execute(siteKey, {action: "..."}). Możesz przechwycić je automatycznie za pomocą Playwright. Niektóre wartości zmieniają się przy każdym wczytaniu strony, więc utwórz zadanie zaraz po ich zebraniu. Zobacz pełną instrukcję.

Jaki wynik reCAPTCHA v3 jest dobry?

1.0 oznacza najprawdopodobniej prawidłową interakcję, a 0.0 prawdopodobnego bota. Google sugeruje domyślny próg 0.5. Dobry wynik zależy od progu witryny. Ustaw minScore zgodnie z nim i dostosuj wartość do rzeczywistego ruchu. Jak sprawdzić wynik.

Jak długo token reCAPTCHA v3 jest ważny po wydaniu?

Token otrzymany z reCAPTCHA v3 jest ważny około 2 minut. Twój pipeline automatyzacji musi przesłać token na serwer w tym oknie; po wygaśnięciu endpoint siteverify Google zwraca success: false. Wykonuj krok rozwiązania jak najbliżej wysyłki formularza i nie cache'uj tokenów między żądaniami.

Token można zweryfikować tylko raz. Wygasły lub użyty token powoduje timeout-or-duplicate. Pobieraj nowy token dla każdego wysłania formularza.

Jak wstrzyknąć token reCAPTCHA v3 za pomocą Playwright, Puppeteer lub Selenium?

Aby wstrzyknąć token reCAPTCHA v3, znajdź ukryte pole odpowiedzi (zwykle textarea lub input z ID g-recaptcha-response) i wstaw token otrzymany z usługi rozwiązywania CAPTCHA. Oto jak to zrobić w trzech frameworkach automatyzacji.

Playwright / Puppeteer (Node.js)

javascript

const token = "YOUR_TOKEN";
await page.evaluate((t) => {
  document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');

Selenium (Python)

python

token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()

Niektóre strony używają funkcji callback do walidacji tokenu. Jeśli formularz się nie wysyła, znajdź nazwę funkcji w konsoli (___grecaptcha_cfg.clients) i wywołaj ją ręcznie:

javascript

await page.evaluate((t) => {
  window.onSuccessCallback(t);
}, token);

Dlaczego reCAPTCHA v3 zwraca success=true, ale nadal odrzuca moje żądanie?

Odpowiedź success: true od Google oznacza tylko, że token jest ważny. Twój backend może nadal odrzucić żądanie, jeśli score tokenu jest poniżej skonfigurowanego progu.

Innym częstym problemem jest niezgodność action. Token musi być weryfikowany z tą samą wartością action, która została użyta przy tworzeniu zadania.

Aby zdiagnozować problem:

sprawdź pole score w odpowiedzi siteverify;
upewnij się, że wartość action się zgadza;
sprawdź error-codes, gdy success jest false.

Gdy success jest true, tablica error-codes jest zwykle pusta — główne pola do sprawdzenia to score i action.

Czy CapMonster Cloud rozwiązuje reCAPTCHA v3 Enterprise?

Tak. Dodaj isEnterprise: true do zadania reCAPTCHA v3 (dozwolone wartości: true/false lub 1/0). Jest ono przetwarzane tak jak RecaptchaV3EnterpriseTask. Szczegóły znajdziesz w sekcji powyżej i dokumentacji API.

Żadne narzędzie nie gwarantuje 100% skuteczności wobec zmieniających się zabezpieczeń, ale CapMonster Cloud zapewnia wysoką skuteczność rozwiązywania reCAPTCHA v3. Dane opierają się na wewnętrznych comiesięcznych testach porównawczych zespołu CapMonster Cloud. Rzeczywisty czas odpowiedzi API i skuteczność zależą od witryny docelowej, obciążenia serwera oraz warunków sieciowych.

reCAPTCHA jest znakiem towarowym Google LLC. CapMonster Cloud nie jest powiązany z Google ani przez Google zatwierdzony. Usługa służy do pracy z publicznie dostępnymi danymi, testowania własnych lub autoryzowanych witryn, rozpoznawania obrazów i zapewniania dostępności. Zbieranie bez zgody danych osób trzecich chronionych logowaniem lub płatnym dostępem jest zabronione; nie dotyczy to własnych kont. Przed rozpoczęciem pracy użytkownik ustala status prawny swoich danych.