# Selenium

#### What is Selenium?

[**Selenium**](https://www.selenium.dev/) is an umbrella project for a range of tools and libraries that enable and support the automation of web browsers.

Selenium is many things but at its core, it is a toolset for web browser automation that uses the best techniques available to remotely control browser instances and emulate a user’s interaction with the browser.

<figure><img src="/files/IMTH449dMv0W7QNoJpIk" alt=""><figcaption></figcaption></figure>

Here's how to integrate Thordata with Selenium.

{% stepper %}
{% step %}

### Install Selenium

Install [**Selenium Wire**](https://github.com/wkeeling/selenium-wire) to extend Selenium's Python bindings because using the default Selenium module for implementing proxies that require authentication makes the whole process complicated. You can do it using the `pip` command: `pip install selenium-wire`

Another recommended package for this integration is `webdriver-manager`. It's a package that simplifies the management of binary drivers for different browsers. In this case, **there's no need to manually download a new version of a web driver after each update**.

You can install the `webdriver-manager` using the `pip` command as well: `pip install webdriver-manager`
{% endstep %}

{% step %}

### Specify your user credentials for proxies to work

`USERNAME = "td-customer-USERNAME"`

`PASSWORD = "PASSWORD"`

`ENDPOINT = "t.pr.thordata.net:9999"`
{% endstep %}

{% step %}

### Check proxy status

Check if the proxy is working by visiting `ipinfo.thordata.com`. If everything is working correctly - it will return an IP address of a proxy you're using.

```
try:
    driver.get("https://ipinfo.thordata.com/")
    return f'\nYour IP is: {driver.find_element(By.CSS_SELECTOR, "pre").text}'
finally:
    driver.quit()
```

{% endstep %}
{% endstepper %}

**Full Code Example:**

```
from selenium.webdriver.common.by import By
from seleniumwire import webdriver
# A package to have a chromedriver always up-to-date.
from webdriver_manager.chrome import ChromeDriverManager

USERNAME = "td-customer-USERNAME"
PASSWORD = "PASSWORD"
ENDPOINT = "t.pr.thordata.net:9999"

def chrome_proxy(user: str, password: str, endpoint: str) -> dict:
    wire_options = {
        "proxy": {
            "http": f"http://{user}:{password}@{endpoint}",
            "https": f"https://{user}:{password}@{endpoint}",
        }
    }

    return wire_options

def execute_driver():
    options = webdriver.ChromeOptions()
    options.add_argument('--headless')
    proxies = chrome_proxy(USERNAME, PASSWORD, ENDPOINT)
    driver = webdriver.Chrome(
    ChromeDriverManager(driver_version='<VERSION>').install(), options=options, seleniumwire_options=proxies
    )
    try:
        driver.get("https://ipinfo.thordata.com/")
        return f'\nYour IP is: {driver.find_element(By.CSS_SELECTOR, "pre").text}'
    finally:
        driver.quit()


if __name__ == '__main__':
    print(execute_driver())
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/proxies/integration-tutorial/residential-proxies-integration/selenium.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.