Pyanty - Web automation, module for managing dolphin via Selenium, and Dolphin API

PYANTY - Управляем Dolphin Anty!

Python библиотека для полного контроля над профилями браузера
​

Что это такое?

pyanty - это мощная Python библиотека для управления профилями браузера Dolphin Anty.

Она позволяет:

• Создавать новые профили с уникальными отпечатками
• Редактировать существующие профили
• Управлять ******, геолокацией и timezone
• Автоматизировать браузер через Selenium, Pyppeteer и Playwright
• Работать с расширениями Chrome
• Генерировать реалистичные fingerprints через Bablosoft

ВАЖНОЕ ПРЕДУПРЕЖДЕНИЕ
Selenium и локальные функции работают только при запущенном Dolphin Anty!
Убедитесь, что Local API wrapper активен.

Быстрый старт

Selenium

import random
import pyanty as dolphin
from pyanty import DolphinAPI, STABLE_CHROME_VERSION

# Инициализация API
api = DolphinAPI(api_key='Your Api Key') # или просто DolphinAPI() для авто-получения токена

# Генерация отпечатка браузера
fingerprint = []
while not fingerprint:
fingerprint = api.generate_fingerprint(
platform='windows',
browser_version=f'{random.randint(136, STABLE_CHROME_VERSION)}'
)

# Создание профиля
data = api.fingerprint_to_profile(name='my superprofile', fingerprint=fingerprint)
profile_id = api.create_profile(data)['browserProfileId']

# Запуск профиля и автоматизация
response = dolphin.run_profile(profile_id)
port = response['automation']['port']

driver = dolphin.get_driver(port=port)
driver.get('https://google.com/')
print(driver.title)
driver.quit()

# Закрытие профиля
dolphin.close_profile(profile_id)

Python

import random

import pyanty as dolphin

from pyanty import DolphinAPI, STABLE_CHROME_VERSION



# Инициализация API

api = DolphinAPI(api_key='Your Api Key')  # или просто DolphinAPI() для авто-получения токена



# Генерация отпечатка браузера

fingerprint = []

while not fingerprint:

    fingerprint = api.generate_fingerprint(

        platform='windows',

        browser_version=f'{random.randint(136, STABLE_CHROME_VERSION)}'

    )



# Создание профиля

data = api.fingerprint_to_profile(name='my superprofile', fingerprint=fingerprint)

profile_id = api.create_profile(data)['browserProfileId']



# Запуск профиля и автоматизация

response = dolphin.run_profile(profile_id)

port = response['automation']['port']



driver = dolphin.get_driver(port=port)

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

print(driver.title)

driver.quit()



# Закрытие профиля

dolphin.close_profile(profile_id)

Pyppeteer

import asyncio
import pyanty as dolphin
from pyanty import DolphinAPI

api = DolphinAPI(api_key='Your Api Key')

# Создание профиля (аналогично примеру выше)
# ...

response = dolphin.run_profile(profile_id)
port = response['automation']['port']
ws_endpoint = response['automation']['wsEndpoint']

async def main():
browser = await dolphin.get_browser(ws_endpoint, port)
pages = await browser.pages()
page = pages[0]
await page.goto('http://google.com/')
await asyncio.sleep(5)
await browser.disconnect()

asyncio.run(main())
dolphin.close_profile(profile_id)

Python

import asyncio

import pyanty as dolphin

from pyanty import DolphinAPI



api = DolphinAPI(api_key='Your Api Key')



# Создание профиля (аналогично примеру выше)

# ...



response = dolphin.run_profile(profile_id)

port = response['automation']['port']

ws_endpoint = response['automation']['wsEndpoint']



async def main():

    browser = await dolphin.get_browser(ws_endpoint, port)

    pages = await browser.pages()

    page = pages[0]

    await page.goto('http://google.com/')

    await asyncio.sleep(5)

    await browser.disconnect()



asyncio.run(main())

dolphin.close_profile(profile_id)

Playwright

# Используем core='playwright' или core='patchright' для undetectable версии
browser = await dolphin.get_browser(ws_endpoint, port, core='playwright')

Python

# Используем core='playwright' или core='patchright' для undetectable версии

browser = await dolphin.get_browser(ws_endpoint, port, core='playwright')

Работа с профилями

Получение списка профилей:

from pyanty import DolphinAPI

api = DolphinAPI() # автоматически подхватит токен из *****

# Получить все профили
response = api.get_profiles()

# С пагинацией
response = api.get_profiles(page=1, limit=300) # по умолчанию: page=1, limit=50

Python

from pyanty import DolphinAPI



api = DolphinAPI()  # автоматически подхватит токен из *****



# Получить все профили

response = api.get_profiles()



# С пагинацией

response = api.get_profiles(page=1, limit=300)  # по умолчанию: page=1, limit=50

Создание нового профиля:

