Dołącz i otrzymaj bezpłatny okres próbny!

python captcha solver

Python to wysokopoziomowy, interpretowany język programowania. Jest znany ze swojej prostoty i czytelności. Jest to wszechstronny język, który można wykorzystać do tworzenia stron internetowych, analizy danych, sztucznej inteligencji i innych.

Zintegruj nasz pakiet Python captcha solver, aby automatycznie rozwiązywać CAPTCHA na dowolnej stronie internetowej.

Łatwa integracja z API usługi rozwiązywania captcha w celu pominięcia reCAPTCHA i rozwiązania dowolnego innego CAPTCHA

Instalacja

Zainstaluj NextCaptcha Python SDK za pomocą pip lub ręcznie

PIP

Aby zainstalować NextCaptcha Python SDK, możesz użyć pip (zalecane) lub zainstalować go ręcznie.

1. Zainstaluj za pomocą pip (zalecane)#

Jeśli pakiet NextCaptcha SDK został opublikowany na platformie PyPI, możesz go zainstalować za pomocą następującego polecenia:
pip install nextcaptcha-python
Lub jeśli jest hostowany na GitHub:
pip install git+https://github.com/nextcaptcha/nextcaptcha-python.git

2. Instalacja ręczna#

Jeśli masz zestaw SDK w postaci pliku lokalnego lub archiwum ZIP, wykonaj następujące kroki:

Step 1: Pobierz SDK#

  • Klonuj repozytorium:
git clone https://github.com/nextcaptcha/nextcaptcha-python.git
cd nextcaptcha-python
LUB
  • Pobierz plik ZIP z serwisu GitHub, rozpakuj go i przejdź do folderu.

Zainstaluj lokalnie.#

pip install .
Lub jeśli SDK nie jest ustrukturyzowany jako pakiet:
python setup.py install

Sprawdź instalację#

Uruchom Pythona i sprawdź, czy pakiet został poprawnie zaimportowany:
import nextcaptcha
print(nextcaptcha.__version__)
Jeśli napotkasz jakiekolwiek problemy, upewnij się, że masz zainstalowane wymagane zależności za pomocą:
pip install -r requirements.txt

Konfiguracja

Skonfiguruj NextCaptcha Python SDK z niezbędnymi parametrami

Konfiguracja zestawu SDK Solver

Aby skonfigurować Pakiet NextCaptcha Python SDK, należy ustawić następujące parametry:
  • client_key: Twój klucz API z NextCaptcha
  • soft_id: Twój identyfikator oprogramowania (opcjonalnie)
  • callback_url: Adres URL umożliwiający asynchroniczne odbieranie odpowiedzi (w przypadku korzystania z trybu wywołania zwrotnego)
  • open_log: Włącz rejestrowanie w celu debugowania

** Przykład konfiguracji**#

Oto jak skonfigurować i używać NextCaptcha Python SDK:
from nextcaptcha import NextCaptchaAPI
 
# Configuration settings
config = {
    "client_key": "your_client_key_here",  # Replace with your NextCaptcha API key
    "soft_id": 12345,  # Your software ID (optional, replace if required)
    "callback_url": "https://your-callback-url.com",  # Callback URL (optional)
    "open_log": True  # Enable logging for debugging
}
 
# Initialize the NextCaptcha client
solver = NextCaptchaAPI(**config)
 
# Test request (example: solving a reCAPTCHA)
task = {
    "type": "ReCaptchaV2TaskProxyless",
    "websiteURL": "https://example.com",
    "websiteKey": "your_recaptcha_site_key"
}
 
# Send the task and get the result
try:
    task_id = solver.create_task(task)
    result = solver.get_result(task_id)
    print("Captcha solution:", result)
except Exception as e:
    print("Error:", str(e))

Wyjaśnienie parametrów#

ParametrOpis
client_keyTwój klucz API NextCaptcha (wymagany)
soft_idTwój identyfikator oprogramowania (opcjonalnie)
callback_urlAdres URL, na który zostaną wysłane wyniki (opcjonalny, tylko w przypadku zadań asynchronicznych)
open_logJeśli `True`, włącza rejestrowanie w celu debugowania

notatki#

  • W przypadku użycia trybu wywołania zwrotnego rozwiązanie zostanie wysłane na adres `callback_url`, dzięki czemu nie trzeba ręcznie pobierać wyników.
  • Jeżeli `open_log=True`, logi zostaną wydrukowane w celu ułatwienia debugowania.
  • Pamiętaj o zastąpieniu symboli zastępczych (`your_client_key_here` itd.) rzeczywistymi danymi uwierzytelniającymi.

Rozwiąż CAPTCHA

Rozwiąż reCAPTCHA v2/v3/Enterprise za pomocą metody opartej na tokenie

Aby rozwiązać reCAPTCHA v2, v3, Enterprise lub wersję mobilną przy użyciu metody NextCaptcha opartej na tokenach, wykonaj następujące kroki:

1. Rozwiąż reCAPTCHA za pomocą metody opartej na tokenach#

Użyj podejścia opartego na tokenach, aby uzyskać token `g-recaptcha-response`.

Rozwiąż reCAPTCHA v2 przy użyciu metody bazowej Token#

 
# {props.t('solve6')}
 
result = api.recaptchav2(website_url="https://example.com", website_key="SITE_KEY")
 

Rozwiąż reCAPTCHA v2 Enterprise z metodą bazową Token#

