Tham gia và nhận bản dùng thử miễn phí!

python captcha solver

Python là ngôn ngữ lập trình được thông dịch ở cấp độ cao. Nó được biết đến với tính đơn giản và dễ đọc. Đây là ngôn ngữ đa năng có thể được sử dụng để phát triển web, phân tích dữ liệu, trí tuệ nhân tạo, v.v.

Tích hợp gói giải mã captcha Python của chúng tôi để tự động giải mã CAPTCHA trên bất kỳ trang web nào.

Tích hợp dễ dàng với API của dịch vụ giải mã captcha để bỏ qua reCAPTCHA và giải quyết bất kỳ CAPTCHA nào khác

Cài đặt

Cài đặt NextCaptcha Python SDK bằng pip hoặc thủ công

PIP

Để cài đặt NextCaptcha Python SDK, bạn có thể sử dụng pip (khuyến nghị) hoặc cài đặt thủ công.

1. Cài đặt bằng pip (Khuyến nghị)#

Nếu SDK NextCaptcha được phát hành trên PyPI, bạn có thể cài đặt nó bằng:
pip install nextcaptcha-python
Hoặc, nếu nó được lưu trữ trên GitHub:
pip install git+https://github.com/nextcaptcha/nextcaptcha-python.git

2. Cài đặt thủ công#

Nếu bạn có SDK dưới dạng tệp cục bộ hoặc tệp ZIP, hãy làm theo các bước sau:

Step 1: Tải xuống SDK#

  • Sao chép kho lưu trữ:
git clone https://github.com/nextcaptcha/nextcaptcha-python.git
cd nextcaptcha-python
HOẶC
  • Tải xuống file ZIP từ GitHub, giải nén và điều hướng đến thư mục.

Cài đặt cục bộ.#

pip install .
Hoặc, nếu SDK không được cấu trúc dưới dạng một gói:
python setup.py install

Xác minh cài đặt#

Chạy Python và kiểm tra xem gói có được nhập đúng không:
import nextcaptcha
print(nextcaptcha.__version__)
Nếu bạn gặp bất kỳ sự cố nào, hãy đảm bảo bạn đã cài đặt các phụ thuộc cần thiết với:
pip install -r requirements.txt

Cấu hình

Cấu hình NextCaptcha Python SDK với các tham số cần thiết

Cấu hình của Solver SDK

Để cấu hình NextCaptcha Python SDK, bạn sẽ cần thiết lập các tham số sau:
  • client_key: Khóa API của bạn từ NextCaptcha
  • soft_id: ID phần mềm của bạn (tùy chọn)
  • callback_url: URL để nhận phản hồi không đồng bộ (nếu sử dụng chế độ gọi lại)
  • open_log: Cho phép ghi nhật ký để gỡ lỗi

** Ví dụ cấu hình**#

Sau đây là cách bạn có thể thiết lập và sử dụng 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))

Giải thích các tham số#

Tham sốSự miêu tả
client_keyKhóa API NextCaptcha của bạn (bắt buộc)
soft_idID phần mềm của bạn (tùy chọn)
callback_urlURL nơi kết quả sẽ được gửi (tùy chọn, chỉ dành cho các tác vụ không đồng bộ)
open_logNếu `Đúng`, cho phép ghi nhật ký để gỡ lỗi

ghi chú#

  • Nếu sử dụng chế độ gọi lại, giải pháp sẽ được gửi đến `callback_url`, do đó bạn không cần phải lấy kết quả theo cách thủ công.
  • Nếu `open_log=True`, nhật ký sẽ được in ra để hỗ trợ gỡ lỗi.
  • Đảm bảo thay thế các chỗ giữ chỗ (`your_client_key_here`, v.v.) bằng thông tin đăng nhập thực tế của bạn.

Giải quyết CAPTCHA

Giải quyết reCAPTCHA v2/v3/Enterprise thông qua phương pháp dựa trên Token

Để giải quyết reCAPTCHA v2, v3, Enterprise hoặc phiên bản di động bằng phương pháp dựa trên Token của NextCaptcha, hãy làm theo các bước sau:

1. Giải quyết reCAPTCHA thông qua phương pháp dựa trên Token#

Sử dụng phương pháp dựa trên mã thông báo để lấy mã thông báo `g-recaptcha-response`.

Giải quyết reCAPTCHA v2 bằng phương pháp cơ sở Token#

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

Giải quyết reCAPTCHA v2 Enterprise bằng phương pháp cơ sở Token#

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

Giải quyết reCAPTCHA v2 Enterprise với phương pháp cơ sở Token có điểm cao#

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

Giải quyết reCAPTCHA v3 hoặc v3 Enterprise bằng phương pháp cơ sở Token#

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

Giải quyết reCAPTCHA v3 hoặc v3 Enterprise với phương pháp cơ sở Token có điểm cao#

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

