Emunium - модуль для имитации поведения человека в Selenium/Pyppeteer/Playwright и т.д.

Здарова, кодеры и автоматизаторы!

Снова на связи ваш покорный слуга, и да, сегодня мы говорим про автоматизацию! Ну а как иначе? Кто будет жить эту жизнь, пока мы тонем в рутине? Так вот, чтобы вынырнуть из этого болота, ловите свежачок...

Emunium - мощный Python модуль, который научит ваших ботов вести себя как люди в Selenium, Pyppeteer и Playwright!



Emunium — это ваш секретный ингредиент для автоматизации всего и вся, будь то десктопные приложения или браузеры. С ним ваши скрипты будут двигать мышкой, кликать, печатать и скроллить так, будто за компьютером сидит живой человек. А это значит - меньше подозрений и больше успеха в ваших автоматизированных приключениях!

Что умеет Emunium?

• ► Реалистичные движения мыши: Забудьте про телепортацию курсора! Emunium плавно ведет мышку к цели, добавляя случайные отклонения для пущей убедительности.
• ► Разнообразные клики: Левый, правый, средний, двойной - любой каприз! Плюс, Emunium умеет варьировать точность клика, чтобы совсем уж не палиться.
• ► "Человеческий" ввод текста: Никакой мгновенной печати! Символы вводятся с регулируемой скоростью и случайными задержками, как будто вы сами стучите по клаве.
• ► Плавный скроллинг: Прокрутка страниц теперь выглядит естественно, без резких рывков и пропусков.
• ► Поиск элементов по изображениям (Standalone режим): Нужно найти кнопку или поле ввода, но селекторы не работают? Просто покажите Emunium картинку, и он найдет все похожие элементы на экране!
• ► OCR - Оптическое Распознавание Символов (Standalone режим): Хотите найти текст на экране, даже если это картинка? Emunium с OCR (EasyOCR под капотом) легко справится и с этим!

Начинаем колдовать! Установка:

Всё как обычно, проще простого:

pip install emunium

Код

pip install emunium

Примеры использования:

Для браузерных гуру - Selenium:

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from emunium import EmuniumSelenium

driver = webdriver.Chrome()
wait = WebDriverWait(driver, 10)
emunium = EmuniumSelenium(driver)

driver.get('https://duckduckgo.com/')

element = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '[data-state="suggesting"]')))
emunium.type_at(element, 'Автоматизация поиска') # Имитируем ввод текста

submit = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '[aria-label="Search"]')))
emunium.click_at(submit) # Кликаем на кнопку поиска

driver.quit()

Python

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from emunium import EmuniumSelenium

driver = webdriver.Chrome()
wait = WebDriverWait(driver, 10)
emunium = EmuniumSelenium(driver)

driver.get('https://duckduckgo.com/')

element = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '[data-state="suggesting"]')))
emunium.type_at(element, 'Автоматизация поиска') #  Имитируем ввод текста

submit = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, '[aria-label="Search"]')))
emunium.click_at(submit) # Кликаем на кнопку поиска

driver.quit()

Для любителей асинхронщины - Pyppeteer:

import asyncio
from pyppeteer import launch
from emunium import EmuniumPpeteer

async def main():
browser = await launch(headless=False) # Запуск браузера (не в headless режиме для наглядности)
page = await browser.newPage()
emunium = EmuniumPpeteer(page)

await page.goto('https://duckduckgo.com/')

element = await page.waitForSelector('[data-state="suggesting"]')
await emunium.type_at(element, 'Автоматизация поиска') # Имитируем ввод текста

submit = await page.waitForSelector('[aria-label="Search"]')
await emunium.click_at(submit) # Кликаем на кнопку поиска

await browser.close()

asyncio.run(main())

Python

import asyncio
from pyppeteer import launch
from emunium import EmuniumPpeteer

