CAPTCHA: настройка и проверка сбора

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

Как включить

1. Выберите пространство, которому принадлежит сайт.
2. Откройте настройки сайта, дополнительные параметры загрузки через браузер, блок Проверки сайта.
3. Оставьте включённым Проходить CAPTCHA автоматически. Обычно тип определяется сам.
4. В Балансе и тарифе → CAPTCHA проверьте доступность функции, оставшееся количество проверок, цены и пределы расходов.
5. Выполните пробный запуск сценария и проверьте найденные записи.

Если в настройках указано, что автоматическое прохождение недоступно, обратитесь в поддержку. Переключатель сайта и настройки сценария не включают недоступную функцию и не расширяют тариф.

Какие проверки поддерживаются

В настройках доступны reCAPTCHA v2/v3, Cloudflare Turnstile, Яндекс SmartCaptcha, ввод текста с картинки и выбор объектов Яндекса в указанном порядке. Визуальное задание может открываться поверх страницы или внутри iframe.

Наличие поддержки типа не гарантирует прохождение каждого задания. Неизвестный вариант, нестандартная разметка или отказ сайта завершаются понятной ошибкой. Не считайте отсутствие ошибки HTTP подтверждением сбора: вместо каталога сайт иногда возвращает форму проверки со статусом 200.

Что проверить после запуска

• В прогоне есть ожидаемые записи с нужными полями, а не текст формы CAPTCHA.
• После отправки формы появился результат, который подтверждает сам сайт: каталог, личный раздел или сообщение об успешной операции.
• В журнале нет сообщения о неподдерживаемой проверке, исчерпании бюджета или отказе сайта.
• В истории расходов выбранного пространства отражены только выполненные попытки. Отсутствие CAPTCHA не создаёт платного задания распознавания; время работы браузера учитывается отдельно.

Для учебной проверки подходит официальная форма SmartCaptcha. Введите тестовое имя и убедитесь, что сервер показал приветствие с ним. Форма может выдавать разные варианты задания; успешная текстовая проверка не подтверждает выбор картинок.

Если автоматического определения недостаточно

Раскройте Указать проверку вручную. Выберите тип и укажите только недостающие сведения: открытый ключ виджета, действие или селекторы элементов. Секретные ключи владельца сайта, пароли и cookies в эти поля не вводятся.

Признак успешной загрузки должен появляться после успешной операции. Постоянная шапка, меню или надпись, которая была видна до проверки, для этого не подходят. Кнопка подтверждения нужна, только если продолжение не происходит автоматически. Поля пользовательской формы заполняет сам сценарий.

Отключение

Переключатель в настройках сайта отключает прохождение для этого источника. Разработчик может отключить только автоматический режим конкретного HTTP-запроса или всей браузерной сессии: autoCaptcha=false в PHP/JavaScript/TypeScript, auto_captcha=False в Python. При этом страница может остаться закрытой проверкой.

Собственный агент

Автоматический режим и его отключение работают на собственном агенте. Нужны браузер, доступ к Akmelo и разрешённый тарифом агент. Дополнительные ключи для CAPTCHA на сервере агента настраивать не требуется. Количество и стоимость проверок учитываются у его пространства. Локальное выполнение сбора не делает CAPTCHA бесплатной.

Оплата и пределы

Проверки расходуют бюджет обработки; затем, если разрешены дополнительные расходы, общий баланс. Количество заданий за период учитывается отдельно. После количества тарифа продолжение возможно при доступном балансе и разрешённых расходах.

Цены в таблице показаны за 1 000 заданий для удобства сравнения, но каждое задание оплачивается отдельно. «До» означает максимальный резерв. После определения фактической суммы лишняя часть резерва освобождается. Дополнительное задание в той же CAPTCHA может учитываться как отдельная попытка.

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

Публичные цены · SDK и API · Баланс и лимиты

Разборы сценариев по языкам

В каждом SDK есть группа «Работа с CAPTCHA»: общий алгоритм и 12 подробных разборов с полным кодом.

PHP · JavaScript · TypeScript · Python

Явный API заданий

В SDK есть ctx.captcha() (PHP: $ctx->captcha()) для заданий, которые разработчик создаёт явно: актуальные типы, схемы, оценка цены, отправка, чтение статуса, ожидание и обратная связь. Новые типы этого каталога не определяются и не применяются браузером автоматически. Внешний ключ не нужен; вся работа учитывается в пространстве.

PHP · JavaScript · TypeScript · Python

Каталог и оценка цены не создают платное задание. Его создаёт createTask (Python: create_task). Вернувшийся taskId принадлежит Akmelo. getTaskResult читает его, waitForResult ожидает без новой отправки. Предел options.maxCost задаётся в микро₽: 1 000 000 единиц = 1 ₽. Полученный ответ сам по себе не доказывает принятие сайтом. Таймаут ожидания и остановка прогона не обещают отмену задания или возврат.