Прокси для Browser Use: агент через HTTP-прокси

Актуальный API прокси в Browser Use

В документации Browser Use прокси — параметр браузера: proxy принимает объект ProxySettings с полями server, username, password и bypass. Browser — псевдоним BrowserSession, так что Browser(proxy=...) и есть вся настройка.

BrowserConfig, который импортируют в старых инструкциях, остался в прежних версиях и в актуальном API его нет: импорт даст ImportError. Используйте пример ниже.

• Источники:
• Browser Use docs: all parameters
• Browser Use source: browser/profile.py

Browser Use с ProxySettings: сначала проверяем выход

import asyncio
import os
from browser_use import Agent, Browser, ChatOpenAI
from browser_use.browser.profile import ProxySettings

browser = Browser(
    proxy=ProxySettings(
        server=f"http://{os.environ['PROXY_HOST']}:{os.environ['PROXY_PORT']}",  # HTTP endpoint
        username=os.environ["PROXY_USER"],
        password=os.environ["PROXY_PASS"],
        bypass="localhost,127.0.0.1",  # optional
    )
)


async def main():
    agent = Agent(
        task=(
            "Open https://ipinfo.io/json and report the IP address and country it shows. "
            "Then continue with the real task."
        ),
        llm=ChatOpenAI(model=os.environ["LLM_MODEL"]),
        browser=browser,
    )
    history = await agent.run()
    print(history.final_result())


asyncio.run(main())

Только пример: подставьте свои переменные окружения. В задаче агент сначала называет IP и страну выхода, и только потом делает остальное.

• Источники:
• Browser Use docs: all parameters

Зачем проверять выход первым

Первый шаг превращает «прокси настроен» в «браузер агента действительно показывает выбранную страну». Делайте это в начале каждого запуска и сверяйте страну с той, что вы выбрали при создании прокси.

bypass — список хостов через запятую, которые идут не через прокси, например localhost,127.0.0.1. Если не нужен, не указывайте.

Свой прокси для каждого агента

Дайте каждому агенту свой Browser со своим ProxySettings и запускайте их вместе через asyncio.gather. Прокси привязан к браузеру, на котором задан, поэтому два агента случайно не окажутся на одном выходе. Параллельный пример в документации Browser Use помечен как экспериментальный, поэтому держите один агент на один объект Browser.

• Источники:
• Browser Use docs: all parameters

Два агента, два прокси, параллельный запуск

import asyncio
import os
from browser_use import Agent, Browser, ChatOpenAI
from browser_use.browser.profile import ProxySettings


def make_browser(host_env, port_env, user_env, pass_env):
    return Browser(
        proxy=ProxySettings(
            server=f"http://{os.environ[host_env]}:{os.environ[port_env]}",
            username=os.environ[user_env],
            password=os.environ[pass_env],
        )
    )


async def run_one(task, browser):
    agent = Agent(task=task, llm=ChatOpenAI(model=os.environ["LLM_MODEL"]), browser=browser)
    return await agent.run()


async def main():
    de = make_browser("DE_HOST", "DE_PORT", "DE_USER", "DE_PASS")
    jp = make_browser("JP_HOST", "JP_PORT", "JP_USER", "JP_PASS")
    results = await asyncio.gather(
        run_one("Open https://ipinfo.io/json and report the IP and country", de),
        run_one("Open https://ipinfo.io/json and report the IP and country", jp),
    )
    for history in results:
        print(history.final_result())


asyncio.run(main())

Только пример: подставьте свои значения.

То же самое в чистом Playwright

Browser Use управляет Chromium через Playwright, поэтому полезно знать его собственные параметры прокси. Прокси задают для всего браузера в launch или для одного контекста в new_context (в Node.js — newContext); параметры: server, bypass, username, password.

В справочнике Playwright сказано, что username и password нужны для HTTP-прокси. Значит, SOCKS5 с логином и паролем в Chromium недоступен: используйте HTTP-порт. В Proxy302 это proxy.proxy302.com, порт 2222; SOCKS5 — порт 3333.

• Источники:
• Playwright docs: Network, HTTP proxy
• Playwright docs: proxy option reference

