Руководство по браузерному расширению CapSkip
Узнайте, как установить и настроить расширение CapSkip для браузера для автоматического распознавания капчи.
Браузерное расширение CapSkip подключает ваш браузер к приложению CapSkip, которое работает на вашем компьютере или сервере как распознавание капчи ; расширение автоматически решает поддерживаемые капчи.
Когда появляется капча, расширение отправляет запрос в CapSkip через настроенный IP сервера и Порт. CapSkip решает её локально и возвращает результат, который расширение автоматически применяет на странице.
Поддерживаемые типы капчи: графические капчи, reCAPTCHA v2, reCAPTCHA v2 Invisible, reCAPTCHA v3, Cloudflare Turnstile, hCaptcha, Amazon WAF, GeeTest v3, ALTCHA, CaptchaFox, Capy Puzzle, Friendly Captcha и DataDome.
- Установите расширение из Интернет-магазина Chrome или магазина дополнений Firefox.
- Откройте всплывающее окно расширения и введите IP сервера и порт вашего приложения CapSkip. Если CapSkip работает на этом же компьютере, укажите localhost и 8080.
- Посмотрите на строку под API-ключом. Когда она зелёная и на ней написано «Приложение CapSkip подключено», поддерживаемые капчи решаются автоматически.
- Для капчи-изображения на каждом сайте нужен ещё один шаг: свяжите изображение с полем для ответа.
Установка
Добавьте расширение в браузер, затем подключите его к приложению CapSkip на вашем компьютере или сервере.
Chrome и браузеры на основе Chromium: установите CapSkip из Chrome Web Store и нажмите Добавить в Chrome.
Brave, Edge, Opera и Vivaldi работают с расширениями Chrome, поэтому устанавливают его из того же магазина.
Firefox: установите CapSkip из Магазин дополнений Firefox и нажмите Добавить в Firefox.
Закрепите расширение: откройте меню расширений браузера на панели инструментов и закрепите CapSkip, чтобы всплывающее окно открывалось одним нажатием.
Затем откройте всплывающее окно и подключите его к приложению CapSkip, как описано в разделе Всплывающее окно расширения.
Всплывающее окно расширения
Нажмите на значок CapSkip на панели инструментов браузера. Справа показана каждая часть всплывающего окна, слева описано, что она делает.
Язык переключает язык расширения: английский, китайский, испанский, русский или персидский. Тема: «Авто» следует настройке операционной системы, «Светлая» и «Тёмная» не меняются.
Вкл / Выкл включает или выключает решение капчи. В выключенном состоянии расширение ничего не отправляет в CapSkip. Эти три элемента общие для всплывающего окна и страницы настроек.
IP сервера: localhost , если CapSkip работает на том же компьютере, кнопка заполнит поле сама. На VPS введите публичный IP-адрес сервера.
Порт: порт, заданный в CapSkip, 8080 по умолчанию.
Нужен, только если Проверка API-ключа включена в приложении CapSkip, иначе оставьте поле пустым. Попробовать бесплатно, ссылка вверху карточки, открывает бесплатную пробную версию, если у вас ещё нет лицензии.
Зелёный: всё готово. Красный: по этому IP и порту никто не ответил, проверьте, что CapSkip запущен. Жёлтый: кто-то ответил, но проверка не прошла, обычно из-за отклонённого API-ключа.
Проверка запускается при открытии всплывающего окна и после каждого изменения. Нажмите на индикатор, чтобы запустить её снова.
У каждого типа капчи свой переключатель. Счётчик показывает, сколько из них включено. Шесть самых распространённых типов идут первыми, остальные семь находятся в группе Другие типы, и всплывающее окно запоминает, открыта она или закрыта.
Выбрать на странице связывает графическую капчу с её полем ответа, подробнее в разделе Настройка графической капчи. Token передаёт странице токен reCAPTCHA v2, Нажмите решает задание с картинками, нажимая на них.
Каждый тип описан в разделе Типы капчи.
Сканирует открытую вкладку, включая все фреймы, и показывает каждую найденную капчу: Включено (CapSkip её решает), Выключено (поддерживается, переключатель выключен) или Не поддерживаются, например Arkose Labs (FunCaptcha).
Копировать копирует параметры задачи в формате JSON для CapSkip API или для поддержки. Если страницу не удаётся просканировать, перезагрузите вкладку и попробуйте снова.
0x4AAAAAAA…https://example.com/loginКак CapSkip работает в этом браузере за сегодня или за последние 7 дней: сколько капч решено, доля успешных попыток и среднее время решения, а ниже отдельная строка для каждого типа капчи.
Статистика хранится только в этом браузере. Активность, страница настроек, показывает все недавние решения и позволяет очистить статистику.
Ручное решение: капча ждёт, пока вы не нажмёте Solve with CapSkip на странице, и кнопка показывается всегда.
Черный список доменов: пока переключатель включён, CapSkip не работает на этих сайтах. example.com охватывает и все поддомены, а запись со слешем, например example.com/login, блокирует только страницы, адрес которых её содержит.
Дополнительные настройки открывает полную страницу настроек, описанную ниже.
Настройка капчи-картинки
Для графических капч нужен один шаг на каждом сайте: указать CapSkip, какая картинка является капчей и куда вводить ответ.
Выбрать на странице (рекомендуется): откройте сайт, откройте всплывающее окно и нажмите Выбрать на странице рядом со строкой «Графическая капча». На странице появится баннер CapSkip.
Нажмите на капчу. При движении мыши элементы подсвечиваются, а в баннере показывается превью выбранного элемента.
Затем нажмите на поле, куда вводится ответ. Баннер подтвердит привязку, и с этого момента ответ будет вводиться сам при каждом посещении.
Этот способ работает и на сайтах, где заблокировано контекстное меню. Повторная привязка уже привязанной капчи обновляет её, а не добавляет вторую.
Контекстное меню: нажмите правой кнопкой мыши на изображение капчи и выберите Пометить как источник CAPTCHA, затем нажмите правой кнопкой мыши на поле ответа и выберите Введите ответ на капчу здесь.
Оба способа создают одну и ту же сохранённую привязку, она появится в разделе Сохранённые привязки.
Кнопка «Решить с CapSkip»
Тёмная кнопка, которую CapSkip добавляет на страницы с капчей. Её расположение задаётся в разделе Автоматизация форм.
Готова: на кнопке написано Solve with CapSkip. Если включено ручное решение, нажмите на неё, чтобы начать.
Распознавание: крутится кольцо и идёт таймер. Решено: кнопка становится зелёной и показывает затраченное время. Ошибка: пара слов о том, что пошло не так. Наведите курсор, чтобы увидеть код, нажмите, чтобы повторить попытку.
Если кнопка закреплена внизу справа, в покое она выглядит как маленький круглый замок и раскрывается при наведении или когда ей есть что сообщить.
| Сообщение об ошибке | Что делать |
|---|---|
| Ошибка соединения | Расширение не смогло связаться с CapSkip. Проверьте, что приложение запущено, а IP и порт совпадают. |
| Сначала настройте CapSkip | Адрес сервера ещё не задан. Укажите его в разделе «Сервер и API-ключ». |
| Недействительный API-ключ | CapSkip отклонил ключ. Скопируйте его заново из приложения CapSkip. |
| Недостаточно средств | У API-ключа не осталось решений. Увеличьте или сбросьте его лимит в настройках API-ключа в приложении CapSkip. |
| Ваш IP заблокирован | API-ключ ограничен одним устройством и уже используется с другого IP-адреса, либо сайт заблокировал ваш IP-адрес. |
| Эту капчу невозможно решить | Решатель не справился с этой капчей. Обновите страницу, чтобы получить новую. |
| Капча устарела. Обновите страницу | Капча истекла до того, как её использовали. |
| Не удалось решить | Любая другая ошибка. Код ошибки появляется при наведении курсора на кнопку. |
Страница настроек
Все параметры расширения на одной странице с боковой панелью: «Подключение», «Решение» и «Ещё». Ниже каждая часть воссоздана вместе с пояснением.
Сервер и API-ключ
Где работает CapSkip. Расширение отправляет туда каждую капчу.
Тот же адрес, что и во всплывающем окне, с подсказкой под каждым полем.
На этой странице ключ скрыт. Кнопка с глазом показывает его.
Просит CapSkip по этому адресу ответить и сообщает результат простыми словами. Четвёртый вариант, не CapSkip, означает, что на этом IP и порту отвечает какая-то другая программа.
http://localhost:8080. Держите CapSkip запущенным, пока работаете в браузере.Типы капчи
Тринадцать типов капчи, у каждого свой переключатель. Включённые типы обнаруживаются и решаются автоматически.
Тот же переключатель, что и во всплывающем окне. Когда он включён, на каждой карточке написано Вкл · вручную.
Включает или выключает все типы сразу.
Текст на картинке. Для каждого сайта нужна однократная привязка, подробнее в разделе Настройка графической капчи.
Флажок и задание с картинками от Google. Token возвращает токен проверки, Нажмите решает картинки, как человек.
Срабатывает сама при отправке формы или нажатии кнопки.
Оценивает посетителей в фоне и возвращает токен, который запрашивает страница.
Проверка от Cloudflare. Для сайтов, которые снова и снова показывают новую проверку, см. раздел Дополнительно.
Решает задачи hCaptcha.
Капча, которую Amazon WAF (AWS WAF) показывает перед защищёнными сайтами.
Решает задания GeeTest v3.
Решает задания ALTCHA.
Решает задания CaptchaFox.
Решает задания Capy Puzzle.
Решает задания Friendly Captcha.
И слайдер, и проверка устройства. Работает только в Chrome, решается с собственного IP вашего браузера. DataDome требует Chrome под Windows или IP заблокирован DataDome на кнопке означают, что нужен другой браузер или IP.
Автоматизация форм
Необязательные функции, которые работают до и после решения.
Ждёт заданную задержку, затем отправляет форму. Если для страницы подходит правило автоотправки , вместо этого выполняется правило.
Для страниц, которые загружают новую графическую капчу без перезагрузки, например после неверного ответа.
Делает паузы между символами в пределах диапазона, ждёт перед первым символом и может сначала очистить поле. Некоторые сайты принимают только ответы, введённые так, как их вводит человек.
0 отключает повторы. Ошибки, которые повтор не исправит, например неверный API-ключ, никогда не повторяются.
Закрепить на странице используется по умолчанию. Скрыто не показывает кнопку и решает автоматически, но если включено ручное решение, кнопка всё равно появляется внизу справа, ведь только с её помощью можно запустить решение.
Сайты и правила
Всё, что относится к отдельным сайтам.
Чёрный список доменов
Тот же чёрный список, что и во всплывающем окне, только просторнее. Счётчик показывает, сколько у вас записей, а редактировать их можно в двух режимах:
Список: добавляйте записи по одной и удаляйте их крестиком рядом с записью.
Текст: редактируйте весь список сразу, по одной записи в строке. Строки, которые не совпадут ни с одним сайтом, указываются под полем.
Записи работают так же, как во всплывающем окне: example.com охватывает и свои поддомены, а запись с косой чертой, например example.com/login, блокирует только страницы, адрес которых её содержит. Список действует, только пока переключатель включён.
Правила автоотправки
Этот раздел позволяет задать пользовательские действия, которые должны выполняться после решения капчи.
По умолчанию AutoSubmit функция автоматически отправляет форму, содержащую поле ответа капчи. Однако некоторые сайты требуют дополнительных шагов после решения капчи, например нажатия определённой кнопки или запуска другого действия. В таких случаях здесь можно создать пользовательские правила.
capskip.com/demodocument › querySelector("button[type=submit]") › click()ИзменитьУдалитьСоздать правило
Создать новое правило открывает редактор правила прямо в карточке. Заполните шаблон URL и последовательность действий, затем нажмите Сохранить, а кнопка Отменить закрывает редактор без сохранения. Если шаблон не является допустимым регулярным выражением или не указано ни одного действия, редактор сообщит об этом до сохранения.
Сохранённые правила перечислены в карточке вместе с шаблоном и коротким понятным описанием действий, например document › querySelector("#submit-button") › click(). Кнопка Изменить открывает правило для правки, а Удалить удаляет его.
{"type":"source","value":"document"}
{"type":"method","value":"querySelector","args":["#submit-button"]}
{"type":"method","value":"click"}Шаблон URL
Укажите сайт, на котором должно действовать правило. Шаблон URL задаётся регулярным выражением, например ^https://example\.com/login. Расширение выполняет правило только на страницах, адрес которых соответствует шаблону, и срабатывает первое подходящее правило.
https://example.com/login и https://example.com/login?next=/, а не https://shop.example.com/login.Последовательность действий
Поле «Последовательность действий» определяет шаги, которые расширение должно выполнить после решения капчи. Каждое действие представляет собой команду, выполняемую расширением для взаимодействия с элементами на странице.
Действия записываются как отдельные объекты JSON, по одному в строке, и выполняются сверху вниз в том порядке, в котором они указаны.
Каждое действие содержит type и value, а некоторые действия могут включать дополнительные аргументы через args.
Кнопки «Вставить» над полем добавляют за вас три самых частых действия: document, querySelector и click. Измените селектор во вставленной строке, чтобы он соответствовал кнопке на вашей странице.
Базовая структура: каждое действие записывается в показанном формате, а несколько действий пишутся на отдельных строках.
В этом примере расширение будет:
Начните с документа страницы
Найдите элемент, соответствующий селектору
#submit-buttonНажмите на выбранный элемент
Поскольку действия выполняются последовательно, порядок строк важен.
{"type":"ACTION_TYPE","value":"ACTION_VALUE","args":[...]}{"type":"source","value":"document"}
{"type":"method","value":"querySelector","args":["#submit-button"]}
{"type":"method","value":"click"}Частые действия
1. source: задаёт начальный контекст, в котором будут искаться элементы.
2. method: querySelector: выбирает элемент с помощью CSS-селектора. Здесь он находит элемент с ID submit-button.
3. method: click: вызывает нажатие на выбранный сейчас элемент. Это имитирует нажатие на элемент, выбранный на предыдущем шаге.
{"type":"source","value":"document"}{"type":"method","value":"querySelector","args":["#submit-button"]}{"type":"method","value":"click"}Сохранённые привязки
Сохранённые привязки (последняя карточка на странице Сайты и правила в настройках) хранят, какой элемент на конкретном сайте является графической капчей и какое поле получает ответ. Выбрать на странице и пункты контекстного меню создают такие привязки.
В каждой строке указаны сайт и путь страницы, превью капчи и привязанное поле ответа. Привязка с пометкой Поле не привязано или Капча не привязана настроена лишь наполовину, а Нет превью означает, что изображение капчи не было сохранено.
Удалите неправильную или устаревшую привязку, а затем настройте её заново на самой странице сайта. Примечание под списком объясняет оба способа добавить привязку.
/captcha-demo/text-captcha//signupАктивность
Последние 200 решений в этом браузере.
Капчи, с которыми работал CapSkip, сначала новые: тип, сайт, Решено или Ошибки, сколько это заняло и когда. В строке с ошибкой также показана сама ошибка.
Очистить историю очищает список и сбрасывает статистику решений во всплывающем окне, причём несколько секунд действие можно отменить. История хранится только в этом браузере и никогда не попадает в резервную копию.
capskip.comcapskip.comcapskip.comРасширенные настройки
Дополнительное поведение для сложных сайтов.
Оставьте выключенным, если только сайт не показывает новую проверку Turnstile после решения первой.
Прокси
Решайте капчи через свой прокси.
Включает или выключает прокси, не удаляя адрес. Пока он включён, в боковой панели показывается Вкл. рядом с пунктом «Прокси». Когда прокси выключен, CapSkip использует настройки прокси самого приложения, см. руководство по настройке.
Тип прокси: HTTP, HTTPS, SOCKS5 или SOCKS5H, который разрешает адреса сайтов на стороне прокси.
Адрес прокси: IP:PORT, а кнопка login:password@IP:PORT для аутентификации по логину.
Только DataDome решается с вашего собственного IP-адреса.
Резервная копия и восстановление
Перенос настроек между браузерами.
Самый быстрый способ перенести настройки в другой браузер или на другой компьютер. Храните файл в секрете: в нём ваш API-ключ.
Перед заменой чего-либо запрашивает подтверждение. Принимаются только файлы, экспортированные расширением CapSkip.
