Emunium - module for simulating human behavior in Selenium/Pyppeteer

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

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

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



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

Что умеет Emunium?

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

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

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

pip install emunium

Code

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 - это просто бомба! ;) ​