async def main():
    browser = await launch(headless=False) #  Запуск браузера (не в headless режиме для наглядности)
    page = await browser.newPage()
    emunium = EmuniumPpeteer(page)

    await page.goto('https://duckduckgo.com/')

    element = await page.waitForSelector('[data-state="suggesting"]')
    await emunium.type_at(element, 'Автоматизация поиска') #  Имитируем ввод текста

    submit = await page.waitForSelector('[aria-label="Search"]')
    await emunium.click_at(submit) # Кликаем на кнопку поиска

    await browser.close()

asyncio.run(main())

Для ценителей скорости и мощи - Playwright:

import asyncio
from playwright.async_api import async_playwright
from emunium import EmuniumPlaywright

async def main():
async with async_playwright() as p:
browser = await p.chromium.launch(headless=False) # Запуск браузера (не в headless режиме)
page = await browser.new_page()
emunium = EmuniumPlaywright(page)

await page.goto('https://duckduckgo.com/')

element = await page.wait_for_selector('[data-state="suggesting"]')
await emunium.type_at(element, 'Автоматизация поиска') # Имитируем ввод текста

submit = await page.wait_for_selector('[aria-label="Search"]')
await emunium.click_at(submit) # Кликаем на кнопку поиска

await browser.close()

asyncio.run(main())

Python

import asyncio
from playwright.async_api import async_playwright
from emunium import EmuniumPlaywright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=False) #  Запуск браузера (не в headless режиме)
        page = await browser.new_page()
        emunium = EmuniumPlaywright(page)

        await page.goto('https://duckduckgo.com/')

        element = await page.wait_for_selector('[data-state="suggesting"]')
        await emunium.type_at(element, 'Автоматизация поиска') #  Имитируем ввод текста

        submit = await page.wait_for_selector('[aria-label="Search"]')
        await emunium.click_at(submit) # Кликаем на кнопку поиска

        await browser.close()

asyncio.run(main())

Для тех, кто любит по-старинке - Standalone режим (без браузера):

from emunium import Emunium

emunium = Emunium() # Создаем экземпляр Emunium для standalone режима

elements = emunium.find_elements('field.png', min_confidence=0.8) # Ищем поле ввода по картинке 'field.png'

emunium.type_at(elements[0], 'Автоматизация поиска') # Вводим текст в найденное поле

elements = emunium.find_elements('search_icon.png', min_confidence=0.8) # Ищем иконку поиска по картинке 'search_icon.png'
emunium.click_at(elements[0]) # Кликаем по найденной иконке

Python

from emunium import Emunium

emunium = Emunium() # Создаем экземпляр Emunium для standalone режима

elements = emunium.find_elements('field.png', min_confidence=0.8) # Ищем поле ввода по картинке 'field.png'

emunium.type_at(elements[0], 'Автоматизация поиска') # Вводим текст в найденное поле

elements = emunium.find_elements('search_icon.png', min_confidence=0.8) # Ищем иконку поиска по картинке 'search_icon.png'
emunium.click_at(elements[0]) # Кликаем по найденной иконке

Что тут происходит:

Во всех примерах мы делаем одно и то же, но разными инструментами:

• Заходим на поисковик DuckDuckGo.
• Находим поле ввода поискового запроса.
• Имитируем ввод текста запроса "Автоматизация поиска" буква за буквой, как это сделал бы человек.
• Находим кнопку "Поиск".
• Кликаем по кнопке, имитируя человеческое нажатие.

Вся магия заключается в методах Emunium. Они не просто выполняют команды, а двигают курсор мыши и печатают текст! Именно поэтому обнаружить автоматизацию, использующую Emunium, становится на порядок сложнее, чем при использовании стандартных методов Selenium, Pyppeteer или Playwright. Естественно, если вы подключены по CDP, и есть проверка на JS eval то может и обнаружить. Но Standalone режим ещё лучше в этом плане, хоть и сложнее в реализации.


В сухом остатке:

Emunium — это ваш билет в мир незаметной и эффективной автоматизации в Selenium, Pyppeteer и Playwright. С ним ваши боты станут неотличимы от людей для самых продвинутых антибот систем!


Хотите узнать больше? Загляните на GitHub репозиторий Emunium!

И да, не забудьте про мой старый добрый проект selenium-dolphin. В связке с Emunium - это просто бомба! ;) ​