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
Na GitHubie opublikowano przykłady obejścia captcha przy użyciu Pythona i Selenium. Repozytorium zawiera gotowe do użycia skrypty do automatyzacji procesów rozwiązywania captcha, zapewniając łatwą integrację z istniejącymi projektami.
Szybki startInstalacja
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
Option | Default value | Description |
---|---|---|
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 |
defaultTimeout | 120 | Limit 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 |
recaptchaTimeout | 600 | Limit czasu odpytywania reCAPTCHA w sekundach. Definiuje jak długo moduł próbuje uzyskać odpowiedź z punktu końcowego API res.php |
pollingInterval | 10 | Odstę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 zdefiniowaniucallback
dla instancjiTwoCaptcha
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
Opcja | Domyślna wartość | Opis |
---|---|---|
numeric | 0 | Określa, czy captcha zawiera symbole numeryczne lub inne zobacz więcej informacji w dokumentacji interfejsu API |
minLength | 0 | minimalna długość odpowiedzi |
maxLength | 0 | maksymalna długość odpowiedzi |
phrase | 0 | określa, czy odpowiedź zawiera wiele słów, czy nie |
caseSensitive | 0 | określa, czy w odpowiedzi jest rozróżniana wielkość liter |
calc | 0 | definiuje 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 |
- Normal Captcha
- Text Captcha
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- hCaptcha
- KeyCaptcha
- Capy
- Grid
- Canvas
- ClickCaptcha
- Rotate
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
Metoda rozwiązywania FunCaptcha (Arkoselabs). Zwraca token.
result = solver.funcaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
url='https://mysite.com/page/with/funcaptcha',
param1=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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=..., ...)
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