selenium-proxy-auth 0.1.0__py3-none-any.whl

selenium_proxy_auth/__init__.py

@@ -0,0 +1,4 @@
+from .extension import add_proxy, make_proxy_extension
+
+__all__ = ["add_proxy", "make_proxy_extension"]
+__version__ = "0.1.0"

selenium_proxy_auth/extension.py

@@ -0,0 +1,80 @@
+"""Generate a Chrome extension that configures an authenticated proxy for Selenium.
+
+Selenium can't pass proxy credentials to Chrome directly — ``--proxy-server`` has
+no place for a username/password, so an authenticated proxy pops a native auth
+dialog that Selenium can't dismiss. The standard fix is a tiny extension that sets
+``chrome.proxy`` and answers ``onAuthRequired`` with your credentials. This builds
+that extension on the fly, no selenium-wire dependency.
+"""
+import os
+import tempfile
+from urllib.parse import unquote, urlparse
+
+__all__ = ["make_proxy_extension", "add_proxy"]
+
+_MANIFEST = """{
+  "name": "Selenium Proxy Auth",
+  "version": "1.0.0",
+  "manifest_version": 3,
+  "permissions": ["proxy", "webRequest", "webRequestAuthProvider"],
+  "host_permissions": ["<all_urls>"],
+  "background": { "service_worker": "background.js" },
+  "minimum_chrome_version": "108"
+}"""
+
+_BACKGROUND = """var config = {
+  mode: "fixed_servers",
+  rules: {
+    singleProxy: { scheme: "%(scheme)s", host: "%(host)s", port: %(port)d },
+    bypassList: ["localhost", "127.0.0.1"]
+  }
+};
+chrome.proxy.settings.set({ value: config, scope: "regular" }, function () {});
+chrome.webRequest.onAuthRequired.addListener(
+  function () {
+    return { authCredentials: { username: "%(user)s", password: "%(password)s" } };
+  },
+  { urls: ["<all_urls>"] },
+  ["blocking"]
+);
+"""
+
+
+def make_proxy_extension(proxy_url, directory=None):
+    """Write an unpacked Chrome extension for ``proxy_url`` and return its path.
+
+    ``proxy_url`` is an ordinary ``scheme://user:pass@host:port`` URL.
+    Caller is responsible for deleting the directory when done.
+    """
+    p = urlparse(proxy_url)
+    if not p.hostname or not p.port:
+        raise ValueError(f"Proxy URL needs host and port: {proxy_url!r}")
+    fields = {
+        "scheme": (p.scheme or "http").replace("https", "http"),
+        "host": p.hostname,
+        "port": int(p.port),
+        "user": unquote(p.username or ""),
+        "password": unquote(p.password or ""),
+    }
+    directory = directory or tempfile.mkdtemp(prefix="selenium_proxy_auth_")
+    with open(os.path.join(directory, "manifest.json"), "w") as f:
+        f.write(_MANIFEST)
+    with open(os.path.join(directory, "background.js"), "w") as f:
+        f.write(_BACKGROUND % fields)
+    return directory
+
+
+def add_proxy(chrome_options, proxy_url):
+    """Build the extension for ``proxy_url`` and load it into ``chrome_options``.
+
+    Returns the extension directory so you can ``shutil.rmtree`` it afterwards.
+
+        opts = webdriver.ChromeOptions()
+        ext = add_proxy(opts, "http://USER:PASS@us.jibaoproxy.com:913")
+        driver = webdriver.Chrome(options=opts)
+        ...
+        shutil.rmtree(ext, ignore_errors=True)
+    """
+    directory = make_proxy_extension(proxy_url)
+    chrome_options.add_argument(f"--load-extension={directory}")
+    return directory

