Powiadomienie o wykorzystaniu plików cookie

Ta strona używa plików cookie. Pliki cookie zapamiętują Cię, dzięki czemu możemy świadczyć Ci spersonalizowane usługi. Dowiedz się więcej.

Pomiń captcha w Pythonie

Pomiń captcha w Pythonie

Zintegruj pakiet Pythona do automatycznego rozwiązywania captcha w dowolnej witrynie.

Pakiet Pythona do łatwej integracji z API usługi rozwiązywania captcha 2Captcha w celu ominięcia reCAPTCHA, hCaptcha, funcaptcha_link>funcapte_solve_solve i rozwiąż inne captcha

Szybki start

Instalacja

Pakiet skryptu można zainstalować za pomocą instalatora pakietu lub ręcznie

Pip

Aby automatycznie zainstalować pakiet biblioteki, musisz użyć standardowego rozwiązania pakietowego Pythona - Pip. Pobierz go z linku i zainstaluj zgodnie z instrukcjami. Po zainstalowaniu aplikacji użyj polecenia:

pip3 install 2captcha-python

Zapraszamy do zapoznania się z naszym repozytorium GitHub, w którym można znaleźć biblioteki i moduły dla łatwa integracja z naszym API.

Konfiguracja

Opis wszystkich niezbędnych parametrów do konfiguracji zainstalowanego pakietu

Instancję klasy TwoCaptcha można utworzyć w następujący sposób:

from twocaptcha import TwoCaptcha

solver = TwoCaptcha('YOUR_API_KEY')

Masz również możliwość dostosowania niektórych opcji dla tworzonej instancji:

config = {
            'server':           '2captcha.com',
            'apiKey':           'YOUR_API_KEY',
            'softId':            123,
            'callback':         'https://your.site/result-receiver',
            'defaultTimeout':    120,
            'recaptchaTimeout':  600,
            'pollingInterval':   10,
        }
solver = TwoCaptcha(**config)
Opcje instancji TwoCaptcha
OptionDefault valueDescription
serwer'2captcha.com'Serwer API. Możesz ustawić go na 'rucaptcha.com', jeśli Twoje konto jest tam zarejestrowane
softId-Twój identyfikator oprogramowania uzyskany po opublikowaniu w 2Captcha software catalog
callback-Adres URL Twojego serwera WWW, który otrzymuje wynik rozpoznawania captcha. Adres URL należy najpierw zarejestrować w ustawieniach pingback na swoim koncie
defaultTimeout120Limit czasu odpytywania w sekundach dla wszystkich typów captcha z wyjątkiem reCAPTCHA. Definiuje jak długo moduł próbuje uzyskać odpowiedź z punktu końcowego API res.php
recaptchaTimeout600Limit czasu odpytywania reCAPTCHA w sekundach. Definiuje jak długo moduł próbuje uzyskać odpowiedź z punktu końcowego API res.php
pollingInterval10Odstęp w sekundach między żądaniami do punktu końcowego API res.php, ustawianie wartości mniejszych niż 5 sekund nie jest zalecane
WAŻNE: po zdefiniowaniu callback dla instancji TwoCaptcha wszystkie metody zwracają tylko identyfikator captcha i NIE odpytuj interfejsu API, aby uzyskać wynik. Wynik zostanie wysłany na adres URL wywołania zwrotnego. Aby uzyskać odpowiedź ręcznie, użyj metody getResult

Rozwiąż test captcha

Gdy przesyłasz obraz captcha, użycie captcha może zapewnić dodatkowe opcje, które pomogą pracownikom 2Captcha w prawidłowym rozwiązaniu problemu

Opcje captcha
OpcjaDomyślna wartośćOpis
numeric0Określa, czy captcha zawiera symbole numeryczne lub inne zobacz więcej informacji w dokumentacji interfejsu API
minLength0minimalna długość odpowiedzi
maxLength0maksymalna długość odpowiedzi
phrase0określa, czy odpowiedź zawiera wiele słów, czy nie
caseSensitive0określa, czy w odpowiedzi jest rozróżniana wielkość liter
calc0definiuje captcha wymaga obliczeń
lang-definiuje język captcha, zobacz listę obsługiwanych języków
hintImg-obrazek z podpowiedzią pokazywany pracownikom za pomocą captcha
hintText-podpowiedź lub tekst zadania pokazywany pracownikom za pomocą captcha
simpleCaptcha

Aby ominąć normalne captcha (zniekształcony tekst na obrazie), użyj następującej metody. Ta metoda może być również używana do rozpoznawania dowolnego tekstu na obrazie.

result = solver.normal('path/to/captcha.jpg', param1=..., ...)
textCaptcha

Ta metoda może służyć do ominięcia captcha, która wymaga odpowiedzi na pytanie podane w postaci zwykłego tekstu.

result = solver.text('If tomorrow is Saturday, what day is today?', param1=..., ...)
recaptchaV2

Użyj tej metody, aby rozwiązać reCAPTCHA V2 i uzyskać token, aby ominąć ochronę.

result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  url='https://mysite.com/page/with/recaptcha',
  param1=..., ...)
