MCP-сервер (Model Context Protocol) для Browserless.io — предоставляет API умного скрапера Browserless LLM-клиентам, таким как Claude Desktop, Cursor, VS Code и Windsurf.
Получите API-токен на browserless.io (доступен бесплатный тариф), затем подключите вашего MCP-клиента к размещённому серверу:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}Локальная установка не требуется — примеры для каждого клиента см. в разделе Конфигурация.
Related MCP server: Pinchtab MCP Wrapper
Инструмент | Описание |
| Извлекает содержимое одной веб-страницы и возвращает его в виде markdown или HTML. Автоматически обрабатывает страницы с большим количеством JavaScript и защиту от ботов. Для содержимого из нескольких страниц используйте |
| Ищет в интернете с помощью Browserless и при необходимости извлекает каждый результат. Поддерживает поиск по вебу, новостям и изображениям с геотаргетингом и временными фильтрами. |
| Обнаруживает и составляет карту всех URL-адресов сайта. Выполняет сканирование через sitemap-файлы и извлечение ссылок. Возвращает URL-адреса с опциональными заголовками и описаниями. Полезно для аудита сайтов и обнаружения контента. |
| Обходит сайт и извлекает содержимое всех обнаруженных страниц. Поддерживает контроль глубины, фильтрацию по путям, стратегии sitemap и настраиваемые параметры извлечения. Возвращает извлечённый контент и метаданные для каждой страницы. |
| Запускает аудит Lighthouse для любого URL. Возвращает баллы и метрики по accessibility, best practices, performance, PWA и SEO. При необходимости можно отфильтровать по категории или задать бюджеты производительности. |
| Выполняет пользовательский JavaScript Puppeteer в облаке Browserless. Функция получает объект |
| Экспортирует веб-страницу через API Browserless |
| Управляет постоянным сеансом браузера через ReAct-цикл: снимок страницы, планирование, пакетные взаимодействия (click, type, scroll, evaluate и т.д.) и повторный снимок. Использует селекторы на основе ref, полученные из снимков; поддерживает сценарии с несколькими вкладками, скриншоты, решение капч, живые URL-адреса, а также загрузку и скачивание файлов (перехваченные скачивания автоматически становятся handle; байты никогда не попадают в контекст). |
| Загружает по требованию рецепт для нетривиальной механики страницы (shadow DOM, cookie consent, модальные окна, капчи, динамический контент, пропуски снимков, скриншоты, вкладки). Дополнение к |
| Выводит список профилей аутентификации, сохранённых для текущего токена, с количеством cookie и источников. Передайте имя профиля как |
| Читает информацию об аккаунте, связанном с текущим токеном: тариф, баланс юнитов, расчётный период и имена API-ключей. Никогда не возвращает значения API-токенов. |
| Читает потребление запросов и юнитов: успешные запросы, ошибки, таймауты, очередь, пиковую параллельность, капчи, байты и юниты прокси. При необходимости можно ограничить конкретными API-ключами. |
| Просматривает сеансы аккаунта: работающие сейчас браузеры, постоянные сеансы на выделенных воркерах, записанные повторные сеансы и интеграции с учётными данными 1Password. Также скачивает повторный сеанс как полностью автономную страницу проигрывателя rrweb ( |
| Читает собственный журнал Browserless с недавними запросами: что пытались выполнить, была ли ошибка, почему выполнение остановилось, сколько времени это заняло и сколько стоило. Инструмент для диагностики запуска, завершившегося ошибкой на стороне Browserless. Доступный период зависит от тарифа. |
Сервер поставляется со встроенной библиотекой навыков — рецептов по требованию, которые агент может загружать для обработки сложных механик страниц. Навыки автоматически внедряются в ответы browserless_agent, когда срабатывают их триггеры (например, агент сталкивается с cookie-баннером), а также могут загружаться вручную через инструмент browserless_skill.
Навык | Источник | Назначение |
| Глубокие селекторы и нацеливание на iframe через теневые корни. | |
| Рецепты закрытия от конкретных вендоров (OneTrust, Cookiebot, Didomi, TrustArc и т.д.). | |
| Закрытие диалогов, alertdialog и эвристики для кнопок закрытия оверлеев. | |
| Использование команды | |
| Выбор подходящего метода | |
| Обработка обрезанных/пустых снимков и контента, отображаемого изображением. | |
| Когда делать скриншот, а когда снимок; выбор области и формата. | |
| Сценарии с несколькими вкладками и просмотр без переключения через |
Загрузите навык явно:
{
"method": "tools/call",
"params": {
"name": "browserless_skill",
"arguments": { "id": "cookie-consent" },
},
}browserless_agent)Передайте объект proxy верхнего уровня в browserless_agent, чтобы направить сеанс через резидентные IP-адреса. Применяйте это, когда целевые сайты блокируют по IP трафик из дата-центров.
{
"method": "tools/call",
"params": {
"name": "browserless_agent",
"arguments": {
"method": "goto",
"params": { "url": "https://example.com" },
"proxy": {
"proxy": "residential",
"proxyCountry": "us",
"proxySticky": true,
},
},
},
}Поле | Примечания |
|
|
| ISO-2 код страны ( |
| Название штата США с пробелами, заменёнными на подчёркивания ( |
| Целевой город. Доступно только на платных/корпоративных тарифах — неподходящие токены получают 401. |
| Стабильный IP, пока остаётся открытым нижележащий WebSocket. Переподключения (обрыв из-за простоя, кратковременный сбой сети, падение браузера) выделяют новый sticky id и новый IP. |
| Сопоставляет локаль |
| Именованный пресет (например, |
| Собственный апстрим, например |
Примечание: для
proxyCountry/proxyState/proxyCity/proxySticky/proxyLocaleMatch/proxyPresetтребуется указывать либоproxy: "residential", либоexternalProxyServer. MCP отклоняет такую комбинацию на этапе валидации; при её отсутствии API будет молча их игнорировать.
Объект proxy считывается один раз при создании сессии. Чтобы изменить его, вызовите close и начните новую сессию — клиент агента привязывает сессии к отпечатку proxy, поэтому передача другой конфигурации приведёт к новому WebSocket.
Сервер размещён по адресу https://mcp.browserless.io/mcp. Аутентификация выполняется через заголовки (рекомендуется) или параметр запроса ?token=.
Устанавливаете через ИИ-агента? См. install.md с инструкциями по настройке, понятными агенту.
Использование заголовков (рекомендуется для клиентов, которые их поддерживают):
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer your-token-here"
}
}
}
}Использование параметров запроса в URL (для клиентов, например пользовательских коннекторов Claude.ai, которые принимают только URL):
https://mcp.browserless.io/mcp?token=your-token-hereЧтобы подключиться к конкретному региональному endpoint Browserless, добавьте заголовок x-browserless-api-url или параметр запроса browserlessUrl:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer your-token-here",
"x-browserless-api-url": "https://production-lon.browserless.io"
}
}
}
}https://mcp.browserless.io/mcp?token=your-token-here&browserlessUrl=https://production-lon.browserless.ioЕсли присутствуют и заголовки, и параметры запроса, приоритет имеют заголовки.
Добавьте в ваш claude_desktop_config.json:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}Добавьте в настройки Cursor MCP:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}Добавьте в настройки VS Code (settings.json):
{
"mcp": {
"servers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer your-token-here"
}
}
}
}
}Добавьте в конфигурацию Windsurf MCP:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}Сервер также можно запускать локально — это полезно для развёртываний в изолированной среде или для подключения к самостоятельному экземпляру Browserless. Клонируйте этот репозиторий и соберите Docker-образ:
docker build -f docker/Dockerfile -t browserless-mcp .
docker run \
-e BROWSERLESS_TOKEN=your-token \
-e BROWSERLESS_API_URL=https://your-browserless-instance.example.com \
-p 8080:8080 \
browserless-mcpЗатем укажите вашему MCP-клиенту адрес http://localhost:8080/mcp, используя ту же аутентификацию через заголовки/параметры запроса, что и выше.
Переменная | Обязательная | По умолчанию | Описание |
| Да | — | Ваш API-токен Browserless |
| Нет |
| API endpoint (для самостоятельного экземпляра Browserless) |
| Нет |
| Хост API аккаунта — обеспечивает работу |
| Нет |
| Origin, раздающий артефакты воспроизведения сессий. Пути воспроизведения проверяются на соответствие этому origin |
| Нет |
| Тип транспорта: |
| Нет |
| Порт HTTP-сервера (только для транспорта |
| Нет |
| Таймаут запроса в миллисекундах |
| Нет |
| Максимальное количество повторов для неудачных запросов |
| Нет |
| Время жизни кэша в миллисекундах (0 для отключения) |
| Нет | — | API-ключ проекта Amplitude. Отправляет аналитику использования MCP — события жизненного цикла SDK, а также собственные события инструментов и навыков |
| Нет | не задано (полная поверхность) | Предоставляет урезанную поверхность, соответствующую требованиям каталога. Fail closed: любое установленное значение, кроме |
URI ресурса | Описание |
| Документация API Smart Scraper |
| Актуальный статус работоспособности сервиса |
Промпт | Описание |
| Скрапить веб-страницу и обобщать её содержимое |
| Извлекать конкретную информацию с веб-страницы |
npm install
npm run build
npm test
npm run coverageТестовый набор использует Mocha вместе с Chai и Sinon. Спецификации находятся рядом с кодом в test/ (test/lib/, test/tools/, test/prompts/, test/resources/, test/integration/) и выполняются на скомпилированном выводе в build/.
npm test — компилирует TypeScript и запускает каждый *.spec.js в build/test/. Внешние сервисы и BROWSERLESS_TOKEN не требуются; API-клиент заменён заглушкой.
npm run coverage — запускает набор под управлением c8 с пороговыми значениями, настроенными в package.json (строки ≥ 80%, ветви ≥ 70%, функции ≥ 80%).
Тесты запускаются автоматически для каждого pull request через Test workflow на Node 24. Перед слиянием PR должны сохранять набор тестов зелёным.
Получите свой API-токен на сайте browserless.io. Токен аутентифицирует все запросы к API Browserless.
SSPL-1.0
Zenrows MCP server — Fetch, Extract, Batch, and Browser Sessions for AI coding assistants
Official Octoparse MCP server for template discovery, cloud tasks, and structured data export.
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/browserless/browserless-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server