Files
robotex/docs/Introduction.md
T
2026-09-09 14:39:56 +04:00

2.9 KiB

WebRobo API

Сервис позволяет отработать на странице JS и продолжить парсинг. Полезно для ботов, которым нужно авторизоваться на сайте или пройти капчу, там где требуется рендеринг JS.

Запрос и ответ

Параметры запроса:

  • URL - обязательно нужно указать с каким сайтом будем работать
  • proxy - обязательно нужно задать прокси, система не станет палить свою инфраструктуру
  • user_agent - заголовок браузера, если не передать будет использован свой
  • screen - размер окна, по умолчанию: 1280х920
  • timeout - общий таймаут выполнения запроса, по умолчанию: 120
  • captcha - токен сервиса распознавания, если требуется решить капчу на странице
  • actions - перечисление списка действий, которые на странице нужно выполнить

Настройка actions:

  • type - тип запроса из перечисления
  • selector - css селектор
  • value - значение для вставки
  • timeout - время выполнения или ожидания

Доступные типы actions:

  • wait_for - ожидание появления элемента
    • selector
    • timeout
  • mouse_move - перемещение курсора
    • selector
  • click - клик
    • selector - если не передан, то клик в текущей позиции
  • fill - заполняет поля
    • selector
    • value - значение будет впечатано

Будет добавлено:

  1. {"type": "typing", "value": "user@example.com"}, - набор текста
  2. {"type": "innerhtml", "selector": "#email"}, - получить контент
  3. {"type": "script", "source": "console.log(\"hello world\")"}, - выполнить скрипт

Ответ:

  • URL - итоговый урл из адресной строки на момент окончания работы
  • user_agent - заголовок браузера
  • screen - размер окна
  • exc_time = время выполнения
  • actions_result - отчет о выполненых действиях
  • ok - выполнился ли этот запрос успешно
  • error - для сообщения об ошибке

Результат отработки actions

  • type - тип события
  • ok - успешность события
  • error - появляется, когда событие сработало с ошибкой
  • message - появляется, для команд возвращающих результат