参加して無料トライアルをゲットしましょう！

python captcha solver

Python は、高水準のインタープリタ型プログラミング言語です。シンプルで読みやすいことで知られています。Web 開発、データ分析、人工知能などに使用できる多目的言語です。

当社の Python キャプチャ ソルバー パッケージを統合して、あらゆる Web サイトで CAPTCHA を自動的に解決します。

キャプチャ解決サービスのAPIと簡単に統合して、reCAPTCHAを回避し、他のCAPTCHAを解決します。

インストール

NextCaptcha Python SDKをpipまたは手動でインストールする

PIP

NextCaptcha Python SDK をインストールするには、pip (推奨) を使用するか、手動でインストールします。

1. pip でインストールする (推奨)#

NextCaptcha SDK が PyPI で公開されている場合は、次のコマンドでインストールできます。 
pip install nextcaptcha-python
または、GitHub でホストされている場合: 
pip install git+https://github.com/nextcaptcha/nextcaptcha-python.git

2. 手動インストール#

SDK をローカル ファイルまたは ZIP アーカイブとして持っている場合は、次の手順に従います。

Step 1: SDKをダウンロード#

  • リポジトリをクローンします: 
git clone https://github.com/nextcaptcha/nextcaptcha-python.git
cd nextcaptcha-python
または
  • GitHub から ZIP をダウンロードし、解凍してフォルダーに移動します。

ローカルにインストールします。#

pip install .
または、SDK がパッケージとして構造化されていない場合は、次のようになります。 
python setup.py install

インストールの確認#

Python を実行し、パッケージが正しくインポートされているかどうかを確認します。 
import nextcaptcha
print(nextcaptcha.__version__)
問題が発生した場合は、必要な依存関係がインストールされていることを確認してください。 
pip install -r requirements.txt

構成

必要なパラメータを使用してNextCaptcha Python SDKを構成する

ソルバーSDKの設定

NextCaptcha Python SDK を設定するには、次のパラメータを設定する必要があります。
  • client_key: NextCaptchaからのAPIキー
  • soft_id: ソフトウェアID（オプション）
  • callback_url: 非同期的に応答を受信するための URL (コールバック モードを使用している場合)
  • open_log: デバッグ用のログを有効にする

** 設定例**#

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))

パラメータの説明#

パラメータ説明
client_keyNextCaptcha API キー (必須)
soft_idソフトウェアID（オプション）
callback_url結果が送信される URL (オプション、非同期タスクのみ)
open_log`True`の場合、デバッグ用のログ記録が有効になります

ノート#

  • コールバック モード を使用する場合、ソリューションは `callback_url` に送信されるため、結果を手動で取得する必要はありません。
  • `open_log=True` の場合、デバッグに役立つログが出力されます。
  • プレースホルダー (`your_client_key_here` など) を実際の資格情報に置き換えてください。

CAPTCHAを解読する

トークンベースの方法で reCAPTCHA v2/v3/Enterprise を解読する

NextCaptcha のトークンベースの方法を使用して reCAPTCHA v2、v3、Enterprise、またはモバイル バージョンを解決するには、次の手順に従います。

1. トークンベースの方法で reCAPTCHA を解読する#

トークンベースのアプローチを使用して、`g-recaptcha-response` トークンを取得します。

トークンベースの方法で reCAPTCHA v2 を解く#

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

トークンベースの方法で reCAPTCHA v2 Enterprise を解決する#

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

高スコアトークンベースの方法で reCAPTCHA v2 Enterprise を解く#

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

トークンベースの方法で reCAPTCHA v3 または v3 Enterprise を解く#

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

高スコアトークンベースの方法で reCAPTCHA v3 または v3 Enterprise を解く#

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

トークンベースの方法で reCAPTCHA Mobile を解く#

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

3. トークンを使用する#

`g-recaptcha-response` トークンを受け取ったら、それを Web サイトのフォームに挿入して送信します。 
<input type="hidden" name="g-recaptcha-response" value="your_token_here" />

パラメータの説明#

パラメータ説明
website_urlreCAPTCHAが設置されているウェブサイトのURL
website_keyreCAPTCHAのサイトキー
page_actionreCAPTCHAに使用するアクションパラメータ
api_domainreCAPTCHA APIのドメイン（デフォルトと異なる場合）
website_info対象ウェブサイトに関する詳細なreCAPTCHA設定

主な注意事項#

✅ サポート reCAPTCHA v2、v3、エンタープライズ、モバイル

✅ Proxyless モードが利用可能です（サイトが特定のIPを必要とする場合はプロキシを使用してください）

✅ Token-based この方法により、シームレスなキャプチャのバイパスが可能になります。

その他の方法

NextCaptcha アカウントの残高を確認するには、次の方法を使用します。

残高を取得する例#

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

主な注意事項#

✅ 利用可能な残高を USD で取得します。

✅ 正しい残高を取得するには、API キーが有効であることを確認してください。

エラー処理

キャプチャの解決中にエラーが発生した場合、SDK はエラー情報を含む辞書を返します。ステータス フィールドをチェックして、リクエストが成功したかどうかを判断できます。ステータスが「準備完了」の場合、キャプチャは正常に解決され、ソリューション フィールドにソリューションが提供されます。ステータスが「失敗」の場合、エラー フィールドにエラーの説明が含まれます。
識別子コード説明
0-エラーは発生しませんでした
1ERROR_KEY_DOES_NOT_EXISTAPI キーが正しくありません。正しく設定されていることを確認し、コントロール パネルのクライアント モードまたは開発者モードからコピーしてください。
10ERROR_ZERO_BALANCEアカウント残高はゼロです
11ERROR_IP_NOT_ALLOWEDリクエストは信頼できる IP リストにない IP アドレスから送信されました
12ERROR_CAPTCHA_UNSOLVABLEキャプチャを正常に解決できません。プロキシに遭遇したか、さまざまなネットワーク上の理由により解決に失敗した可能性があります。通常は、もう一度試すことができます。
14ERROR_NO_SUCH_METHODAPIに存在しないメソッドが要求されました
15ERROR_IMAGE_TYPE_NOT_SUPPORTED画像の形式またはサイズが正しくないか、画像が破損しているため、画像を処理できません。リクエスト内の画像を確認してください。
16ERROR_NO_SUCH_CAPCHA_ID入力したキャプチャIDが正しくありません
21ERROR_IP_BLOCKEDAPIの不適切な使用により、IPアドレスが禁止されました
22ERROR_TASK_ABSENTcreateTask メソッド呼び出しにタスク属性が含まれていませんでした
23ERROR_TASK_NOT_SUPPORTEDcreateTask メソッド呼び出しのタスク属性に、弊社の API でサポートされていないタスク タイプが含まれているか、タイプ属性が正しくありません。
31ERROR_RECAPTCHA_INVALID_SITEKEY入力した reCAPTCHA サイトキーの値が無効です
55ERROR_ACCOUNT_SUSPENDEDAPIの不適切な使用によりアカウントが停止されました。この問題を解決するには、Telegramサポートチームにご連絡ください。
130ERROR_BAD_PROXYプロキシパラメータが正しくないか、プロキシ経由で接続を確立できません
110ERROR_BAD_PARAMETERSリクエストに必要なキャプチャパラメータがないか、パラメータの形式が正しくありません。リクエストのペイロード形式が選択したタスクタイプに適していることを確認してください。
500ERROR_UNKNOWN不明なエラーです。システムで予期しないエラーが発生している可能性があります。エラーを送信した管理者に連絡して問題を解決してください。