Решение капчи
для ИИ-агентов
Агент, встретивший проверку, молча зависает. Сделайте решение капчи инструментом, и блокировка станет ещё одним детерминированным вызовом.
Вставьте это в своего агента для программирования
Claude Code, Cursor, Codex, Copilot или Windsurf: промпт запросит ваш API-ключ, добавит MCP-сервер, подключит хелпер решения капчи к вашему проекту и проверит всё от начала до конца.
Настрой CaptchaNo (https://captchano.com) в этом проекте, чтобы капчи больше не блокировали нашу браузерную автоматизацию. Сначала прочитай полное руководство по настройке и следуй ему: https://captchano.com/agents/setup.md Кратко: 1. Попроси у меня API-ключ CaptchaNo (он начинается с "cn-"; я могу создать его на https://captchano.com/dashboard/keys). Никогда не прописывай его в коде, не выводи, не логируй и не коммить. Сохрани его как CAPTCHANO_API_KEY в .env проекта, который игнорируется git, или в хранилище секретов. 2. Если ты поддерживаешь MCP, подключи себе MCP-сервер CaptchaNo: команда "npx -y captchano-mcp", переменные окружения CAPTCHANO_API_KEY и CAPTCHANO_MAX_SPEND_USD=1.00 (в Claude Code: claude mcp add captchano -e CAPTCHANO_API_KEY=<key> -e CAPTCHANO_MAX_SPEND_USD=1.00 -- npx -y captchano-mcp). 3. Если этот код управляет браузером или HTTP-клиентом (Playwright, Puppeteer, Selenium, Scrapy, requests...), добавь один небольшой хелпер solveCaptcha, который вызывает POST https://api.captchano.com/v1/solve?wait=60 с ключом в заголовке Bearer, и подставляй полученный токен так, как показано в руководстве. Используй существующий HTTP-клиент и стиль кода проекта. 4. Проверь: посмотри баланс (инструмент get_balance или GET /v1/balance), затем выполни сквозную проверку одним решением из руководства (она решает reCAPTCHA на https://captchano.com/tools/captcha-demo и подтверждает, что Google принимает токен). Поддерживаются: reCAPTCHA v2/v3/Enterprise, Cloudflare Turnstile, DataDome (нужен наш собственный прокси) и капчи-картинки. Неудачные решения не оплачиваются. Автоматизируй только сайты, которые принадлежат нам или которые нам разрешено автоматизировать. Когда закончишь, расскажи, что ты изменил.
Полное руководство, которому следует агент: captchano.com/agents/setup.md
Настройка, типизированные ответы и стоимость каждого решения на виду.
Настройка, типизированные ответы и стоимость каждого решения на виду.
Настройка, типизированные ответы и стоимость каждого решения на виду.
Настройка, типизированные ответы и стоимость каждого решения на виду.
Настройка, типизированные ответы и стоимость каждого решения на виду.
Настройка, типизированные ответы и стоимость каждого решения на виду.
Почему агенты застревают на капче
Скрипт, встретив проверку, падает с ошибкой. Агент проваливается молча, и это хуже.
В типичном наборе инструментов агента нет ничего, что могло бы решить сетку с картинками или проверку с оценкой сессии, поэтому агент застревает на странице.
Модели придумывают правдоподобный следующий шаг и сообщают о прогрессе, которого не было. Сбой проходит незаметно.
Агент, который снова и снова перезагружает страницу с проверкой, тратит токены и время, не приближаясь к цели.
Дайте агенту инструмент для решения капчи
- 01Оберните API в инструмент
Одна функция, которая принимает type, sitekey и URL и вызывает /v1/solve?wait=60.
- 02Не передавайте ключ в промпте
Читайте его из переменных окружения внутри инструмента, чтобы модель никогда его не видела.
- 03Возвращайте типизированный результат
Токен, использованный user agent и стоимость — чтобы агент мог отправить форму и учесть расходы.
- 04Ограничьте цикл
Ограничьте число решений или расходы на запуск, чтобы запутавшийся агент не зациклился на странице.
Что возвращает инструмент
Каждый ответ содержит токен или cookie, user agent, с которым он был получен, и стоимость решения. Агент может воспроизвести user agent при отправке, а супервизор — остановить запуск, когда расходы превысят порог. Форматы запросов для всех типов проверок — в справочнике API.
SDK не нужен
CaptchaNo — обычный REST API, поэтому каждое руководство по фреймворкам выше — это несколько строк вашего собственного кода, а не пакет, которому нужно доверять. Это также означает, что тот же инструмент работает в любом фреймворке, для которого мы ещё не написали руководство.
Частые вопросы о капче для ИИ-агентов
Может ли ИИ-агент сам решать капчу?
Иногда он может кликнуть по чекбоксу, но не способен надёжно решать задания с картинками, а автоматизированным браузерам их показывают чаще. Инструмент решения превращает проверку в один детерминированный вызов, по результату которого агент может ветвиться.
Какие фреймворки для агентов поддерживаются?
Любой фреймворк, который умеет вызывать HTTP API. У нас есть руководства для MCP, LangChain, Browser Use, OpenAI Agents SDK, CrewAI и n8n, а тот же подход работает и в других.
Есть ли MCP-сервер CaptchaNo?
Да. captchano-mcp — MCP-сервер с открытым исходным кодом (MIT), который запускается командой npx -y captchano-mcp. Он читает ваш API-ключ из переменных окружения, а не из модели, и поддерживает необязательный лимит расходов. Он опубликован в официальном MCP Registry.
Как не дать агенту потратить слишком много?
Каждый результат содержит свою стоимость. Ведите накопительный итог в инструменте или контексте запуска и отказывайте в новых решениях после превышения бюджета.
Разрешено ли позволять агентам решать капчу?
Это зависит от сайта и задачи. Предполагаемые сценарии — агенты, действующие в ваших собственных аккаунтах, тестирующие ваши системы или собирающие данные, сбор которых сайт разрешает. Сначала прочитайте условия целевого сайта.
Полезные руководства
Готовы начать?
Начните с бесплатного 3-дневного пробного периода, а по мере роста трафика платите за каждое успешное решение. Для пробного периода карта не нужна.