Обхід капчі на Python
Інтегруйте пакет Python для автоматичного розв'язання капчі. Сервіс надає найкращий показник успішн ого розпізнавання капчі. API дозволяє обходити капчі на будь-якому сайті. Підтримується обхід основних капч.
Пакет Python скриптів для простої інтеграції з API сервісу рішення капчі 2Captcha для обходу 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 програмного забезпечення, отриманий після публікації в каталог програм 2Captcha |
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
Рішення капчі
Коли ви відправляєте будь-яку графічну капчу, ви можете передавати додаткові параметри, які допоможуть працівникам 2Captcha вирішити її швидко та правильно.
Опції капчі
Опція | Значення за замовчуванням | Опис |
---|---|---|
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