NextCaptcha Solver Python SDK - Instalação, configuração e uso | Solucionador de Captcha, Serviço de Auto Bypass Captcha

Python é uma linguagem de programação interpretada de alto nível. É conhecida por sua simplicidade e legibilidade. É uma linguagem versátil que pode ser usada para desenvolvimento web, análise de dados, inteligência artificial e muito mais.

Integre nosso pacote de resolução de captcha Python para resolver CAPTCHA automaticamente em qualquer site.

Fácil integração com a API do serviço de resolução de captcha para ignorar o reCAPTCHA e resolver qualquer outro CAPTCHA

Instalação

Instale o NextCaptcha Python SDK com pip ou manualmente

PIP

Para instalar o NextCaptcha Python SDK, você pode usar pip (recomendado) ou instalá-lo manualmente.

1. Instalar com pip (recomendado)#

Se o NextCaptcha SDK for publicado no PyPI, você poderá instalá-lo com:

pip install nextcaptcha-python

Ou, se estiver hospedado no GitHub:

pip install git+https://github.com/nextcaptcha/nextcaptcha-python.git

2. Instalação manual#

Se você tiver o SDK como um arquivo local ou arquivo ZIP, siga estas etapas:

Step 1: Baixe o SDK#

Clone o repositório:

git clone https://github.com/nextcaptcha/nextcaptcha-python.git
cd nextcaptcha-python

Baixe o ZIP do GitHub, extraia-o e navegue até a pasta.

Instalar localmente.#

pip install .

Ou, se o SDK não estiver estruturado como um pacote:

python setup.py install

Verificar instalação#

Execute o Python e verifique se o pacote é importado corretamente:

import nextcaptcha
print(nextcaptcha.__version__)

Se você encontrar algum problema, certifique-se de ter as dependências necessárias instaladas com:

pip install -r requirements.txt

Configuração

Configure o NextCaptcha Python SDK com os parâmetros necessários

Configuração do Solver SDK

Para configurar o NextCaptcha Python SDK, você precisará definir os seguintes parâmetros:

client_key: Sua chave de API do NextCaptcha
soft_id: Seu ID de software (opcional)
callback_url: A URL para receber respostas de forma assíncrona (se estiver usando o modo de retorno de chamada)
open_log: Habilitar registro para depuração

Exemplo de configuração#

Veja como você pode configurar e usar o 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))

Explicação dos Parâmetros#

Parâmetro	Descrição
`client_key`	Sua chave de API NextCaptcha (obrigatório)
`soft_id`	Seu ID de software (opcional)
`callback_url`	Uma URL para onde os resultados serão enviados (opcional, apenas para tarefas assíncronas)
`open_log`	Se `True`, habilita o registro para depuração

notas#

Se usar o modo de retorno de chamada, a solução será enviada para `callback_url`, então você não precisa buscar resultados manualmente.
Se `open_log=True`, os logs serão impressos para ajudar na depuração.
Certifique-se de substituir os espaços reservados (`your_client_key_here`, etc.) pelas suas credenciais reais.

Resolver CAPTCHA

Resolver reCAPTCHA v2/v3/Enterprise via método baseado em token

Para resolver o reCAPTCHA v2, v3, Enterprise ou a versão móvel usando o método baseado em token do NextCaptcha, siga estas etapas:

1. Resolver reCAPTCHA via método baseado em token#

Use a abordagem baseada em token para obter o token `g-recaptcha-response`.

Resolva o reCAPTCHA v2 com o método base Token#

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

Resolva o reCAPTCHA v2 Enterprise com o método base Token#

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

Resolva o reCAPTCHA v2 Enterprise com o método de base de token de pontuação alta#

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

Resolva o reCAPTCHA v3 ou v3 Enterprise com o método base Token#

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

Resolva o reCAPTCHA v3 ou v3 Enterprise com o método de base de token de pontuação alta#

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

Resolva o reCAPTCHA Mobile com o método base Token#

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

3. Use o Token#

Após receber o token `g-recaptcha-response`, injete-o no formulário do site e envie-o.

<input type="hidden" name="g-recaptcha-response" value="your_token_here" />

Explicação dos Parâmetros#

Parâmetro	Descrição
`website_url`	A URL do site onde o reCAPTCHA está localizado
`website_key`	A chave do site do reCAPTCHA
`page_action`	O parâmetro de ação a ser usado para o reCAPTCHA
`api_domain`	O domínio da API reCAPTCHA se for diferente do padrão
`website_info`	Configuração detalhada do reCAPTCHA sobre um site de destino

