Como usar proxy com Python, Selenium e Requests

28 fev 2026•4 min read•

tecnologia

Como usar proxy com Python, Selenium e Requests

Python é a linguagem mais usada para web scraping e automação, e configurar um proxy é essencial para evitar bloqueios, manter anonimato e simular acessos de diferentes localizações. Neste guia, mostramos como configurar proxies residenciais brasileiros com as três bibliotecas mais populares: Requests, Selenium e Playwright.

Usando proxy com Requests

A biblioteca requests é a forma mais simples de fazer requisições HTTP em Python. Configurar um proxy é direto:

import requests
 
proxies = {
    "http": "http://usuario:senha@host:porta",
    "https": "http://usuario:senha@host:porta",
}
 
response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())
# Output: {"origin": "IP do proxy brasileiro"}

import requests
 
proxies = {
    "http": "http://usuario:senha@host:porta",
    "https": "http://usuario:senha@host:porta",
}
 
response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())
# Output: {"origin": "IP do proxy brasileiro"}

Para SOCKS5, instale o pacote extra:

pip install requests[socks]

pip install requests[socks]

proxies = {
    "http": "socks5://usuario:senha@host:porta",
    "https": "socks5://usuario:senha@host:porta",
}

proxies = {
    "http": "socks5://usuario:senha@host:porta",
    "https": "socks5://usuario:senha@host:porta",
}

Dica: para scraping em larga escala, crie uma sessão para reutilizar a conexão:

session = requests.Session()
session.proxies.update(proxies)
 
# Todas as requests desta sessão usam o proxy
response = session.get("https://exemplo.com")

session = requests.Session()
session.proxies.update(proxies)
 
# Todas as requests desta sessão usam o proxy
response = session.get("https://exemplo.com")

Usando proxy com Selenium

O Selenium controla um navegador real, ideal para sites que dependem de JavaScript. A configuração do proxy varia conforme o driver:

Chrome com proxy HTTP:

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
 
chrome_options = Options()
chrome_options.add_argument("--proxy-server=http://host:porta")
 
