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 Logo

Bright Data MCP

Поиск в интернете, сбор данных со страниц, извлечение структурированных данных и автоматизация браузера для ИИ-агентов и LLM через Model Context Protocol.

Работает с ИИ-агентами, агентами для программирования, чат-ассистентами и любыми клиентами, совместимыми с MCP.

npm version npm downloads License

Быстрый старт • Цены • Варианты использования • Инструменты • Навыки агентов • Документация • Поддержка

Бесплатный тариф: 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
  1. Перейдите в Settings → Connectors → Add custom connector
  2. Имя: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. Нажмите "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
Чтение конкретной страницы в чистом формате Markdownscrape_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
Прямая замена встроенного получения данных по URLscrape_as_markdown
Сбор данных параллельно (по 5 за раз)search_engine_batch, scrape_batch
Интерактивные сайты (страницы входа, бесконечная прокрутка, динамический контент)scraping_browser_* (14 инструментов)

Агенты для программирования

Получайте данные из реестров пакетов по запросу — без скрейпинга и устаревших кэшей.

ЗадачаИнструменты
Версия пакета npm и PyPI, README, метаданныеrun_scraper со скрейпером npmjs или pypi (найдите их с помощью search_scrapers)
Чтение файлов из репозиториев GitHubrun_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.

ПлатформаПримеры скрейперов
LinkedInпрофили пользователей, профили компаний, списки вакансий, публикации, поиск людей
Instagramпрофили, публикации, Reels, комментарии
TikTokпрофили, публикации, магазин, комментарии
Facebookпрофили, публикации, объявления на Marketplace, отзывы о компаниях, события
YouTubeвидео, каналы, комментарии
X (Twitter)публикации, публикации профиля
Redditпубликации, комментарии

Пример запроса: «Получи последние 10 публикаций из этого профиля TikTok и обобщи показатели вовлечённости».

Создание контента и академические исследования

Собирайте исходные материалы сразу со многих страниц, отфильтрованные по актуальности и релевантности.

ЗадачаИнструменты
Сбор данных из нескольких источников за один вызовscrape_batch (до 5 URL)
Новости и финансовые данныеsearch_engine с запросами новостей, run_scraper со скрейпером Yahoo Finance

Сравнение

ВозможностьBright Data MCPТипичные веб-серверы MCP
Всего инструментов302–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_htmlHTML текущей страницы
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 и определяет самый дешёвый вариант в наличии

Просмотреть все 21 навык →


Конфигурация

Базовая настройка (локально)

{
  "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_serpmy_serp_zone
BROWSER_ZONEПользовательское имя зоны Browsermcp_browsermy_browser_zone
CONTENT_GATEЕсли содержимое страницы, возвращённое инструментом работы с данными, похоже на инструкции по изменению конфигурации MCP, сервер запрашивает подтверждение пользователя (через MCP elicitation), прежде чем вернуть его. Установите значение off, чтобы отключить эту функциюonoff
CONTENT_GATE_TIMEOUTСколько секунд ждать ответа пользователя, прежде чем скрыть содержимое12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot всегда перечисляет только кнопки, ссылки и поля. Это экономит токены и не позволяет тексту страницы выдаваться за интерактивный элемент (для конфиденциальных задач). При необходимости текст страницы можно прочитать с помощью scraping_browser_get_textoffon
BASE_TIMEOUTТайм-аут запросов для базовых инструментов в секундах (поиск и скрейпинг)Без ограничений60, 120
BASE_MAX_RETRIESМаксимальное количество повторных попыток базовых инструментов при временных ошибках (0–3)01, 3
GROUPSID групп инструментов, разделённые запятыми. Ограничивает сервер указанными группамиВсе инструменты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. Инструменты браузера не затрагиваются.


Документация

РесурсСсылка
Документация APIdocs.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.


Поддержка

КаналСсылка
Проблемы на GitHubgithub.com/brightdata-com/brightdata-mcp/issues
Документацияdocs.brightdata.com/ai/mcp-server/overview
Электронная почтаsupport@brightdata.com

Лицензия

MIT © Bright Data Ltd.