Notas principais#

✅ Suporta reCAPTCHA v2, v3, Enterprise e Mobile

✅ Proxyless modo está disponível (use um proxy se o site exigir IPs específicos)

✅ Token-based método permite ignorar captcha sem problemas.

Outros métodos

Para verificar o saldo da sua conta NextCaptcha, use o seguinte método:

Exemplo de Obter Saldo#

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

Notas principais#

✅ Recupera seu saldo disponível em USD.

✅ Certifique-se de que sua chave de API seja válida para obter o saldo correto.

Tratamento de erros

Se ocorrer um erro ao resolver um captcha, o SDK retornará um dicionário contendo as informações do erro. Você pode verificar o campo de status para determinar se a solicitação foi bem-sucedida. Se o status for "pronto", o captcha foi resolvido com sucesso e a solução será fornecida no campo de solução. Se o status for "falhou", o campo de erro conterá uma descrição do erro.

Eu ia	Código	Descrição
0	-	nenhum erro ocorreu
1	`ERROR_KEY_DOES_NOT_EXIST`	Sua chave de API está incorreta. Verifique se você a configurou corretamente e copie-a do modo cliente ou desenvolvedor no Painel de controle
10	`ERROR_ZERO_BALANCE`	O saldo da sua conta é zero
11	`ERROR_IP_NOT_ALLOWED`	A solicitação foi feita a partir de um endereço IP que não está na sua lista de IPs confiáveis
12	`ERROR_CAPTCHA_UNSOLVABLE`	O captcha não pode ser resolvido normalmente. Ele pode encontrar um proxy ou a solução falhar por vários motivos de rede. Em geral, você pode tentar novamente.
14	`ERROR_NO_SUCH_METHOD`	Foi solicitado um método que não existe na API
15	`ERROR_IMAGE_TYPE_NOT_SUPPORTED`	A imagem não pode ser processada porque o formato ou tamanho da imagem está incorreto ou a imagem está corrompida. Por favor verifique a imagem em seu pedido
16	`ERROR_NO_SUCH_CAPCHA_ID`	O ID do Captcha que você forneceu está incorreto
21	`ERROR_IP_BLOCKED`	Seu endereço IP foi banido devido ao uso inadequado da API
22	`ERROR_TASK_ABSENT`	Você não incluiu o atributo task na chamada do método createTask
23	`ERROR_TASK_NOT_SUPPORTED`	O atributo task na chamada do método createTask contém um tipo de tarefa que não é compatível com nossa API ou o atributo type está incorreto.
31	`ERROR_RECAPTCHA_INVALID_SITEKEY`	O valor do sitekey reCAPTCHA fornecido é inválido
55	`ERROR_ACCOUNT_SUSPENDED`	Sua conta foi suspensa devido ao uso indevido da API. Conecte-se via equipe de suporte do Telegram para resolver este problema
130	`ERROR_BAD_PROXY`	Os parâmetros do proxy estão incorretos ou a conexão não pode ser estabelecida através do proxy
110	`ERROR_BAD_PARAMETERS`	Um parâmetro captcha obrigatório está faltando na sua solicitação ou o formato do parâmetro está incorreto. Certifique-se de que o formato da carga útil da sua solicitação seja apropriado para o tipo de tarefa selecionado
500	`ERROR_UNKNOWN`	Erro desconhecido. Pode ser um erro inesperado no sistema. Você pode entrar em contato com o administrador que enviou o erro para resolver o problema.

Instalação

PIP

1. Instalar com pip (recomendado)#

2. Instalação manual#

Step 1: Baixe o SDK#

Instalar localmente.#

Verificar instalação#

Configuração

Configuração do Solver SDK

** Exemplo de configuração**#

Explicação dos Parâmetros#

notas#

Resolver CAPTCHA

1. Resolver reCAPTCHA via método baseado em token#

Resolva o reCAPTCHA v2 com o método base Token#

Resolva o reCAPTCHA v2 Enterprise com o método base Token#

Resolva o reCAPTCHA v2 Enterprise com o método de base de token de pontuação alta#

Resolva o reCAPTCHA v3 ou v3 Enterprise com o método base Token#

Resolva o reCAPTCHA v3 ou v3 Enterprise com o método de base de token de pontuação alta#

Resolva o reCAPTCHA Mobile com o método base Token#

3. Use o Token#

Explicação dos Parâmetros#

Notas principais#

Outros métodos

Exemplo de Obter Saldo#

Notas principais#

Tratamento de erros

Exemplo de configuração#