Giải quyết reCAPTCHA Mobile bằng phương pháp cơ sở Token#

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

3. Sử dụng Mã thông báo#

Sau khi nhận được mã thông báo `g-recaptcha-response`, hãy đưa mã thông báo này vào biểu mẫu của trang web và gửi đi.
<input type="hidden" name="g-recaptcha-response" value="your_token_here" />

Giải thích các tham số#

Tham sốSự miêu tả
website_urlURL của trang web nơi reCAPTCHA được đặt
website_keySitekey của reCAPTCHA
page_actionTham số hành động sử dụng cho reCAPTCHA
api_domainTên miền của API reCAPTCHA nếu khác với tên miền mặc định
website_infoCấu hình reCAPTCHA chi tiết về một trang web mục tiêu

Ghi chú chính#

Hỗ trợ reCAPTCHA v2, v3, Doanh nghiệp và Di động

Proxyless chế độ có sẵn (sử dụng proxy nếu trang web yêu cầu IP cụ thể)

Token-based phương pháp này cho phép bỏ qua captcha một cách liền mạch.

Các phương pháp khác

Để kiểm tra số dư tài khoản NextCaptcha của bạn, hãy sử dụng phương pháp sau:

Lấy ví dụ về số dư#

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

Ghi chú chính#

Lấy lại số dư khả dụng của bạn bằng USD.

Đảm bảo khóa API của bạn hợp lệ để có được số dư chính xác.

Xử lý lỗi

Nếu xảy ra lỗi khi giải captcha, SDK sẽ trả về một từ điển chứa thông tin lỗi. Bạn có thể kiểm tra trường trạng thái để xác định xem yêu cầu có thành công hay không. Nếu trạng thái là "sẵn sàng", captcha đã được giải quyết thành công và giải pháp sẽ được cung cấp trong trường giải pháp. Nếu trạng thái là "thất bại", trường lỗi sẽ chứa mô tả về lỗi.
Nhận dạngMã sốSự miêu tả
0-không có lỗi xảy ra
1ERROR_KEY_DOES_NOT_EXISTKhóa API của bạn không chính xác, vui lòng đảm bảo rằng bạn đã thiết lập chính xác và sao chép nó từ chế độ máy khách hoặc nhà phát triển trong Bảng điều khiển
10ERROR_ZERO_BALANCESố dư tài khoản của bạn bằng 0
11ERROR_IP_NOT_ALLOWEDYêu cầu được thực hiện từ một địa chỉ IP không có trong danh sách IP đáng tin cậy của bạn
12ERROR_CAPTCHA_UNSOLVABLECaptcha không thể được giải quyết bình thường. Nó có thể gặp proxy hoặc giải pháp không thành công vì nhiều lý do mạng. Nói chung, bạn có thể thử lại.
14ERROR_NO_SUCH_METHODMột phương thức không tồn tại trong API đã được yêu cầu
15ERROR_IMAGE_TYPE_NOT_SUPPORTEDKhông thể xử lý hình ảnh do định dạng hoặc kích thước hình ảnh không chính xác hoặc hình ảnh bị hỏng. Vui lòng kiểm tra hình ảnh trong yêu cầu của bạn
16ERROR_NO_SUCH_CAPCHA_IDID Captcha bạn cung cấp không chính xác
21ERROR_IP_BLOCKEDĐịa chỉ IP của bạn đã bị cấm do sử dụng API không phù hợp
22ERROR_TASK_ABSENTBạn chưa bao gồm thuộc tính task trong lệnh gọi phương thức createTask
23ERROR_TASK_NOT_SUPPORTEDThuộc tính tác vụ trong lệnh gọi phương thức createTask của bạn chứa loại tác vụ không được API của chúng tôi hỗ trợ hoặc thuộc tính loại không chính xác.
31ERROR_RECAPTCHA_INVALID_SITEKEYGiá trị khóa trang web reCAPTCHA bạn đã cung cấp không hợp lệ
55ERROR_ACCOUNT_SUSPENDEDTài khoản của bạn đã bị đình chỉ do sử dụng API không đúng cách. Vui lòng kết nối qua nhóm hỗ trợ Telegram để giải quyết vấn đề này
130ERROR_BAD_PROXYCác tham số proxy không chính xác hoặc không thể thiết lập kết nối thông qua proxy
110ERROR_BAD_PARAMETERSYêu cầu của bạn thiếu tham số hình ảnh xác thực bắt buộc hoặc định dạng tham số không chính xác. Vui lòng đảm bảo rằng định dạng tải trọng yêu cầu của bạn phù hợp với loại nhiệm vụ đã chọn
500ERROR_UNKNOWNLỗi không rõ. Đó có thể là một lỗi không mong muốn trong hệ thống. Bạn có thể liên hệ với quản trị viên đã gửi lỗi để giải quyết vấn đề.