Расширение браузера или API: какой подход к решению CAPTCHA подходящий?

Коротко: для разового захода в браузере расширение решает CAPTCHA быстрее и без единой строки кода. Для парсинга, CI/CD и любой продакшен-автоматизации выигрывает API — расширение упирается в правило «один браузер = одно решение за раз», а API масштабируется до тысяч параллельных решений и работает без браузера вообще.

Ниже — сценарии, по которым проще всего определить, что подойдёт именно вам, техническая механика каждого варианта, и код гибридной схемы, которую используют чаще всего на практике.

Вывод в двух строках

• Расширение — для разовых задач в браузере, прототипирования и пользователей без навыков программирования.
• API — для парсинга в масштабе, серверной автоматизации, CI/CD и всего, что должно работать без графического окружения.

Сценарий: расширение или API

Расширение подходит, если…

API нужен, если…

Для агентства или фрилансера, которые парсят данные для нескольких клиентов и выставляют счета в долларах, предсказуемая потоковая тарификация удобнее, чем скачущий счёт «по решению»: тариф ADVANCE ($90/мес, 50 потоков) обычно закрывает средний объём, а при пиках достаточно перейти на PREMIUM ($170/мес, 100 потоков) — без пересчёта архитектуры.

Если парсинг затрагивает персональные данные, отдельно проверьте, что вы вправе их обрабатывать — для аудитории из РФ это 152-ФЗ, для трансграничных проектов уместна GDPR-дисциплина. Это забота читателя, а не функция CaptchaAI.

Что происходит под капотом

Расширение браузера

Расширение следит за загрузкой страницы и ищет известные виджеты CAPTCHA (reCAPTCHA, Turnstile, image CAPTCHA). При обнаружении оно само извлекает параметры, отправляет их в решающий API и вставляет полученный токен обратно на страницу.

API-решение

Вы отправляете HTTP-запросы к решающему API: передаёте параметры CAPTCHA (sitekey, URL страницы, изображение), опрашиваете результат, затем используете токен в своём приложении — браузер для этого не нужен.

Масштабируемость: расширение против API

Надёжность и обработка ошибок

Обратите внимание: CaptchaAI тарифицирует по количеству одновременных потоков, а не по числу решённых CAPTCHA — решения в рамках оплаченного потока безлимитны весь месяц. Поэтому цена не зависит от того, откуда пришёл запрос — из расширения или напрямую через API.

Гибридный сценарий: браузер для навигации, API для решения

Для сложных сайтов комбинируйте оба варианта: браузер отвечает за навигацию, API — за решение CAPTCHA.

from selenium import webdriver
import requests
import time

driver = webdriver.Chrome()
driver.get("https://staging.example.com/qa-login")

# Detect CAPTCHA
sitekey = driver.find_element("css selector", "[data-sitekey]").get_attribute("data-sitekey")

# Solve via API (not extension)
submit = requests.post("https://ocr.captchaai.com/in.php", data={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "googlekey": sitekey,
    "pageurl": driver.current_url,
    "json": 1
}).json()

task_id = submit["request"]
time.sleep(15)

for _ in range(24):
    result = requests.get("https://ocr.captchaai.com/res.php", params={
        "key": "YOUR_API_KEY", "action": "get", "id": task_id, "json": 1
    }).json()
    if result.get("status") == 1:
        token = result["request"]
        # Inject token via JavaScript
        driver.execute_script(
            f'document.getElementById("g-recaptcha-response").value = "{token}";'
        )
        driver.find_element("css selector", "form").submit()
        break
    time.sleep(5)

Так вы получаете рендеринг уровня браузера для сайтов с тяжёлым JavaScript и программный контроль уровня API для самого решения CAPTCHA.

Часто задаваемые вопросы

Сколько потоков нужно для парсинга 1000+ страниц в час?

Зависит от доли страниц с CAPTCHA и типа CAPTCHA (обычно 5–30 с на решение). При CAPTCHA примерно на каждой десятой странице тарифа ADVANCE ($90/мес, 50 потоков) чаще всего достаточно; на пиковой нагрузке переходите на PREMIUM ($170/мес, 100 потоков) — тариф меняется без переписывания интеграции.

Отличается ли стоимость решения между расширением и API?

Нет. Оба варианта работают на одной и той же инфраструктуре CaptchaAI и тарифицируются по потокам, а не по числу решений — любая CAPTCHA, решённая в рамках оплаченного потока, ничего не стоит сверх подписки, независимо от того, пришёл запрос из расширения или из вашего кода.

Работает ли расширение CaptchaAI в headless Chrome для CI/CD?

Технически да, но с оговорками. Headless Chrome умеет загружать расширения, однако некоторые CAPTCHA-виджеты сами определяют headless-режим и ведут себя иначе. Для CI/CD-пайплайнов API-подход надёжнее — он не зависит от того, как страница определяет тип браузера.

Как перейти с расширения на API без остановки текущей автоматизации?

Начните с гибридной схемы: оставьте браузер (Selenium/Puppeteer) для навигации, а решение CAPTCHA переключите на прямые вызовы in.php/res.php, как в примере выше. Когда убедитесь, что API стабильно решает нужные типы CAPTCHA, расширение можно убрать вовсе.

Что выбрать для QA-тестирования в staging — расширение или API?

Для быстрой ручной проверки staging-окружения расширение экономит время — установил и работаешь. Но как только тесты запускаются в CI без графического интерфейса, единственный рабочий вариант — API: headless-раннер не сможет надёжно опираться на расширение браузера.

Подключите API CaptchaAI

Постройте масштабируемое решение CAPTCHA на captchaai.com.

Связанные руководства

• Быстрый старт с CaptchaAI
• Как решить reCAPTCHA v2 через API
• Необнаруженный ChromeDriver с CaptchaAI
• Headless и headed Chrome для решения CAPTCHA