recaptchaV3

Ta metoda zapewnia solver reCAPTCHA V3 i zwraca token.

result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  url='https://mysite.com/page/with/recaptcha',
  version='v3',
  param1=..., ...)
funCaptcha

Metoda rozwiązywania FunCaptcha (Arkoselabs). Zwraca token.

result = solver.funcaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
  url='https://mysite.com/page/with/funcaptcha',
  param1=..., ...)
geeTest

Metoda rozwiązywania GeeTest puzzle captcha. Zwraca zestaw tokenów w formacie JSON.

result = solver.geetest(gt='f1ab2cdefa3456789012345b6c78d90e',
  challenge='12345678abc90123d45678ef90123a456b',
  url='https://www.site.com/page/',
  param1=..., ...)
hCaptcha

Użyj tej metody, aby rozwiązać wyzwanie hCaptcha. Zwraca token, aby ominąć captcha.

result = solver.hcaptcha(sitekey='10000000-ffff-ffff-ffff-000000000001',
  url='https://www.site.com/page/', 
  param1=..., ...)
keyCaptcha

Oparta na tokenach metoda rozwiązywania KeyCaptcha.

result = solver.keycaptcha(s_s_c_user_id=10,
    s_s_c_session_id='493e52c37c10c2bcdf4a00cbc9ccd1e8',
    s_s_c_web_server_sign='9006dc725760858e4c0715b835472f22-pz-',
    s_s_c_web_server_sign2='2ca3abe86d90c6142d5571db98af6714',
    url='https://www.keycaptcha.ru/demo-magnetic/', 
    param1=..., ...)
capy

Oparta na tokenach metoda ominięcia Capy puzzle captcha.

result = solver.capy(sitekey='PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
  url='http://mysite.com/',
  api_server='https://jp.api.capy.me/',
  param1=..., ...)
grid

Metoda siatki jest pierwotnie nazywana starą metodą reCAPTCHA V2. Metodę można wykorzystać do pominięcia dowolnego typu captcha, w którym można zastosować siatkę do obrazu i kliknąć określone pola siatki. Zwraca numery pudełek.

result = solver.grid('path/to/captcha.jpg', param1=..., ...)
canvas

Metodę Canvas można zastosować, gdy trzeba narysować linię wokół obiektu na obrazie. Zwraca zestaw współrzędnych punktów do narysowania wielokąta.

result = solver.canvas('path/to/captcha.jpg', param1=..., ...)
clickCaptcha

Metoda ClickCaptcha zwraca współrzędne punktów na obrazie captcha. Może być użyty, jeśli musisz kliknąć w określone punkty na obrazie.

result = solver.coordinates('path/to/captcha.jpg', param1=..., ...)
rotateCaptcha

Tej metody można użyć do rozwiązania captcha, które prosi o obrócenie obiektu. Używany głównie do ominięcia FunCaptcha. Zwraca kąt obrotu.

result = solver.rotate('path/to/captcha.jpg', param1=..., ...)

Inne metody

Dodatkowe poprawne metody stosowane podczas pracy nad głównymi skryptami

send / getResult

Te metody mogą być używane do ręcznego przesyłania captcha i odpytywania odpowiedzi.

import time
. . . . . 

id = solver.send(file='path/to/captcha.jpg')
time.sleep(20)

code = solver.get_result(id)

balance

Użyj tej metody, aby uzyskać saldo swojego konta.

balance = solver.balance()

report

Użyj tej metody, aby zgłosić dobrą lub złą odpowiedź captcha.

solver.report(id, True) # captcha solved correctly
solver.report(id, False) # captcha solved incorrectly

Obsługa błędów

Możliwe warianty standardowych błędów zwracanych przez usługę podczas przetwarzania żądań

W przypadku błędu solver captcha zgłasza wyjątek. Ważne jest, aby właściwie obsługiwać takie przypadki. Zalecamy użycie try/except do obsługi wyjątków.

Try:
    result = solver.text('If tomorrow is Saturday, what day is today?')
Except ValidationException as e:
    # invalid parameters passed
  print(e)
Except NetworkException as e:
  # network error occurred
  print(e)
Except ApiException as e:
  # api respond with error
  print(e)
Except TimeoutException as e:
  # captcha is not solved so far
  print(e)

Pełnomocnicy

Możesz przekazać swoje proxy jako dodatkowe argumenty dla metod: recaptcha, funcaptcha i geetest. Proxy zostanie przekazane do API w celu rozwiązania captcha.

proxy={
    'type': 'HTTPS',
    'uri': 'login:password@IP_address:PORT'
}

Połączenia asynchroniczne

Możesz także wykonywać połączenia asynchroniczne za pomocą asyncio, na przykład:

import asyncio
import concurrent.futures
from twocaptcha import TwoCaptcha

captcha_result = await captchaSolver(image)

async def captchaSolver(image):
    loop = asyncio.get_running_loop()
    with concurrent.future.ThreadPoolExecutor() as pool:
        result = await loop.run_in_executor(pool, lambda: TwoCaptcha(API_KEY).normal(image))
        return result

Inne języki do integracji z API usługi