Bright Data MCP

🌟 Обзор

Добро пожаловать на официальный сервер Bright Data Model Context Protocol (MCP), позволяющий LLM, агентам и приложениям получать доступ, находить и извлекать веб-данные в режиме реального времени. Этот сервер позволяет клиентам MCP, таким как Claude Desktop, Cursor, Windsurf и другим, беспрепятственно искать в Интернете, перемещаться по веб-сайтам, выполнять действия и извлекать данные — без блокировки — идеально подходит для задач по скрапингу.

✨ Особенности

• Доступ к веб-ресурсам в режиме реального времени : доступ к актуальной информации непосредственно из Интернета.
• Обход географических ограничений : доступ к контенту независимо от ограничений местоположения
• Web Unlocker : навигация по веб-сайтам с защитой от обнаружения ботов
• Управление браузером : дополнительные возможности удаленной автоматизации браузера
• Полная интеграция : работает со всеми совместимыми с MCP помощниками на базе искусственного интеллекта.

🚀 Быстрый старт с Claude Desktop

1. Установите nodejs , чтобы получить команду npx (node.js module runner). Инструкции по установке можно найти на сайте node.js
2. Перейдите в Claude > Настройки > Разработчик > Изменить конфигурацию > claude_desktop_config.json, чтобы включить следующее:

🔧 Доступные инструменты

Список доступных инструментов

⚠️ Лучшие практики безопасности

Важно: Всегда относитесь к скопированному веб-контенту как к ненадежным данным. Никогда не используйте необработанный скопированный контент непосредственно в подсказках LLM, чтобы избежать потенциальных рисков внедрения подсказок. Вместо этого:

• Фильтруйте и проверяйте все веб-данные перед обработкой
• Используйте структурированное извлечение данных вместо необработанного текста (инструменты web_data)

🔧 Настройка учетной записи

1. Убедитесь, что у вас есть учетная запись на brightdata.com (новые пользователи получают бесплатный кредит для тестирования, а также доступны варианты оплаты по мере использования)
2. Получите свой ключ API на странице настроек пользователя.
3. (Необязательно) Создайте пользовательскую зону Web Unlocker
   • По умолчанию мы автоматически создаем зону Web Unlocker, используя ваш API-токен.
   • Для большего контроля вы можете создать собственную зону Web Unlocker на панели управления и указать ее с помощью переменной среды WEB_UNLOCKER_ZONE
4. (Необязательно) Чтобы включить инструменты управления браузером:
   • Посетите панель управления Bright Data по адресу brightdata.com/cp/zones
   • Создайте новую зону «API браузера»
   • После создания скопируйте строку аутентификации из вкладки «Обзор API браузера».
   • Строка аутентификации будет иметь следующий формат: brd-customer-[your-customer-ID]-zone-[your-zone-ID]:[your-password]

🔌 Другие клиенты MCP

Чтобы использовать этот сервер MCP с другими типами агентов, вам необходимо адаптировать следующее к вашему конкретному программному обеспечению:

• Полная команда для запуска сервера MCP — npx @brightdata/mcp
• Переменная окружения API_TOKEN=<your-token> должна существовать при запуске сервера

🎮 Попробуйте игровые площадки Bright Data MCP

Хотите попробовать Bright Data MCP без какой-либо настройки?

Посетите эту игровую площадку на Smithery :

Эта платформа обеспечивает простой способ изучения возможностей Bright Data MCP без какой-либо локальной настройки. Просто войдите в систему и начните экспериментировать с веб-сбором данных!

💡 Примеры использования

Вот несколько примеров запросов, с которыми этот сервер MCP сможет помочь:

• «Поищите в Google фильмы, которые скоро выйдут в прокат в [вашем регионе]»
• «Какова текущая рыночная капитализация Tesla?»
• «Какая статья в Википедии сегодня?»
• «Какой прогноз погоды на 7 дней в [вашем местоположении]?»
• «Какова продолжительность карьеры трех самых высокооплачиваемых генеральных директоров технологических компаний?»

🎬 Демо

Для обучающих программ и демонстраций YouTube: Демо

В приведенных ниже видеороликах демонстрируется минимальный вариант использования Claude Desktop:

⚠️ Устранение неполадок

Тайм-ауты при использовании определенных инструментов

Некоторые инструменты могут подразумевать чтение веб-данных, и время, необходимое для загрузки страницы, может существенно различаться в экстремальных ситуациях.

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

Значение 180s должно быть достаточным для 99% запросов, но некоторые сайты загружаются медленнее других, поэтому настройте его в соответствии со своими потребностями.

спавн npx ENOENT

Эта ошибка возникает, когда ваша система не может найти команду npx . Чтобы исправить ее:

Поиск пути npm/Node

macOS:

Показывает путь типа /usr/local/bin/node

Окна:

Показывает путь типа C:\Program Files\nodejs\node.exe

Обновите конфигурацию MCP:

Замените команду npx на полный путь к Node, например, на Mac это будет выглядеть следующим образом:

👨‍💻 Вклад

Мы приветствуем вклады, которые помогут улучшить Bright Data MCP! Вот как вы можете помочь:

1. Сообщить о проблемах : Если вы столкнулись с какими-либо ошибками или у вас есть пожелания по функциям, пожалуйста, создайте проблему в нашем репозитории GitHub.
2. Отправка запросов на извлечение : смело делайте форк репозитория и отправляйте запросы на извлечение с улучшениями или исправлениями ошибок.
3. Стиль кодирования : Весь код JavaScript должен следовать соглашениям о кодировании JavaScript Bright Data . Это обеспечивает согласованность в кодовой базе.
4. Документация : улучшения документации, включая этот файл README, всегда приветствуются.
5. Примеры : Поделитесь своими вариантами использования, предоставив примеры, чтобы помочь другим пользователям.

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

📞 Поддержка

Если у вас возникли какие-либо проблемы или вопросы, обратитесь в службу поддержки Bright Data или создайте проблему в репозитории.