selenium_proxy_auth-0.1.0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: selenium-proxy-auth
+Version: 0.1.0
+Summary: Authenticated proxies for Selenium + Chrome without selenium-wire. Generates a proxy-auth extension on the fly.
+Author-email: JiBao Proxy <support@jibaoproxy.com>
+License: MIT
+Project-URL: Homepage, https://jibaoproxy.com
+Project-URL: Source, https://github.com/jibaoproxyofficial-pixel/selenium-proxy-auth
+Keywords: selenium,proxy,proxy-authentication,chrome,web-scraping,browser-automation,residential-proxy
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# selenium-proxy-auth
+
+[![PyPI version](https://img.shields.io/pypi/v/selenium-proxy-auth.svg)](https://pypi.org/project/selenium-proxy-auth/)
+[![Python versions](https://img.shields.io/pypi/pyversions/selenium-proxy-auth.svg)](https://pypi.org/project/selenium-proxy-auth/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Use an **authenticated (user:pass) proxy with Selenium + Chrome** — without selenium-wire. It generates a tiny proxy-auth extension on the fly and loads it, so Chrome never shows the native auth popup that Selenium can't click.
+
+```bash
+pip install selenium-proxy-auth
+```
+
+## The problem
+
+Chrome's `--proxy-server` flag has nowhere to put a username and password. So with an authenticated proxy, Chrome throws a **native auth dialog** — which Selenium can't interact with — and every request hangs or 407s:
+
+```python
+# ❌ no place for credentials; Chrome shows a popup Selenium can't dismiss
+opts.add_argument("--proxy-server=http://user:pass@gw.example.com:913")
+```
+
+The reliable fix is a small extension that sets `chrome.proxy` and answers `onAuthRequired` with your credentials. This package builds and loads it for you.
+
+## Usage
+
+```python
+import shutil
+from selenium import webdriver
+from selenium_proxy_auth import add_proxy
+
+opts = webdriver.ChromeOptions()
+opts.add_argument("--headless=new")
+
+ext = add_proxy(opts, "http://USERNAME:PASSWORD@us.jibaoproxy.com:913")
+
+driver = webdriver.Chrome(options=opts)
+try:
+    driver.get("https://httpbin.org/ip")
+    print(driver.find_element("tag name", "body").text)
+finally:
+    driver.quit()
+    shutil.rmtree(ext, ignore_errors=True)   # clean up the generated extension
+```
+
+`add_proxy` returns the path to the generated extension directory so you can delete it afterwards. The extension contains your credentials in plaintext — it's written to a temp dir; don't commit it.
+
+## How it works
+
+- Manifest V3 extension with the `proxy`, `webRequest`, and `webRequestAuthProvider` permissions.
+- A background service worker sets `chrome.proxy.settings` to your `host:port` and returns `authCredentials` from `onAuthRequired`.
+- Loaded via `--load-extension`, so it works in headless `--headless=new`. (Old `--headless` does not load extensions; use `--headless=new`.)
+
+Need just the files (e.g. for undetected-chromedriver)? Use `make_proxy_extension(url)` to get the directory and load it yourself.
+
+## Rotating IPs
+
+A rotating residential gateway hands out a new exit IP per connection from one URL — point `add_proxy` at the gateway and each fresh `webdriver.Chrome` gets a different IP. If you're still getting blocked after authenticating, the exit IP is the issue: datacenter ranges get scored as bots by ASN and [TLS fingerprint](https://jibaoproxy.com/blog/ja3-tls-fingerprint-detection-explained.html) before the page loads. We build [JiBao Proxy](https://jibaoproxy.com) for clean residential exits — 72M+ IPs, 200+ countries, sticky sessions. Works with any provider, though.
+
+## Related
+
+- [Selenium & Playwright proxy authentication, explained](https://jibaoproxy.com/blog/selenium-playwright-proxy-authentication.html)
+- [AdsPower / Multilogin proxy setup](https://jibaoproxy.com/blog/adspower-multilogin-proxy-setup.html)
+- [Bypassing DataDome & PerimeterX in 2026](https://jibaoproxy.com/blog/datadome-perimeterx-bypass-2026.html)
+
+## License
+
+MIT

selenium_proxy_auth-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+selenium_proxy_auth/__init__.py,sha256=f7fXtKh63GPovP6raB-fjW691djKo3GJgMPkMrNhFgA,126
+selenium_proxy_auth/extension.py,sha256=5gvvYLHmVednAlWv80Ys3aY92DyAZujppztIZxc-k78,2886
+selenium_proxy_auth-0.1.0.dist-info/licenses/LICENSE,sha256=EqlXESyqjpkAYUf6imqo1JrW9eYaOurSRNBh4LO7bQE,1068
+selenium_proxy_auth-0.1.0.dist-info/METADATA,sha256=u0zaKnwQwB8Fn66Qqp2-eVG8PmMNktK_hIhRWIJ1gXk,4191
+selenium_proxy_auth-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+selenium_proxy_auth-0.1.0.dist-info/top_level.txt,sha256=gWP2fy3dSabuxy-vB17N54UhLRCY2omXmOPNWFzKzlg,20
+selenium_proxy_auth-0.1.0.dist-info/RECORD,,

selenium_proxy_auth-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

selenium_proxy_auth-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JiBao Proxy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

selenium_proxy_auth-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+selenium_proxy_auth