Перейти к основному содержимому

Как запустить CookieRobot с помощью Script Runner в Postman

CookieRobot — это ваш незаменимый инструмент для автоматизации сбора cookies с выбранных веб-сайтов, что делает профили браузера более аутентичными без ручных усилий. В этом руководстве мы шаг за шагом расскажем, как запустить CookieRobot с использованием конечной точки Script Runner в Postman.

Независимо от того, новичок вы в области автоматизации или опытный пользователь, это пошаговое руководство поможет вам эффективно настроить, адаптировать и запустить CookieRobot. Используйте оглавление, чтобы перейти к конкретным разделам, если вы уже выполнили некоторые шаги.

Предварительные требования​

Перед началом убедитесь, что у вас есть:

  • Аккаунт Postman и установленное приложение Postman для настольных компьютеров или веб-версия.
  • Доступ к коллекции Indigo X API в Postman.
  • Установлен Agent версии 1.37.4 или новее. Проверьте версию вашего агента здесь.
  • Токен API, настроенный в Postman. Следуйте руководству по настройке Как настроить Indigo X API с Postman, чтобы настроить аутентификацию и получить ваш Bearer Token.
Будьте в курсе

Убедитесь, что ваш Agent версии 1.37.4 или выше для использования Script Runner. Устаревшие версии могут вызвать проблемы совместимости.

Шаг 1: Настройка аутентификации в Postman​

Для взаимодействия с конечной точкой Script Runner необходимо аутентифицировать запросы Postman с использованием Bearer Token. Если вы еще не настроили это, выполните следующие шаги:

  1. Завершите настройку аутентификации, описанную в Как настроить Indigo X API с Postman, включая раздел Настройка Bearer Token для запросов.
  2. Сохраните ваш API-токен в переменной Postman или скопируйте его в буфер обмена для удобного доступа.

После настройки аутентификации вы готовы к доступу к конечной точке Script Runner и запуску CookieRobot!

Шаг 2: Открытие Script Runner в Postman​

Конечная точка Script Runner позволяет выполнять скрипты автоматизации, такие как CookieRobot. Вот как это настроить:

  1. В Postman перейдите в Collections → папка Indigo X API.

  2. Откройте папку Script Runner.

  3. Выберите конечную точку POST Start Script Runner для настройки нового API-запроса.

    Конечная точка Script Runner

  4. Перейдите на вкладку Params и выберите под-вкладку Authorization.

  5. Установите Auth Type на Bearer Token.

  6. Вставьте ваш API-токен в поле Token (используйте токен, сохраненный в переменной или скопированный ранее).

    Настройка Bearer Token

Аутентификация завершена

После установки Bearer Token вы полностью авторизованы для отправки запросов к конечной точке Script Runner и запуска CookieRobot.

Шаг 3: Добавление скрипта CookieRobot​

CookieRobot поддерживает все типы профилей браузера, кроме мобильных профилей. Чтобы настроить скрипт, вам нужно добавить тело запроса CookieRobot в Postman.

  1. В конечной точке POST Start Script Runner перейдите на вкладку Body.

  2. Выберите опцию raw и убедитесь, что формат установлен на JSON.

  3. Вставьте следующее примерное тело запроса CookieRobot:

    {
        "script_file": "cookie_robot.py",
        "profile_ids": [
            {
                "profile_id": "uuid профиля"
            },
            {
                "profile_id": "uuid профиля",
                "is_headless": true
            }
        ],
        "script_params": [
            {
                "name": "websites",
                "value": ["https://youtube.com", "https://google.com", "https://fb.com", "https://amazon.com"]
            },
            {
                "name": "randomOrder",
                "value": true
            },
            {
                "name": "fractionMode",
                "value": 0.7
            },
            {
                "name": "processCookieConsent",
                "value": true
            }
        ]
    }

    Тело запроса CookieRobot

  4. Обратите внимание, что поле script_file предустановлено на cookie_robot.py. Вам не нужно изменять это поле.

UUID профилей

Замените "uuid профиля" в разделе profile_ids на фактические UUID профилей браузера, которые вы хотите использовать. Вы можете найти их в вашей панели управления Indigo или через DevTools.

Шаг 4: Настройка параметров CookieRobot​

CookieRobot предлагает несколько настраиваемых параметров, чтобы адаптировать процесс сбора cookies под ваши потребности. Они определяются в разделе script_params тела запроса. Ниже приведен обзор ключевых параметров:

Ключевые параметры​

Список профилей браузера для запуска CookieRobot. Каждый элемент включает:

  • profile_id: Уникальный UUID профиля браузера.
  • is_headless (опционально): Установите значение true для запуска в headless-режиме (без видимого окна браузера). Обратите внимание, что headless-режим может ограничивать взаимодействие с некоторыми элементами страницы.

Пример:

"profile_ids": [
    {
        "profile_id": "123e4567-e89b-12d3-a456-426614174000"
    },
    {
        "profile_id": "987fcdeb-12ab-34cd-5678-426614174001",
        "is_headless": true
    }
]

Шаг 5: Запуск CookieRobot​

После настройки параметров пришло время запустить CookieRobot:

  1. Нажмите кнопку Send в Postman, чтобы выполнить запрос POST Start Script Runner.

  2. Проверьте ответ:

    • Статус 200 OK: Скрипт успешно запущен! Если используется не-headless режим, вы можете наблюдать за процессом сканирования в реальном времени.
    • Статус 401 Unauthorized: Ваш токен мог истечь. Повторно аутентифицируйтесь, повторив шаги настройки токена [/api/postman-automation/configure-postman].

  3. CookieRobot начнет собирать cookies для указанных профилей и веб-сайтов.

Возможные проблемы

Использование Cloudflare Zero Trust, внешних прокси или VPN может мешать работе CookieRobot. Отключите их, если возникнут проблемы.

Устранение неполадок​

  • Ошибка 401 Unauthorized: Повторно аутентифицируйтесь и обновите ваш Bearer Token.
  • Скрипт не запускается: Убедитесь, что версия вашего Agent 1.37.4 или выше, и что UUID профилей верны.
  • Cookies не собираются: Проверьте, что указанные веб-сайты доступны и что параметр processCookieConsent настроен правильно.

Для дополнительной помощи обратитесь к документации Script Runner или свяжитесь с поддержкой Indigo.