driver = webdriver.Chrome(options=chrome_options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
 
chrome_options = Options()
chrome_options.add_argument("--proxy-server=http://host:porta")
 
driver = webdriver.Chrome(options=chrome_options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

Chrome com autenticação (usando extensão):

O Chrome não suporta autenticação de proxy nativamente via linha de comando. A solução mais comum é criar uma extensão temporária:

import zipfile
import os
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
 
PROXY_HOST = "host"
PROXY_PORT = "porta"
PROXY_USER = "usuario"
PROXY_PASS = "senha"
 
manifest_json = """{
    "version": "1.0.0",
    "manifest_version": 2,
    "name": "Proxy Auth",
    "permissions": ["proxy", "tabs", "unlimitedStorage", "storage",
                     "<all_urls>", "webRequest", "webRequestBlocking"],
    "background": {"scripts": ["background.js"]},
    "minimum_chrome_version": "22.0.0"
}"""
 
background_js = """
var config = {
    mode: "fixed_servers",
    rules: {
        singleProxy: {
            scheme: "http",
            host: "%s",
            port: parseInt(%s)
        },
        bypassList: ["localhost"]
    }
};
chrome.proxy.settings.set({value: config, scope: "regular"}, function() {});
chrome.webRequest.onAuthRequired.addListener(
    function(details) {
        return {authCredentials: {username: "%s", password: "%s"}};
    },
    {urls: ["<all_urls>"]},
    ['blocking']
);
""" % (PROXY_HOST, PROXY_PORT, PROXY_USER, PROXY_PASS)
 
plugin_file = "proxy_auth.zip"
with zipfile.ZipFile(plugin_file, "w") as zp:
    zp.writestr("manifest.json", manifest_json)
    zp.writestr("background.js", background_js)
 
chrome_options = Options()
chrome_options.add_extension(plugin_file)
 
driver = webdriver.Chrome(options=chrome_options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
os.remove(plugin_file)

import zipfile
import os
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
 
PROXY_HOST = "host"
PROXY_PORT = "porta"
PROXY_USER = "usuario"
PROXY_PASS = "senha"
 
manifest_json = """{
    "version": "1.0.0",
    "manifest_version": 2,
    "name": "Proxy Auth",
    "permissions": ["proxy", "tabs", "unlimitedStorage", "storage",
                     "<all_urls>", "webRequest", "webRequestBlocking"],
    "background": {"scripts": ["background.js"]},
    "minimum_chrome_version": "22.0.0"
}"""
 
background_js = """
var config = {
    mode: "fixed_servers",
    rules: {
        singleProxy: {
            scheme: "http",
            host: "%s",
            port: parseInt(%s)
        },
        bypassList: ["localhost"]
    }
};
chrome.proxy.settings.set({value: config, scope: "regular"}, function() {});
chrome.webRequest.onAuthRequired.addListener(
    function(details) {
        return {authCredentials: {username: "%s", password: "%s"}};
    },
    {urls: ["<all_urls>"]},
    ['blocking']
);
""" % (PROXY_HOST, PROXY_PORT, PROXY_USER, PROXY_PASS)
 
plugin_file = "proxy_auth.zip"
with zipfile.ZipFile(plugin_file, "w") as zp:
    zp.writestr("manifest.json", manifest_json)
    zp.writestr("background.js", background_js)
 
chrome_options = Options()
chrome_options.add_extension(plugin_file)
 
driver = webdriver.Chrome(options=chrome_options)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()
os.remove(plugin_file)

Usando proxy com Playwright

O Playwright é uma alternativa moderna ao Selenium, com suporte nativo a proxies com autenticação:

from playwright.sync_api import sync_playwright
 
with sync_playwright() as p:
    browser = p.chromium.launch(
        proxy={
            "server": "http://host:porta",
            "username": "usuario",
            "password": "senha",
        }
    )
    page = browser.new_page()
    page.goto("https://httpbin.org/ip")
    print(page.content())
    browser.close()

from playwright.sync_api import sync_playwright
 
with sync_playwright() as p:
    browser = p.chromium.launch(
        proxy={
            "server": "http://host:porta",
            "username": "usuario",
            "password": "senha",
        }
    )
    page = browser.new_page()
    page.goto("https://httpbin.org/ip")
    print(page.content())
    browser.close()

Playwright com SOCKS5:

browser = p.chromium.launch(
    proxy={
        "server": "socks5://host:porta",
        "username": "usuario",
        "password": "senha",
    }
)

browser = p.chromium.launch(
    proxy={
        "server": "socks5://host:porta",
        "username": "usuario",
        "password": "senha",
    }
)

O Playwright é a opção mais simples para proxies com autenticação — não precisa de extensões ou workarounds.

Verificando se o proxy está funcionando

Independente da biblioteca, sempre verifique o IP antes de iniciar o scraping:

# Com Requests
response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())
 
# O resultado deve mostrar o IP do proxy brasileiro, não o seu IP real

# Com Requests
response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())
 
# O resultado deve mostrar o IP do proxy brasileiro, não o seu IP real

Você também pode verificar a geolocalização:

response = requests.get("https://ipapi.co/json/", proxies=proxies)
data = response.json()
print(f"IP: {data['ip']}")
print(f"Cidade: {data['city']}")
print(f"Estado: {data['region']}")
print(f"País: {data['country_name']}")

response = requests.get("https://ipapi.co/json/", proxies=proxies)
data = response.json()
print(f"IP: {data['ip']}")
print(f"Cidade: {data['city']}")
print(f"Estado: {data['region']}")
print(f"País: {data['country_name']}")

Boas práticas para scraping com proxy

Respeite o robots.txt: verifique se o site permite scraping antes de começar
Use delays entre requests: intervalos de 1-3 segundos reduzem risco de bloqueio
Rotacione User-Agents: combine o proxy com headers realistas
1 proxy por tarefa: não misture atividades diferentes no mesmo IP
Monitore erros: se começar a receber 403 ou captchas, reduza a velocidade
Use proxies residenciais: para sites com proteção anti-bot (Cloudflare, DataDome), proxies datacenter serão bloqueados

Qual biblioteca escolher?

Biblioteca	Melhor para	Proxy auth nativo
Requests	APIs, sites simples, scraping sem JS	Sim
Selenium	Sites com JS, testes de UI	Não (precisa extensão)
Playwright	Sites com JS, scraping moderno	Sim

Para scraping de sites que dependem de JavaScript, Playwright é a melhor opção pela simplicidade na configuração de proxy. Para requisições simples a APIs ou páginas estáticas, Requests é suficiente.

Conclusão

Configurar proxies em Python é direto com qualquer uma das três bibliotecas. A chave para evitar bloqueios é usar proxies residenciais brasileiros de qualidade, respeitar limites de velocidade e manter headers consistentes.

Com os proxies da Proxy Brasil, você recebe host, porta, usuário e senha prontos para usar em qualquer script Python. Basta substituir os valores nos exemplos acima e começar.