CookieRobot помогает сделать ваши профили более реалистичными, автоматически собирая файлы cookie с выбранных сайтов. Вам не нужно сканировать их вручную — все происходит в фоновом режиме.

В этом гайде разберем, как использовать CookieRobot для оптимизации работы.

Уже знакомы с процессом или пропустили пару шагов? Откройте оглавление и сразу переходите к нужному разделу. Начнем!

Шаг 1: настройте Postman

После установки Postman откройте страницу Multilogin X API:

1. В правом верхнем углу нажмите «Run in Postman».
2. Выберите «Postman for <ваша ОС>».

Откроется ваш Postman Desktop. Вот как импортировать все эндпоинты в вашу локальную коллекцию:

1. В «Import collection» выберите свое рабочее пространство. 
2. Нажмите «Import» и все эндпоины будут доступны в папках. 

Войдите в аккаунт через Postman

Найдите эндпоинт входа пользователя

1. Откройте «Collections» → разверните папку «Multilogin X API». 
2. Откройте папку «Profile access management». 
3. Выберите эндпоинт User Sign In POST (Что такое запрос POST?). 

Конвертируйте свой пароль в MD5

Вот как использовать генератор хэшей MD5 для получения зашифрованного пароля:

1. Введите свой пароль Multilogin X. 
2. Нажмите «Generate». 
3. Скопируйте свой зашифрованный MD5 пароль. 

Получите свой API токен

1. В POST User Sign In перейдите на вкладку «Body». 
2. Введите свой адрес электронной почты и пароль MD5 в виде строк. 
3. Отправьте запрос на вход. 

4. Проверьте токен доступа в области ответа ниже и скопируйте все, что внутри кавычек. 

Шаг 2: откройте Script Runner

Теперь у вас есть полный доступ к эндпоинту Script Runner и запуску скрипта CookieRobot!

1. Вернитесь в папку «Collections» → «Multilogin X API».
2. Перейдите в папку «Script Runner». 
3. Откройте эндпоинт POST Start Script Runner для настройки нового запроса API!

4. Из вкладки «Params» перейдите в «Authorization». 
5. Выберите «Bearer Token» в качестве типа аутентификации.
6. В поле «Token» справа вставьте скопированный ранее API токен.

Добавьте скрипт CookieRobot

После того как ваш токен будет вставлен на вкладку «Authorization»:

1. Перейдите на вкладку «Body». 
2. Убедитесь, что выбран параметр raw.
3. Вставьте пример тела запроса CookieRobot (JSON):

{
    "script_file": "cookie_robot.py",
    "profile_ids": [
        {
            "profile_id": "profile uuid"
        },
        {
            "profile_id": "profile 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
        }
    ]
}

Шаг 3: настройте параметры

При запуске CookieRobot есть несколько настраиваемых параметров, которые влияют на то, как работает процесс сканирования. Они позволяют пользователям настраивать такие параметры, как целевой сайт, порядок сканирования и многое другое. Тонкая настройка этих параметров в разделе “script_params” позволяет пользователям оптимизировать производительность скрипта в соответствии со своими потребностями.

Настраиваемые параметры CookieRobot выделены красным цветом на снимке экрана и ниже:

“profile_ids”

Список, содержащий ID профилей, структурированный следующим образом:

• “profile_id” — уникальный ID профиля. 
• “is_ headless ” — (необязательно) работа в режиме headless может ограничить взаимодействие бота с определенными элементами страницы.

“script_params”

Список, содержащий набор настраиваемых параметров, обозначенных просто:

• “name” — имя параметра. 
• “value” — присвоенное значение (строка, целое число, число с плавающей точкой, JSON и т. д.). 

“websites”

Хотите получить файлы cookie с нескольких сайтов? Просто перечислите их здесь! Обратите внимание, что сайты могут быть перечислены с www., http:// или https://, или без них.

websites = [
  "https://aliexpress.com",
  "https://amazon.com",
  "https://ebay.com",
  "https://fiverr.com",
  "https://google.com",
  "https://reddit.com",
  "https://twitch.com",
  "https://twitter.com",
  "https://yahoo.com",
  "https://youtube.com",
  "https://en.wikipedia.org"
  ]

“randomOrder”