# {props.t('solve6')}
result = api.recaptchav2enterprise(website_url="https://example.com", website_key="SITE_KEY")

Rozwiąż reCAPTCHA v2 Enterprise z metodą bazową Token o wysokim wyniku#

result = api.recaptchav2hs_enterprise(website_url="https://example.com", website_key="SITE_KEY")

Rozwiąż reCAPTCHA v3 lub v3 Enterprise z metodą bazową Token#

result = api.recaptchav3(website_url="https://example.com", website_key="SITE_KEY")

Rozwiąż reCAPTCHA v3 lub v3 Enterprise z metodą bazową Token o wysokim wyniku#

result = api.recaptchav3hs(website_url="https://example.com", website_key="SITE_KEY")

Rozwiąż reCAPTCHA Mobile z metodą bazową Token#

result = api.recaptcha_mobile(app_key="APP_KEY", app_package_name="com.example.app", app_action="APP_ACTION", app_device="ios")

3. Użyj tokena#

Po otrzymaniu tokena `g-recaptcha-response` wstrzyknij go do formularza na stronie internetowej i prześlij.
<input type="hidden" name="g-recaptcha-response" value="your_token_here" />

Wyjaśnienie parametrów#

ParametrOpis
website_urlAdres URL witryny, na której znajduje się reCAPTCHA
website_keyKlucz witryny reCAPTCHA
page_actionParametr akcji do użycia w przypadku reCAPTCHA
api_domainDomena interfejsu API reCAPTCHA, jeśli jest inna niż domyślna
website_infoSzczegółowa konfiguracja reCAPTCHA dotycząca docelowej witryny internetowej

Notatki kluczowe#

Wspiera reCAPTCHA v2, v3, Enterprise i Mobile

Proxyless tryb jest dostępny (użyj serwera proxy, jeśli witryna wymaga określonych adresów IP)

Token-based Metoda ta pozwala na bezproblemowe ominięcie captcha.

Inne metody

Aby sprawdzić stan swojego konta NextCaptcha, skorzystaj z następującej metody:

Uzyskaj przykład salda#

# Get account balance
balance = api.get_balance()
print(f"Account balance: {balance}")

Notatki kluczowe#

Pobiera dostępne saldo w USD.

Upewnij się, że klucz API jest prawidłowy, aby uzyskać prawidłowe saldo.

Obsługa błędów

Jeśli podczas rozwiązywania captcha wystąpi błąd, SDK zwróci słownik zawierający informacje o błędzie. Możesz sprawdzić pole statusu, aby ustalić, czy żądanie zostało zrealizowane pomyślnie. Jeśli status to „gotowe”, captcha została pomyślnie rozwiązana, a rozwiązanie zostanie podane w polu rozwiązania. Jeśli status to „niepowodzenie”, pole błędu będzie zawierać opis błędu.
IDKodOpis
0-nie wystąpił żaden błąd
1ERROR_KEY_DOES_NOT_EXISTTwój klucz API jest nieprawidłowy. Upewnij się, że został poprawnie skonfigurowany i skopiuj go z trybu klienta lub programisty w Panelu sterowania
10ERROR_ZERO_BALANCESaldo Twojego konta wynosi zero
11ERROR_IP_NOT_ALLOWEDŻądanie zostało wysłane z adresu IP, którego nie ma na Twojej liście zaufanych adresów IP
12ERROR_CAPTCHA_UNSOLVABLECaptcha nie może zostać normalnie rozwiązana. Może napotkać serwer proxy lub rozwiązanie nie powiedzie się z różnych powodów sieciowych. Ogólnie rzecz biorąc, możesz spróbować ponownie.
14ERROR_NO_SUCH_METHODZażądano metody, która nie istnieje w interfejsie API
15ERROR_IMAGE_TYPE_NOT_SUPPORTEDNie można przetworzyć obrazu, ponieważ jego format lub rozmiar jest nieprawidłowy albo obraz jest uszkodzony. Sprawdź obraz w swojej prośbie
16ERROR_NO_SUCH_CAPCHA_IDPodany identyfikator Captcha jest nieprawidłowy
21ERROR_IP_BLOCKEDTwój adres IP został zablokowany z powodu niewłaściwego użycia API
22ERROR_TASK_ABSENTNie uwzględniłeś atrybutu task w wywołaniu metody createTask
23ERROR_TASK_NOT_SUPPORTEDAtrybut zadania w wywołaniu metody createTask zawiera typ zadania, który nie jest obsługiwany przez nasz interfejs API, lub atrybut type jest nieprawidłowy.
31ERROR_RECAPTCHA_INVALID_SITEKEYPodana wartość klucza witryny reCAPTCHA jest nieprawidłowa
55ERROR_ACCOUNT_SUSPENDEDTwoje konto zostało zawieszone z powodu niewłaściwego korzystania z API. Aby rozwiązać ten problem, połącz się z zespołem pomocy technicznej Telegramu
130ERROR_BAD_PROXYParametry serwera proxy są nieprawidłowe lub nie można nawiązać połączenia za pośrednictwem serwera proxy
110ERROR_BAD_PARAMETERSW żądaniu brakuje wymaganego parametru captcha lub format parametru jest nieprawidłowy. Upewnij się, że format ładunku żądania jest odpowiedni dla wybranego typu zadania
500ERROR_UNKNOWNNieznany błąd. Może to być nieoczekiwany błąd w systemie. Możesz skontaktować się z administratorem, który wysłał błąd, aby rozwiązać problem.