Playwright для Python: прокси на браузер и на контекст

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    # Proxy for the whole browser
    browser = p.chromium.launch(
        proxy={
            "server": "http://HOST:PORT",
            "username": "USERNAME",
            "password": "PASSWORD",
            "bypass": "localhost,127.0.0.1",
        }
    )
    page = browser.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.inner_text("body"))
    browser.close()

    # Or one proxy per context
    browser = p.chromium.launch()
    context = browser.new_context(
        proxy={"server": "http://HOST:PORT", "username": "USERNAME", "password": "PASSWORD"}
    )
    page = context.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.inner_text("body"))
    browser.close()

Только пример: подставьте свои значения.

• Источники:
• Playwright docs: Network, HTTP proxy

Playwright для Node.js: прокси на браузер и на контекст

import { chromium } from 'playwright';

// Proxy for the whole browser
const browser = await chromium.launch({
  proxy: {
    server: 'http://HOST:PORT',
    username: 'USERNAME',
    password: 'PASSWORD',
    bypass: 'localhost,127.0.0.1',
  },
});
const page = await browser.newPage();
await page.goto('https://ipinfo.io/json');
console.log(await page.innerText('body'));
await browser.close();

// Or one proxy per context
const browser2 = await chromium.launch();
const context = await browser2.newContext({
  proxy: { server: 'http://HOST:PORT', username: 'USERNAME', password: 'PASSWORD' },
});
const page2 = await context.newPage();
await page2.goto('https://ipinfo.io/json');
console.log(await page2.innerText('body'));
await browser2.close();

Только пример: подставьте свои значения.

• Источники:
• Playwright docs: Network, HTTP proxy

Playwright MCP

Если вы управляете браузером не кодом на Python, а через сервер Playwright MCP, нужны аргументы --proxy-server и --proxy-bypass. В README логин и пароль пишут прямо в адресе прокси: http://user:password@host:port. Если в пароле есть такие символы, как @, : или /, закодируйте их через процентное кодирование.

В README есть и форма для SOCKS5, но, как и в Playwright выше, при необходимости логина и пароля берите HTTP-порт.

• Источники:
• Playwright MCP README

Playwright MCP с прокси: запись в mcpServers

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--proxy-server",
        "http://USER:PASS@HOST:PORT",
        "--proxy-bypass",
        "localhost,127.0.0.1"
      ]
    }
  }
}

Только пример: подставьте свои значения.

• Источники:
• Playwright MCP README

Чтение страницы через прокси из MCP-клиента

Если агенту нужно лишь прочитать публичную страницу через прокси Proxy302 без запуска браузера, смотрите руководство proxy-mcp-server. proxy302-mcp — официальный MCP-сервер Proxy302 с открытым кодом на GitHub, его поддерживает команда Proxy302. Proxy302 также держит его по адресу https://proxy302.com/v1/mcp: клиенты, которые умеют передавать заголовок Authorization, например Claude Code, Cursor и VS Code, подключаются по API-ключу без установки.

• proxy-mcp-server

• Источники:
• README proxy302-mcp (официальный MCP-сервер Proxy302)

Часовой пояс и язык под регион выхода

Некоторые сайты показывают другую валюту, язык и условия доставки в зависимости от того, откуда, судя по всему, пришёл посетитель. Чтобы увидеть местную версию страницы, кроме прокси задайте браузеру язык и часовой пояс региона выхода.

В Playwright для этого есть параметры контекста locale (языковой тег, например de-DE) и timezone_id (идентификатор пояса, например Europe/Berlin; в Node.js — timezoneId). Оба описаны в официальной документации. Они меняют то, что сообщает браузер; адрес меняет прокси.

• Источники:
• Playwright for Python: Browser.new_context
• Playwright docs: Emulation, locale and timezone

Python: прокси, язык и часовой пояс в одном контексте

context = browser.new_context(
    proxy={"server": "http://HOST:PORT", "username": "USERNAME", "password": "PASSWORD"},
    locale="de-DE",
    timezone_id="Europe/Berlin",
)

Только пример: подставьте свои значения.

• Источники:
• Playwright for Python: Browser.new_context

Node.js: прокси, язык и часовой пояс в одном контексте

const context = await browser.newContext({
  proxy: { server: 'http://HOST:PORT', username: 'USERNAME', password: 'PASSWORD' },
  locale: 'de-DE',
  timezoneId: 'Europe/Berlin',
});

