Обход капчи на Python
Интегрируйте пакет Python для автоматического решения капчи. Сервис предоставляет лучший показатель успешного распознавания капчи. API позволяет обходить капчи на любом сайте. Поддерживается обход основных капч.
Пакет Python скриптов для простой интеграции с API сервиса решения капчи ruCaptcha для обхода reCAPTCHA, Arkose captcha, Geetest и решения любых других капч.
Опубликовали на GitHub примеры обхода капчи с использованием Python и Selenium. Репозиторий содержит готовые скрипты для автоматизации процесса решения капч, обеспечивая простую интеграцию в существующие проекты.
Быстрый стартУстановка
Пакет скриптов можно установить с помощью установщика пакетов или вручную
Pip
Для автоматической установки пакета библиотек необходимо воспользоваться стандартным решением для Python пакетов - Pip. Скачайте его по ссылке и инсталлируйте по инструкции. После установки приложения используйте команду:
pip3 install 2captcha-python
Примеры кода, а также библиотеки и модули для интеграции с нашим API вы также можете найти в репозитории на GitHub.
Конфигурация
Описание всех необходимых параметров для конфигурирования установленного пакета
Экземпляр класса TwoCaptcha
можно создать вот так:
from twocaptcha import TwoCaptcha
solver = TwoCaptcha('YOUR_API_KEY')
Также у вас есть возможность настраивать некоторые опции созданного экземпляра:
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)
Опции экземпляра TwoCaptcha
Опция | Значение по умолчанию | Описание |
---|---|---|
server | '2captcha.com' | API сервер. Вы можете поменять значение на 'rucaptcha.com', если ваш аккаунт зарегистрирован там. |
softId | - | ваш id программного обеспечения, полученный после публикации в каталоге программ ruCaptcha |
callback | - | URL вашего веб-сервера, который получает результат распознавания капчи. URL должен быть сначала зарегистрирован в настройках pingback вашей учетной записи |
defaultTimeout | 120 | Таймаут опроса в секундах для всех типов капчи, кроме reCAPTCHA. Определяет, как долго модуль пытается получить ответ от конечной точки API res.php |
recaptchaTimeout | 600 | Таймаут опроса reCAPTCHA в секундах. Определяет, как долго модуль пытается получить ответ от конечной точки API res.php |
pollingInterval | 10 | Интервал в секундах между запросами к конечной точке API res.php , установка значений менее 5 секунд не рекомендуется |
ВАЖНО: как толькоcallback
определен для одного экземпляра классаTwoCaptcha
, все остальные методы возвращают только ID капчи и НЕ опрашивают API для получения результата. Результат будет отправлен на callback URL. Чтобы получить ответ вручную, используйте метод getResult
Решение капчи
Когда вы отправляете любую графическую капчу, вы можете передавать дополнительные параметры, которые помогут работникам ruCaptcha решить ее быстро и правильно.
Опции капчи
Опция | Значение по умолчанию | Описание |
---|---|---|
numeric | 0 | определяет, содержит ли капча числовые или другие символы, подробнее см. в документации по API |
minLength | 0 | минимальная длина ответа |
maxLength | 0 | максимальная длина ответа |
phrase | 0 | определяет, содержит ли ответ несколько слов или нет |
caseSensitive | 0 | определяет, чувствителен ли ответ к регистру |
calc | 0 | определяет капчу, которая требует расчета |
lang | - | определяет язык капчи, смотрите список поддерживаемых языков |
hintImg | - | изображение с подсказкой, показанное работникам с помощью капчи |
hintText | - | подсказка или текст задачи, показываемый работникам с помощью капчи |
- Простая капча
- Текстовая капча
- reCAPTCHA v2
- reCAPTCHA v3
- FunCaptcha
- GeeTest
- KeyCaptcha
- Capy
- Grid
- Canvas
- ClickCaptcha
- Rotate
Чтобы обойти обычную капчу (искаженный текст на изображении), используйте след ующий метод. Этот метод также можно использовать для распознавания любого текста на изображении.
result = solver.normal('path/to/captcha.jpg', param1=..., ...)
Этот метод можно использовать для обхода капчи, которая требует ответа на вопрос в виде открытого текста
result = solver.text('If tomorrow is Saturday, what day is today?', param1=..., ...)
Используйте этот метод для решения reCAPTCHA V2 и получения токена для обхода защиты
result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
url='https://mysite.com/page/with/recaptcha',
param1=..., ...)
Этот метод позволяет обходить reCAPTCHA V3 и возвращает токен
result = solver.recaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
url='https://mysite.com/page/with/recaptcha',
version='v3',
param1=..., ...)
Метод решения FunCaptcha (Аркоселабс). Возвращает токен для обхода капчи
result = solver.funcaptcha(sitekey='6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-',
url='https://mysite.com/page/with/funcaptcha',
param1=..., ...)
Метод решения капчи головоломки GeeTest. Возвращает набор токенов в формате JSON
result = solver.geetest(gt='f1ab2cdefa3456789012345b6c78d90e',
challenge='12345678abc90123d45678ef90123a456b',
url='https://www.site.com/page/',
param1=..., ...)
Метод решения 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=..., ...)
Токен-основанный способ обхода капчи Capy puzzle
result = solver.capy(sitekey='PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
url='http://mysite.com/',
api_server='https://jp.api.capy.me/',
param1=..., ...)
Этот метод изначально назывался Old reCAPTCHA V2. Его можно использовать для обхода любого типа капчи, когда вы можете применить сетку к изображению и вам нужно щелкнуть определенные поля сетки. Возвращает количество ячеек сетки
result = solver.grid('path/to/captcha.jpg', param1=..., ...)
Метод Canvas можно использовать, когда вам нужно нарисовать линию вокруг объекта на изображении. Возвращает набор координат точек для рисования м ногоугольника.
result = solver.canvas('path/to/captcha.jpg', param1=..., ...)
Метод ClickCaptcha возвращает координаты точек на изображении капчи. Может использоваться, если вам нужно щелкнуть определенные точки на изображении.
result = solver.coordinates('path/to/captcha.jpg', param1=..., ...)
Этот метод можно использовать для решения капчи, которая просит повернуть объект. В основном используется для обхода FunCaptcha. Возвращает значение угла поворота.
result = solver.rotate('path/to/captcha.jpg', param1=..., ...)
Другие методы
Дополнительные допустимые методы применяемые в процессе работы основных скриптов
send / getResult
Этот метод можно использовать для ручной передачи капчи и получения ответов.
import time
. . . . .
id = solver.send(file='path/to/captcha.jpg')
time.sleep(20)
code = solver.get_result(id)
balance
Используйте этот метод, чтобы получить баланс своего аккаунта.
balance = solver.balance()
report
Используйте этот метод, чтобы сообщить о правильном или неправильном решении капчи.
solver.report(id, True) # captcha solved correctly
solver.report(id, False) # captcha solved incorrectly
Обработка ошибок
Возможные варианты стандартных ошибок возвращаемые сервисом при обработке зап росов
В случае ошибки решатель капчи выдает исключение. Важно правильно обращаться с этими случаями. Мы рекомендуем использовать try/except
для обработки исключений
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)
Прокси
Вы можете передать свой прокси в качестве дополнительного аргумента для методов: recaptcha, funcaptcha и geetest. Прокси будет перенаправлен в API для решения капчи.
proxy={
'type': 'HTTPS',
'uri': 'login:password@IP_address:PORT'
}
Асинхронные запросы
Вы также можете выполнять асинхронные запросы с помощью asyncio, например:
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