# Генерация отпечатка
fingerprint = api.generate_fingerprint(
platform='windows', # windows/linux/macos
screen='1920x1080', # опционально
browser_version='131' # опционально
)

# Конвертация в профиль
data = api.fingerprint_to_profile(
name='Мой крутой профиль',
fingerprint=fingerprint,
tags=['test', 'pyanty'] # опционально
)

# Создание
response = api.create_profile(data)
profile_id = response['browserProfileId']

Python

# Генерация отпечатка

fingerprint = api.generate_fingerprint(

    platform='windows',  # windows/linux/macos

    screen='1920x1080',  # опционально

    browser_version='131'  # опционально

)



# Конвертация в профиль

data = api.fingerprint_to_profile(

    name='Мой крутой профиль',

    fingerprint=fingerprint,

    tags=['test', 'pyanty']  # опционально

)



# Создание

response = api.create_profile(data)

profile_id = response['browserProfileId']

Редактирование профиля:

fingerprint = api.generate_fingerprint(platform='linux')
data = api.fingerprint_to_profile(name='обновленный профиль', fingerprint=fingerprint)

response = api.edit_profile(profile_id, data)

Python

fingerprint = api.generate_fingerprint(platform='linux')

data = api.fingerprint_to_profile(name='обновленный профиль', fingerprint=fingerprint)



response = api.edit_profile(profile_id, data)

Удаление профилей:

# Удаление одного или нескольких профилей
response = api.delete_profiles([profile_id_1, profile_id_2])

Python

# Удаление одного или нескольких профилей

response = api.delete_profiles([profile_id_1, profile_id_2])

Дополнительные настройки профиля

После создания базового профиля можно добавить дополнительные параметры:

Геолокация

data.update({
'geolocation': {
'mode': 'manual',
'latitude': 55.7558,
'longitude': 37.6173,
'accuracy': 100
}
})

Python

data.update({

    'geolocation': {

        'mode': 'manual',

        'latitude': 55.7558,

        'longitude': 37.6173,

        'accuracy': 100

    }

})

Часовой пояс

data.update({
'timezone': {
'mode': 'manual',
'value': 'Europe/Moscow'
}
})

Python

data.update({

    'timezone': {

        'mode': 'manual',

        'value': 'Europe/Moscow'

    }

})

Язык и локаль

data.update({
'locale': {
'mode': 'manual',
'value': 'ru_RU'
}
})

Python

data.update({

    'locale': {

        'mode': 'manual',

        'value': 'ru_RU'

    }

})

******

[CODE=python]
data.update({
'proxy': {
'name': 'http://37.19.220.129:8443',
'host': '37.19.220.129',
'port': '8443',
'type': 'http', # http/https/socks5
'login': 'username', # опционально
'password': 'password' # опционально
}
})
[/CODE]

Продвинутые возможности

Bablosoft Fingerprints (NEW!)

Начиная с версии 1.1.0, библиотека поддерживает генерацию реалистичных отпечатков через сервис Bablosoft:

[CODE=python]
# Генерация с тегами
fingerprint = []
while not 'ua' in fingerprint:
fingerprint = api.generate_fb_fingerprint(tags=['Apple Mac'])

# Доступные теги:
# Платформы: Desktop, Mobile
# ОС: Microsoft Windows, Apple Mac, Android, Linux, iPad, iPhone
# Браузеры: Edge, Chrome, Safari, Firefox, IE

# Комбинации тегов
fingerprint = api.generate_fb_fingerprint(tags=['Desktop', 'Microsoft Windows', 'Chrome'])
fingerprint = api.generate_fb_fingerprint(tags=['Mobile', 'Android', 'Chrome'])
[/CODE] Проверить fingerprint:https://fp.bablosoft.com/#testing

Работа с расширениями

[CODE=python]
# Получить список расширений
extensions = api.get_extensions(page=1, limit=50)

# Загрузить из Chrome Web Store
response = api.load_extension_from_url(
'https://chromewebstore.google.com/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm'
)

# Загрузить из ZIP архива
response = api.load_extension_from_zip(
extension_name='My Extension',
path='path/to/extension.zip'
)

# Удалить расширения
api.delete_extensions([extension_id_1, extension_id_2])
[/CODE] Дополнительные утилиты

Проверка ******

[CODE=python]
response = api.check_proxy(
host='37.19.220.129',
port='8443',
type='http',
login='username', # опционально
password='password' # опционально
)

# Результат:
# {"success": true, "country": "RU", "region": "Moscow", "city": "Moscow",
# "ip": "37.19.220.178", "timezone": "Europe/Moscow"}
[/CODE]

Генератор MAC адресов

[CODE=python]
response = api.generate_mac()

# Результат:
# {"success": true, "macAddress": "8E:DD:48:08:F1:31"}
[/CODE]

Полезные ссылки

• GitHub репозиторий
• Получить API ключ
• PyPI страница

​