• Установите значение “true” → смешивайте и посещайте сайты случайным образом. 
• Установите значение “false” → сохраняйте порядок и посещайте сайты, указанные в списке. 

“fractionMode”

Хотите запустить только часть своих сайтов, а не все? Вот как:

1. Выберите число с плавающей точкой от 0,0 до 1,0, чтобы задать долю сайтов для запуска.
2. Убедитесь, что “randomOrder” установлен на “true”. 

Пример: если использовать "fractionMode"= “0.5”, то будет запущено 50% списка веб-сайтов в случайном порядке.

“processCookieConsent”

На многих сайтах отображается кнопка «Разрешить файлы cookie» из-за законов о конфиденциальности, таких как GDPR (Что такое GDPR?), которые требуют согласия пользователя перед отслеживанием файлов cookie.

• Установите значение “true” → CookieRobot будет автоматически искать и пытаться нажать кнопку согласия (по умолчанию). 
• Установите значение “false” → всплывающие окна cookie будут игнорироваться, что может быть полезно, если:
  • Вы просматриваете сайты за пределами ЕС, на которых не отображаются баннеры cookie. 
  • Вас не беспокоит соблюдение GDPR (например, использование прокси за пределами ЕС). 

Шаг 4: запустите CookieRobot

1. Нажмите «Send», чтобы выполнить запрос POST Start Script Runner.
2. Проверьте ответ на запрос: cтатус 200 ОК означает успех!
3. Ваш скрипт CookieRobot запустит выбранный профиль(и). 

Бонус: пример кода Python

В этом примере настройки кастомизируются в объекте payload внутри run_script():

• CookieRobot будет запущен через файл cookie_robot.py. 
• Используемые ID профилей установлены на ced16576-a67b-4ae5-8459-c07991d50f27 и ec0cf95f-b199-4b1c-b394-af1e01ac9c09. 
• Оба профиля будут работать в не- headless режиме.
• Сайты — Yahoo.com и Amazon.com, и они будут посещаться в случайном порядке.
• Поскольку fractionMode установлен на 1, будут посещены 100% перечисленных сайтов.
• CookieRobot автоматически примет уведомления о согласии на использование файлов cookie, если они появятся.

import logging
import requests
import json

# In project root you need a file called token with your auth token in there
def setup_logging():
    """Set up logging configuration."""
    logging.basicConfig(
        level=logging.INFO,
        format="%(asctime)s - %(levelname)s - %(message)s",
        handlers=[
            logging.FileHandler("script_runner.log"),
            logging.StreamHandler()
        ]
    )

def get_token_from_file():
    """Read the token from a file called 'token' in the project root."""
    try:
        with open("token", "r") as file:
            token = file.read().strip()
            return token
    except FileNotFoundError:
        logging.error("Token file not found in the project root.")
        raise
    except Exception as e:
        logging.error("An error occurred while reading the token file: %s", str(e))
        raise

def run_script():
    url = "https://launcher.mlx.yt:45001/api/v1/run_script"
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {get_token_from_file()}"
    }

    payload = {
        "script_file": "cookie_robot.py",
        "profile_ids": [
            {
                "profile_id": "ced16576-a67b-4ae5-8459-c07991d50f27",
                "is_headless": False
            },
            # {
            #     "profile_id": "ec0cf95f-b199-4b1c-b394-af1e01ac9c09",
            #     "is_headless": False
            # },

        ],
        "script_params": [
        {
            "name": "websites",
            "value": ["yahoo.com", "amazon.com"]
        },
        {
            "name": "randomOrder",
            "value": True
        },
        {
            "name": "fractionMode",
            "value": 1
        },
        {
            "name": "processCookieConsent",
            "value": True
        }
    ]
    }
    try:
        logging.info("Payload to send: %s", json.dumps(payload, indent=4))
        logging.info("Sending request to the script runner endpoint...")
        response = requests.post(url, headers=headers, data=json.dumps(payload), timeout=30)

        if response.status_code == 200:
            logging.info("Script executed successfully.")
            logging.info("Response: %s", response.json())
        else:
            logging.error("Failed to execute script. Status code: %d", response.status_code)
            logging.error("Response: %s", response.text)
    except requests.exceptions.RequestException as e:
        logging.error("An error occurred while making the request: %s", str(e))

if __name__ == "__main__":
    setup_logging()
    run_script()