Skip to content

MCP для ИИ-агентов

Инструкции для ИИ-агентов — подключение к MCP-серверу CaptchaSonic, выбор инструмента, поиск sitekey и отправка токена или ответа.

Эта страница написана для ИИ-агентов. Дайте агенту ссылку на неё (или на markdown-версию), и он сможет сам настроиться и решать капчи без дополнительных инструкций.

Connect

  1. Попросите у пользователя API-ключ CaptchaSonic (начинается с sonic_). Его можно получить на https://my.captchasonic.com. Никогда не придумывайте ключ и не берите его из других мест.
  2. Добавьте хостинг-сервер с транспортом Streamable HTTP:
    • URL: https://mcp.captchasonic.com
    • Заголовок: Authorization: Bearer <ключ>
  3. Если у вашей среды есть CLI, используйте его. Claude Code:
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
  1. Если среда поддерживает только локальные (stdio) серверы, запустите npx -y @captchasonic/mcp-server с переменной окружения SONIC_API_KEY, равной ключу.
  2. Проверьте подключение вызовом get_balance. Число — всё работает; ERROR_KEY_DOES_NOT_EXIST — неверный ключ.

Decide which tool

  • На странице есть виджет капчи, который выдаёт скрытый токен (reCAPTCHA, Turnstile, hCaptcha-подобные, GeeTest, MTCaptcha), или страница Cloudflare «проверка браузера» → solve_token_captcha.
  • Перед вами визуальная головоломка (выбрать картинки, сдвинуть слайдер, прочитать искажённый текст, прослушать аудио) → solve_image_captcha.
  • Не уверены → вызовите list_captcha_types.

Solve a token CAPTCHA

  1. Найдите sitekey на странице:
    • reCAPTCHA: data-sitekey у .g-recaptcha или render= в URL скрипта recaptcha/api.js. Если страница вызывает grecaptcha.execute, это v3.
    • Turnstile: data-sitekey у .cf-turnstile (начинается с 0x4).
    • hCaptcha-подобные: data-sitekey у .h-captcha.
    • GeeTest v4: captchaId в вызове initGeetest4.
  2. Вызовите solve_token_captcha с type, website_url (URL страницы) и website_key.
  3. Вставьте полученный token в поле формы виджета — g-recaptcha-response, cf-turnstile-response или h-captcha-response — и отправьте форму или вызовите callback страницы.
  4. Для cloudflare_challenge установите возвращённые cookies и отправляйте дальнейшие запросы с возвращённым user_agent.
  5. Если инструмент вернул "status": "processing", подождите несколько секунд и вызовите get_task_result с task_id.

Токены действуют около двух минут. Решайте непосредственно перед отправкой.

Solve an image CAPTCHA

  1. Сохраните каждое изображение задания отдельно, в порядке на экране. Обрежьте до самого изображения, не отправляйте всю страницу.
  2. Скопируйте текст задания точно (например, Select all images with a bus).
  3. Вызовите solve_image_captcha с type, images и question. Для слайдеров передайте фрагмент в examples.
  4. Примените answers, как описано в answer_format результата: кликните по индексам клеток, сдвиньте на полученное смещение или введите текст.

Handle errors

  • ERROR_CAPTCHA_UNSOLVABLE или ERROR_CAPTCHA_TIMEOUT: перезагрузите задание и попробуйте ещё раз. Списания не было.
  • ERROR_ZERO_BALANCE: остановитесь и попросите пользователя пополнить баланс на https://my.captchasonic.com.
  • ERROR_MISSING_REQUIRED_FIELDS: добавьте параметр, указанный в сообщении.
  • Не зацикливайтесь. После двух неудач на одной странице сообщите пользователю.

Решайте капчи только на сайтах, которые пользователь имеет право автоматизировать.