Bright Data
официальныйОбнаруживайте, извлекайте и взаимодействуйте с вебом — единый интерфейс для автоматизированного доступа по всему публичному интернету.
Что можно делать с Bright Data MCP?
- Веб-поиск — Попросите ассистента выполнить поиск в Bing или Google и вернуть структурированные результаты со ссылками, заголовками и описаниями.
- Сбор данных со страниц — Получайте содержимое любого URL в виде чистого Markdown, текста, HTML или ld_json; встроены обнаружение ботов и обработка CAPTCHA.
- Структурированные данные платформ — Находите и запускайте готовые скрейперы для таких сайтов, как Amazon, LinkedIn, TikTok и npm, чтобы получать чистый JSON вместо разбора HTML.
- Автоматизация браузера — Переходите по страницам, нажимайте, вводите текст, прокручивайте и делайте снимки экрана в удалённом сеансе браузера для интерактивных сайтов или сайтов с ограниченным доступом.
- Сбор ответов LLM — Отправляйте запросы в ChatGPT или Perplexity и получайте ответы, чтобы сравнить, как каждый из них описывает бренд.
- Пакетный сбор данных — Выполняйте до 5 поисковых запросов или собирайте данные с 5 URL за один вызов для параллельного сбора данных.
Документация
Bright Data MCP
Поиск в интернете, сбор данных со страниц, извлечение структурированных данных и автоматизация браузера для ИИ-агентов и LLM через Model Context Protocol.
Работает с ИИ-агентами, агентами для программирования, чат-ассистентами и любыми клиентами, совместимыми с MCP.
Быстрый старт • Цены • Варианты использования • Инструменты • Навыки агентов • Документация • Поддержка
Бесплатный тариф: 5 000 запросов в месяц. Банковская карта не требуется. Обновляется ежемесячно.
Обзор
Сервер Bright Data MCP предоставляет ИИ-агентам доступ к общедоступным веб-данным в реальном времени. Он включает 30 инструментов для:
- Поиска в интернете — результаты Bing и Google в виде структурированных данных
- Сбора данных со страниц — преобразование любой URL-страницы в Markdown или HTML; обнаружение ботов, решение CAPTCHA и ротация прокси автоматически выполняются при каждом запросе
- Структурированных данных (Web Scraper API) — чистый JSON из более чем 1 200 готовых скрейперов: Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI и других, без разбора HTML. Шесть инструментов позволяют найти и запустить любой из них
- Автоматизации браузера — переход по страницам, нажатия, ввод текста, создание снимков экрана и чтение страниц в удалённом сеансе браузера
- Сбора ответов LLM — отправка запросов в ChatGPT и Perplexity и получение ответов в виде структурированных данных
Каждый запрос проходит через инфраструктуру Bright Data для обхода блокировок, поэтому страницы, блокирующие обычные HTTP-клиенты (обнаружение ботов, CAPTCHA, ограничения частоты запросов, географические ограничения), загружаются без проблем. Настройка прокси не нужна, обслуживать headless-браузер не нужно, логику повторных попыток писать не нужно.
Доступны два варианта развёртывания: размещённый удалённый сервер (один URL, установка не требуется) или локальный экземпляр через npx @brightdata/mcp.
Быстрый старт
Размещённый сервер — установка не требуется. Добавьте этот URL в свой MCP-клиент:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
Получите API-токен в настройках аккаунта Bright Data. Новые аккаунты получают 5 000 бесплатных запросов в месяц.
Необязательные параметры URL:
| Параметр | Описание | Пример |
|---|---|---|
groups=<ids> | Ограничение определёнными группами инструментов (по умолчанию: все инструменты) | ...&groups=scrapers,browser |
tools=<names> | Ограничение определёнными инструментами | ...&tools=search_engine,scrape_as_markdown |
Claude Desktop
- Перейдите в Settings → Connectors → Add custom connector
- Имя:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - Нажмите "Add"
Или запустите локально:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
Claude Code
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
Cursor
Добавьте в ~/.cursor/mcp.json:
{
"mcpServers": {
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
VS Code
Добавьте в .vscode/mcp.json:
{
"servers": {
"brightdata": {
"type": "http",
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Windsurf
Добавьте в ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"brightdata": {
"serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Gemini CLI
Добавьте в ~/.gemini/settings.json:
{
"mcpServers": {
"brightdata": {
"httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Zed
Добавьте в настройки Zed:
{
"context_servers": {
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Warp
Перейдите в Settings > MCP Servers > Add MCP Server и добавьте:
{
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
Другие клиенты (локальный npx)
Для любого клиента, поддерживающего локальные MCP-серверы:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
Цены и бесплатный тариф
Каждый аккаунт включает ежемесячно обновляемый бесплатный тариф. Для начала работы не нужны ни банковская карта, ни обязательства.
5 000 бесплатных запросов в месяц, обновляются 1-го числа каждого месяца. Неиспользованные запросы не переносятся. В командных аккаунтах бесплатный тариф общий для всех пользователей аккаунта.
Что входит в бесплатный тариф:
- Получение любой веб-страницы и извлечение данных в формате Markdown
- Доступ к более чем 60 готовым скрейперам для популярных доменов
- Поиск в интернете (Bing, Google)
- Обход веб-блокировок (обход обнаружения ботов, решение CAPTCHA, ротация прокси)
- Автоматизация браузера
- Геотаргетинг
Сверх бесплатного тарифа — оплата по факту использования, без обязательств:
| Поиск, сбор и извлечение данных | Навигация в браузере | |
|---|---|---|
| Оплата по факту использования | $1.50 / 1K результатов | $8 / GB |
- Когда бесплатные запросы закончатся, запросы прекратятся. Никаких неожиданных списаний — если только вы не внесли средства
- Добавление банковской карты нужно только для проверки; списания не производятся, пока бесплатный тариф не исчерпан и на счёт не внесены средства
- Установите лимит расходов в панели управления, чтобы расходы при оплате по факту использования не превышали ваш бюджет
Полные сведения о ценах, тарифах для больших объёмов и корпоративных планах →
Варианты использования
Исследования в реальном времени
Отвечайте на вопросы, используя актуальные веб-данные, а не данные обучения. Выполните поиск, затем прочитайте источники.
| Задача | Инструменты |
|---|---|
| Поиск актуальной информации в интернете | search_engine, search_engine_batch |
| Чтение конкретной страницы в чистом формате Markdown | scrape_as_markdown, scrape_batch |
Примеры запросов: «Какова текущая цена акций Tesla?», «Узнай прогноз погоды в Нью-Йорке на сегодня», «Найди наиболее цитируемые источники о регулировании ИИ в ЕС за последние 6 месяцев».
Аналитика электронной коммерции
Получайте данные о товарах в виде структурированного JSON: цена, наличие, рейтинг, количество отзывов, продавец, изображения.
| Задача | Инструменты |
|---|---|
| Товары, отзывы и результаты поиска на Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara и в других магазинах | search_scrapers → get_scraper_details → run_scraper |
| Сравнение цен у разных продавцов | тот же процесс со скрейпером Google Shopping |
Примеры запросов: «Сравни цену этого ноутбука на Amazon, Walmart и Best Buy», «Узнай рейтинг и количество отзывов для ASIN B0D2Q9397Y», «Есть ли этот товар в наличии?».
Анализ рынка и конкурентов
Создавайте профили конкурентов на основе актуальных данных: финансирование, численность персонала, вакансии, отзывы клиентов, страницы с ценами.
| Задача | Инструменты |
|---|---|
| Финансирование компании, размер, сотрудники, вакансии (Crunchbase, ZoomInfo, LinkedIn) | search_scrapers → run_scraper |
| Отзывы клиентов (Google Maps, Facebook, отзывы в магазинах приложений) | search_scrapers → run_scraper |
| Страницы с ценами конкурентов | scrape_as_markdown, scrape_batch |
| Поиск по рынку | search_engine_batch |
Пример запроса: «Проанализируй Notion как конкурента: цены, финансирование, приоритеты найма и жалобы клиентов».
ИИ-агенты с надёжным доступом к интернету
Замените встроенные инструменты получения данных и поиска, которые блокируются на защищённых сайтах. Каждый запрос проходит через инфраструктуру обхода блокировок, поэтому агенты не сталкиваются с ошибками из-за обнаружения ботов, CAPTCHA или географических ограничений.
| Задача | Инструменты |
|---|---|
| Прямая замена встроенного поиска в интернете | search_engine |
| Прямая замена встроенного получения данных по URL | scrape_as_markdown |
| Сбор данных параллельно (по 5 за раз) | search_engine_batch, scrape_batch |
| Интерактивные сайты (страницы входа, бесконечная прокрутка, динамический контент) | scraping_browser_* (14 инструментов) |
Агенты для программирования
Получайте данные из реестров пакетов по запросу — без скрейпинга и устаревших кэшей.
| Задача | Инструменты |
|---|---|
| Версия пакета npm и PyPI, README, метаданные | run_scraper со скрейпером npmjs или pypi (найдите их с помощью search_scrapers) |
| Чтение файлов из репозиториев GitHub | run_scraper со скрейпером репозиториев GitHub |
Примеры запросов: «Какая последняя версия express в npm?», «Получи README пакета langchain-brightdata из PyPI».
GEO и видимость бренда
Отправляйте запросы ведущим LLM и получайте ответы в виде структурированных данных. Оценивайте, как ИИ-ассистенты описывают ваш бренд, на какие источники ссылаются и что рекомендуют — это обратная связь для Generative Engine Optimization.
| Задача | Инструменты |
|---|---|
| Ответы ChatGPT с цитатами и рекомендациями | chatgpt_ai_insights |
| Ответы Perplexity с источниками | perplexity_ai_insights |
Пример запроса: «Спроси ChatGPT и Perplexity: “какой провайдер прокси лучший” и сравни, какое место они отводят нам».
Мониторинг социальных сетей
Структурированные данные со всех основных платформ: профили, публикации, комментарии, показатели вовлечённости. Для каждой платформы есть скрейперы для разных типов данных (профили LinkedIn, Reels в Instagram, комментарии TikTok и т. д.); найдите их с помощью search_scrapers и запустите с помощью run_scraper.
| Платформа | Примеры скрейперов |
|---|---|
| профили пользователей, профили компаний, списки вакансий, публикации, поиск людей | |
| профили, публикации, Reels, комментарии | |
| TikTok | профили, публикации, магазин, комментарии |
| профили, публикации, объявления на Marketplace, отзывы о компаниях, события | |
| YouTube | видео, каналы, комментарии |
| X (Twitter) | публикации, публикации профиля |
| публикации, комментарии |
Пример запроса: «Получи последние 10 публикаций из этого профиля TikTok и обобщи показатели вовлечённости».
Создание контента и академические исследования
Собирайте исходные материалы сразу со многих страниц, отфильтрованные по актуальности и релевантности.
| Задача | Инструменты |
|---|---|
| Сбор данных из нескольких источников за один вызов | scrape_batch (до 5 URL) |
| Новости и финансовые данные | search_engine с запросами новостей, run_scraper со скрейпером Yahoo Finance |
Сравнение
| Возможность | Bright Data MCP | Типичные веб-серверы MCP |
|---|---|---|
| Всего инструментов | 30 | 2–10 |
| Извлечение структурированного JSON для конкретных платформ | Более 1 200 готовых скрейперов для электронной коммерции, социальных сетей, бизнеса, финансов, путешествий и магазинов приложений через 6 инструментов | Редко; обычно только универсальный скрейпинг |
| Обход блокировок (обход обнаружения ботов, решение CAPTCHA, ротация прокси) | Встроен в каждый запрос | Обычно отсутствует; защищённые сайты блокируют запросы |
| Поисковые системы | Bing, Google | Обычно одна |
| Автоматизация браузера | 14 инструментов, удалённый браузер, локальная настройка не требуется | Ограничена или отсутствует |
| Сбор ответов LLM (ChatGPT, Perplexity) | Да | Не предлагается |
| Данные из реестров пакетов (npm, PyPI) | Да | Не предлагаются |
| Пакетные операции | 10 поисковых запросов или 10 операций сбора данных за вызов | Обычно только один запрос |
| Геотаргетинг | Да | Ограничен или отсутствует |
| Бесплатный тариф | 5 000 запросов в месяц, включая автоматизацию браузера, банковская карта не требуется | Различается; часто доступ без ключа с ограничением частоты запросов |
Выбор инструментов: группы
Инструменты объединены в группы, чтобы загружать только нужные. Чем меньше инструментов, тем меньше контекста требуется обрабатывать агенту.
- Если не заданы
GROUPSилиTOOLS, включены все 30 инструментов. При задании любого из них сервер ограничивается только указанными инструментами GROUPSвключает наборы инструментов. Значения разделяются запятыми:GROUPS="scrapers,browser"(локально) или&groups=scrapers,browser(размещённый URL)TOOLSдобавляет отдельные инструменты:TOOLS="scrape_batch,session_stats". Если задан только этот параметр, включаются лишь перечисленные инструменты- В каждую группу также входят
search_engine,scrape_as_markdownиask_brightdata_assistant - Идентификатор группы
customзарезервирован; для выбора отдельных инструментов используйтеTOOLS| ID группы | Содержимое | Количество инструментов | |----------|----------|-----------| |scrapers| Поиск и запуск любых готовых скрейперов Web Scraper API (Amazon, LinkedIn, TikTok, npm, ...) | 6 | |browser| Удалённая автоматизация браузера | 14 | |geo| Сбор ответов ChatGPT и Perplexity | 2 | |advanced_scraping| Пакетные инструменты, статистика сеансов | 3 |
Старые ID групп (ecommerce, social, business, finance, research, app_stores, travel, code) по-прежнему работают и включают инструменты scrapers; social и business также добавляют search_dataset и list_dataset_fields. Старые имена web_data_* в TOOLS тоже включают инструменты scrapers.
Примеры конфигурации
Локальный сервер с автоматизацией браузера и пакетными инструментами:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "browser,advanced_scraping"
}
}
}
}
Настройка агента для программирования (Claude Code / Cursor / Windsurf) — данные npm, PyPI и GitHub через готовые скрейперы:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "scrapers"
}
}
}
}
Справочник по инструментам (30 инструментов)
Какой инструмент использовать
- Известен URL, нужно получить содержимое:
scrape_as_markdown. Несколько URL (до 5):scrape_batch - Нужно найти информацию:
search_engine. Несколько запросов (до 5):search_engine_batch - Структурированные данные с известной платформы (Amazon, LinkedIn, TikTok, npm, PyPI и т. д.):
search_scrapers→get_scraper_details→run_scraper— возвращает чистый JSON, быстрее и надёжнее, чем скрейпинг той же страницы - Исходный HTML:
scrape_as_markdownсformat: 'html' - Для страницы требуется взаимодействие (нажатие, ввод текста, прокрутка, вход в систему): инструменты
scraping_browser_* - Как ChatGPT/Perplexity отвечают на запрос:
chatgpt_ai_insights/perplexity_ai_insights - Вопрос о самом Bright Data (продукты, зоны, ошибки, настройка):
ask_brightdata_assistant
Примечания о запусках скрейперов:
- Возвращают структурированный JSON; оплата взимается за каждую возвращённую запись
- Записи с полем
errorсодержат пояснения о неудачных входных данных, например URL неподходящего типа - Результаты могут быть большими. Для методов
discover_by_*задавайте небольшое значениеlimit_per_inputи запускайте массовый сбор в субагенте, если это поддерживается вашей платформой, чтобы записи не переполняли основное контекстное окно - Если запуск завершился с ошибкой,
scrape_as_markdownможно использовать как запасной вариант для того же URL
Поиск и скрейпинг — 5 инструментов
| Инструмент | Описание | Группа |
|---|---|---|
search_engine | Поиск в Bing (по умолчанию) или Google. Возвращает JSON (ссылка, заголовок, описание), 10 результатов на страницу. Параметры: country, page (начиная с 0), time_range (hour, day, week, month, year, any; Bing поддерживает только day, week, year) | по умолчанию / все группы |
search_engine_batch | До 5 поисковых запросов за один вызов | по умолчанию / advanced_scraping |
scrape_as_markdown | Любой URL. Возвращает содержимое в формате markdown (по умолчанию), text, html или ld_json | по умолчанию / все группы |
scrape_batch | До 5 URL за один вызов. Возвращает содержимое в формате markdown (по умолчанию), text, html или ld_json | по умолчанию / advanced_scraping |
session_stats | Количество использований инструментов в текущем сеансе | по умолчанию / advanced_scraping |
Web Scraper API — 6 инструментов
Поиск и запуск любых из более чем 1 200 готовых скрейперов Bright Data. Список скрейперов загружается из docs.brightdata.com/scrapers.json и обновляется ежедневно. Доступно как на размещённом, так и на локальном сервере. Включено по умолчанию, если инструменты или группы не выбраны; в противном случае добавьте группу scrapers (&groups=scrapers в размещённом URL, GROUPS=scrapers локально).
Типичный процесс: search_scrapers → get_scraper_details → run_scraper. Оплата за запуски взимается за каждую запись; методы discover_by_* собирают до limit_per_input записей на один входной параметр (по умолчанию 10).
| Инструмент | Описание | Группа |
|---|---|---|
search_scrapers | Поиск скрейперов по сайту или типу данных (например, "amazon reviews", "linkedin.com"). Возвращает ID набора данных, название, домен и методы сбора | по умолчанию / scrapers |
get_scraper_details | Описание, поля ввода, пример входных данных и основные поля результата для одного метода скрейпера | по умолчанию / scrapers |
run_scraper | Запуск метода скрейпера. Ожидает до 45 секунд; если он всё ещё выполняется, возвращает snapshot_id для последующей проверки | по умолчанию / scrapers |
get_scraper_progress | Состояние запуска: starting, running, ready, failed или canceled | по умолчанию / scrapers |
get_scraper_results | Записи завершённого запуска | по умолчанию / scrapers |
refresh_scrapers | Немедленная перезагрузка списка скрейперов вместо ожидания ежедневного обновления | по умолчанию / scrapers |
Автоматизация браузера — 14 инструментов
Удалённый сеанс браузера. Типичная последовательность: перейти на страницу → получить снимок → взаимодействовать по ref → извлечь данные или сделать снимок экрана.
| Инструмент | Описание |
|---|---|
scraping_browser_navigate | Открыть или повторно использовать сеанс браузера и перейти по URL |
scraping_browser_go_back | Перейти назад |
scraping_browser_go_forward | Перейти вперёд |
scraping_browser_snapshot | Снимок страницы ARIA со списком интерактивных элементов и их ref. Требуется перед действиями по ref |
scraping_browser_click_ref | Нажать элемент по ref из последнего снимка |
scraping_browser_type_ref | Ввести текст в элемент по ref; при необходимости нажать Enter для отправки |
scraping_browser_fill_form | Заполнить несколько полей формы по ref за один вызов |
scraping_browser_screenshot | Снимок экрана текущей страницы; необязательный параметр full_page |
scraping_browser_get_text | Текстовое содержимое тела страницы |
scraping_browser_get_html | HTML текущей страницы |
scraping_browser_scroll | Прокрутить страницу до конца |
scraping_browser_scroll_to_ref | Прокрутить страницу до элемента |
scraping_browser_wait_for_ref | Дождаться появления элемента с необязательным тайм-аутом |
scraping_browser_network_requests | Сетевые запросы с момента загрузки страницы: метод, URL, статус |
Ref берутся из последнего снимка. Если страница изменилась после нажатия или перехода, перед следующим действием по ref сделайте новый снимок. Для статических страниц scrape_as_markdown быстрее и дешевле сеанса браузера.
GEO и видимость в LLM — 2 инструмента
| Инструмент | Входные данные | Результат |
|---|---|---|
chatgpt_ai_insights | Запрос | Ответ ChatGPT в формате Markdown |
perplexity_ai_insights | Запрос | Ответ Perplexity в формате Markdown |
Используйте для Generative Engine Optimization (отслеживания того, как LLM описывают ваш бренд) и рабочих процессов с LLM в роли судьи.
Поиск по наборам данных — 2 инструмента
Фильтрация и поиск по сохранённым наборам данных LinkedIn; возвращает подходящие записи сразу, без запуска скрейпера.
| Инструмент | Описание | Группа |
|---|---|---|
list_dataset_fields | Поля набора данных, доступные для фильтрации (название, тип, описание). Вызовите перед search_dataset | по умолчанию / social, business |
search_dataset | Записи, соответствующие фильтру, до 10 за вызов; для получения следующих записей используется курсор | по умолчанию / social, business |
Помощник Bright Data — 1 инструмент
| Инструмент | Описание | Группа |
|---|---|---|
ask_brightdata_assistant | Задайте Софи, помощнику службы поддержки Bright Data, вопросы о продуктах, API, зонах, ошибках или настройке аккаунта. Передайте возвращённый dialog_id, чтобы задать уточняющий вопрос в той же ветке | по умолчанию / все группы |
Полный справочник по инструментам в документации →
Навыки агента
Готовые навыки, которые учат агента правильно использовать этот MCP-сервер. Полная коллекция находится на github.com/brightdata/skills — 21 навык по оркестрации MCP, конкурентной разведке, сравнению цен, мониторингу упоминаний бренда, SEO-аудитам, созданию скрейперов, конвейерам RAG и многому другому.
Три наиболее полезных навыка:
| Навык | Назначение |
|---|---|
| bright-data-mcp | Настраивает Bright Data MCP как инструмент по умолчанию для всех операций с веб-данными, заменяя WebFetch, WebSearch и другие встроенные веб-инструменты, которые не справляются с обнаружением ботов |
| competitive-intel | Снимки данных о конкурентах, сравнение цен, анализ отзывов, сигналы найма, анализ контента/SEO и карты рынка на основе актуальных веб-данных |
| price-comparison | Находит товар на Amazon, Walmart, eBay, Best Buy и Google Shopping и определяет самый дешёвый вариант в наличии |
Конфигурация
Базовая настройка (локально)
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here"
}
}
}
}
Расширенная конфигурация
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here",
"RATE_LIMIT": "100/1h",
"SERP_ZONE": "custom_serp",
"BROWSER_ZONE": "custom_browser"
}
}
}
}
Переменные окружения
| Переменная | Описание | Значение по умолчанию | Пример |
|---|---|---|---|
API_TOKEN | Ваш API-токен Bright Data (обязательный) | - | your-token-here |
RATE_LIMIT | Настраиваемое ограничение частоты запросов | без ограничений | 100/1h, 50/30m |
SERP_ZONE | Пользовательское имя зоны SERP API, используемое инструментами поиска | mcp_serp | my_serp_zone |
BROWSER_ZONE | Пользовательское имя зоны Browser | mcp_browser | my_browser_zone |
CONTENT_GATE | Если содержимое страницы, возвращённое инструментом работы с данными, похоже на инструкции по изменению конфигурации MCP, сервер запрашивает подтверждение пользователя (через MCP elicitation), прежде чем вернуть его. Установите значение off, чтобы отключить эту функцию | on | off |
CONTENT_GATE_TIMEOUT | Сколько секунд ждать ответа пользователя, прежде чем скрыть содержимое | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_browser_snapshot всегда перечисляет только кнопки, ссылки и поля. Это экономит токены и не позволяет тексту страницы выдаваться за интерактивный элемент (для конфиденциальных задач). При необходимости текст страницы можно прочитать с помощью scraping_browser_get_text | off | on |
BASE_TIMEOUT | Тайм-аут запросов для базовых инструментов в секундах (поиск и скрейпинг) | Без ограничений | 60, 120 |
BASE_MAX_RETRIES | Максимальное количество повторных попыток базовых инструментов при временных ошибках (0–3) | 0 | 1, 3 |
GROUPS | ID групп инструментов, разделённые запятыми. Ограничивает сервер указанными группами | Все инструменты | scrapers,browser |
TOOLS | Имена отдельных инструментов, разделённые запятыми. Ограничивает сервер указанными инструментами | Все инструменты | scrape_batch,session_stats |
Фильтр содержимого
scrape_as_markdown, search_engine и их пакетные варианты возвращают всё, что написано на веб-
странице. Если содержимое включает текст, похожий на инструкции по изменению конфигурации MCP — зарегистрировать сервер, запустить пакет npx -y, отредактировать файл конфигурации MCP, — сервер
приостанавливает работу и запрашивает подтверждение через ваш MCP-клиент, прежде чем вернуть содержимое. Если вы одобрите запрос, содержимое будет возвращено без изменений; если отклоните — оно будет скрыто, а помощник получит краткое объяснение. Страницы,
не содержащие такого текста, возвращаются как и прежде, без запроса. При пакетном вызове скрываются только
подходящие элементы.
Страницы, посвящённые конфигурации MCP (документация, файлы README), естественным образом вызовут запрос. Клиенты,
не поддерживающие MCP elicitation, не получат подходящее содержимое; установите CONTENT_GATE=off, если
принимаете этот риск. Пока сервер ждёт ответа, он сообщает о ходе выполнения; клиенты, которые
не продлевают тайм-аут инструмента при получении уведомлений о ходе выполнения, ограничат ожидание собственным лимитом — на стороне сервера за это отвечает параметр CONTENT_GATE_TIMEOUT. Инструменты браузера не затрагиваются.
Документация
| Ресурс | Ссылка |
|---|---|
| Документация API | docs.brightdata.com/ai/mcp-server/overview |
| Полный справочник инструментов | docs.brightdata.com/ai/mcp-server/tools |
| Навыки агентов | github.com/brightdata/skills |
| Примеры использования | примеры |
| Журнал изменений | CHANGELOG.md |
Устранение неполадок
Распространённые проблемы и решения
Ошибка «spawn npx ENOENT»
Установите Node.js или укажите полный путь к node:
"command": "/usr/local/bin/node" // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe" // Windows
Тайм-ауты на сложных сайтах
Увеличьте время ожидания в настройках клиента до 180s.
Проблемы с аутентификацией
Убедитесь, что ваш токен API действителен и имеет необходимые разрешения. Управлять токенами можно в настройках аккаунта.
run_scraper возвращает ошибки или не возвращает данные
Записи с полем error объясняют, какие входные данные не удалось обработать. Сравните свои входные данные с sample_input из get_scraper_details (например, URL товаров Amazon содержат /dp/, а URL Walmart — /ip/) и проверьте, доступна ли страница публично. scrape_as_markdown служит запасным вариантом для того же URL.
Не удаётся подключиться к удалённому серверу
Проверьте подключение к интернету и настройки брандмауэра.
Участие в разработке
Следуйте стандартам кодирования Bright Data.
Поддержка
| Канал | Ссылка |
|---|---|
| Проблемы на GitHub | github.com/brightdata-com/brightdata-mcp/issues |
| Документация | docs.brightdata.com/ai/mcp-server/overview |
| Электронная почта | support@brightdata.com |
Лицензия
MIT © Bright Data Ltd.