Только пример: подставьте свои значения.

• Источники:
• Playwright docs: Emulation, locale and timezone

Измеренные выходы со стороны Amazon

Почасовая проверка Proxy302, 3 ноября 2026, 18:18 UTC: по одному запросу к Amazon из каждой страны через ротируемый резидентный выход. Публикуются только первые три октета IP. Один замер на страну, а не среднее; следующие проверки дадут другие цифры.

• Источники:
• Proxy302 hourly connectivity check

Типичные ошибки и что делать

Для чего это подходит

Обычные задачи: чтение публичных страниц, проверка того, как страница выглядит в другом регионе, QA локализованного сайта и сбор данных с соблюдением условий сайта и лимитов запросов. Прокси меняет только сетевой адрес, который видит сервис; не частите с запросами и соблюдайте правила каждого сайта.

Как это сделать с Proxy302

Ротируемые резидентные подходят агентам, которые читают много страниц или проверяют несколько регионов: выберите страну, создайте прокси с протоколом HTTP и используйте proxy.proxy302.com, порт 2222. Статический ISP IP подходит агенту, который входит в аккаунт и которому нужен один постоянный адрес. Описание продукта — на странице ротируемых резидентных прокси.

• ротируемые резидентные прокси

Как это сделать с Proxy302: шаги

1. Шаг 1

   Откройте страницу ротируемых резидентных (или статических ISP), выберите страну и протокол HTTP и создайте прокси.

2. Шаг 2

   Откройте «Мои активы» (страница консоли со всем купленным) и скопируйте HOST, PORT, USERNAME и PASSWORD. На странице «Подключение» есть готовый пример с вашим адресом.

3. Шаг 3

   Подставьте их в ProxySettings, параметр proxy Playwright или аргумент MCP.

4. Шаг 4

   Проверьте выход: пусть агент откроет https://ipinfo.io/json и назовёт IP и страну. Страна должна совпасть с выбранной.

5. Шаг 5

   Из материкового Китая откройте Helper на странице «Подключение», нажмите 「一键加速」 (One-click boost) и держите его открытым, пока пользуетесь прокси.

   • Руководство по Helper

Цены и ограничения

Ротируемые резидентные стоят от 1,5 доллара за ГБ на линии Budget и 5 долларов за ГБ на линии Premium, в больших пакетах дешевле. Статический ISP IP — 0,5 доллара за 1 день и 7,99 доллара за 30 дней. Бесплатного пробного периода нет: минимальная покупка — 1 ГБ или один IP на один день. Прокси не снимает ограничения, не отменяет блокировку и не повышает лимит.

• Источники:
• Proxy302 product facts and price list

Proxy302 коротко

Цены указаны в PTC и списываются с кошелька; 1 PTC = 1 доллар США. Бесплатного пробного периода нет: минимальная покупка — 1 ГБ ротируемого резидентного трафика или один IP на один день. Проверено 4 ноября 2026 г.

• Источники:
• Proxy302 product facts and price list
• Proxy302 ISP for AI subscriptions: public catalog

Вопросы и ответы

Читайте дальше

Прокси для Playwright

Playwright прокси с логином и паролем: IP дата-центра для тестов и CI, ротационные резидентные от $1,50/ГБ для сайтов, которые блокируют серверы.

Посмотреть параметры и цену

Прокси MCP-сервер

Что такое прокси MCP-сервер, чем отличаются локальные и удалённые MCP-серверы, как установить его в Claude Code, Codex CLI и Cursor и как направить собственный трафик сервера через прокси.

Резидентные, ISP или дата-центр: какой прокси нужен ИИ-агенту

Ротируемые резидентные, статические ISP и дата-центр простыми словами и по четырём задачам агента: поиск, вход в аккаунт, вызовы API, сбор данных.

Ротируемые резидентные прокси

Реальные домашние IP в 195+ странах с выбором региона и города. Смена IP на каждый запрос или липкие сессии. От $1,50/ГБ, $1,35/ГБ при 100 ГБ. HTTP и SOCKS5.

Посмотреть параметры и цену

Как проверить прокси: IP, страна, провайдер

Как за 30 секунд проверить IP, страну и провайдера прокси, почему сервисы расходятся в городе и что значит «чистота» IP. С нашей проверкой трёх сервисов.