A Python module for controlling Dolphin browser profiles using Selenium 🤖. It also has a Dolphin API for creating, editing, and deleting profiles.
Selenium and some features working only if Dolphin Anty is opened!!! (Local API wrapper must be launched!)
import selenium_dolphin as dolphin
from selenium.webdriver.chrome.options import Options
response = dolphin.run_profile(190438486) # where 190438486 - id of profile
port = response['automation']['port']
##### custom chrome options demonstration #####
options = Options()
options.add_argument("--start-maximized")
###############################################
driver = dolphin.get_driver(options=options, port=port)
driver.get('https://google.com/')
print(driver.title)
driver.quit()
dolphin.close_profile(190438486)from selenium_dolphin import DolphinAPI
api = DolphinAPI() # you can enter api_key='Your key' inside instanceYou can get an API key here, but if the token is present in the logs, the module can automatically retrieve it.
response = api.get_profiles()
print(response)response = api.get_profiles(page=1, limit=300) # default page - 1 limit - 50fingerprint = api.generate_fingerprint(platform='linux') # you can use platform windows/linux/macos, also you can use screen='1366x768' and browser_version='116' if you need
data = api.fingerprint_to_profile(name='my profile', fingerprint=fingerprint) # also you can add tags=['test', 'selenium_dolphin'] and other
response = api.create_profile(data)
print(response)After this line:
data = api.fingerprint_to_profile(name='my profile', fingerprint=fingerprint)Use for:
data.update({'geolocation':{
'mode': 'manual',
'latitude': 33.4,
'longitude': 55.2,
'accuracy': 318
}})data.update({'timezone':{
'mode':'manual',
'value':'Pacific/Johnston'
}})data.update({'locale':{
'mode':'manual',
'value':'af_ZA'
}})data.update({'proxy':{
'name': 'http://37.19.220.129:8443',
'host': '37.19.220.129',
'port': '8443',
'type': 'http'
}})
# also you can add 'login' and 'password' argsfrom selenium_dolphin import DolphinAPI
api = DolphinAPI()
fingerprint = api.generate_fingerprint(platform='windows')
data = api.fingerprint_to_profile(name='mega profile', fingerprint=fingerprint)
response = api.edit_profile(190438486, data)
print(response)from selenium_dolphin import DolphinAPI
api = DolphinAPI()
response = api.delete_profiles([190438486]) # you need specify list ids of profiles
print(response)response = api.check_proxy(host='37.19.220.129', port='8443', type='http')
print(response)
# also you can use other kwargs (login='username', password='password')Response:
{'success': True, 'country': 'US', 'region': 'Virginia', 'city': 'Ashburn', 'ip': '37.19.220.178', 'timezone': 'America/New_York'}response = api.generate_mac()
print(response) Response:
{'success': True, 'macAddress': '8E:DD:48:08:F1:31'}selenium-dolphin provides a straightforward way to control Dolphin browser profiles for automation testing using Selenium 🤖. With the Dolphin API, you can easily create, customize, and manage profiles right from Python. Give it a try for your next web scraping or test automation project! 🐬