К основному содержанию
скилл CX Codex

brightdata-mcp — скилл для Claude Code: подключение и установка

Скилл brightdata-mcp для Claude Code помогает подключить инструменты Bright Data через MCP и выбрать, какие из них открыть агенту. Он включается при настройке MCP-клиента или правил выбора инструментов.

MIT 184 установок ★ 272 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add brightdata/skills --skill brightdata-mcp -a claude-code
Открыть на GitHub

Что делает brightdata-mcp

Скилл объясняет, как подключить Bright Data к приложению или агенту через MCP и настроить выбор инструментов во время работы. Он различает Remote-сервер Bright Data и Local-пакет @brightdata/mcp, описывает авторизацию и фильтры groups= и tools= для Remote и GROUPS и TOOLS для Local.

Для поиска данных с известного сайта он предлагает сначала найти готовый скрейпер, узнать его входные параметры и запустить его; содержимое страницы можно получить в Markdown. Скилл также помогает выбрать инструмент под задачу и направляет к инструкциям по настройке или маршрутизации. Нужен API-ключ Bright Data: Remote передаёт его через URL или OAuth 2.1, Local — через API_TOKEN. Названия инструментов и конфигурации Remote и Local могут различаться, поэтому рабочие настройки между вариантами не переносятся.

Какие задачи решает

  • подключить клиент MCP к Bright Data
  • выбрать между Remote и Local
  • ограничить список доступных инструментов
  • направить запрос к подходящему скрейперу

Примеры запросов агенту

  • Подключи Claude Code к Bright Data через MCP и помоги выбрать Remote или Local.
  • Настрой фильтр GROUPS для локального сервера Bright Data.
  • Подскажи, какой инструмент MCP использовать для извлечения содержимого страницы.

Как установить brightdata-mcp

1Через Skills CLI (Vercel)

npx skills add brightdata/skills --skill brightdata-mcp -a claude-code

2Вручную: положить файлы

~/.claude/skills/brightdata-mcp/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/brightdata-mcp/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о brightdata-mcp

Как установить brightdata-mcp в Claude Code?

Выполни npx skills add brightdata/skills --skill brightdata-mcp -a claude-code. Файл скилла находится по пути ~/.claude/skills/brightdata-mcp/SKILL.md.

Что делает brightdata-mcp?

Скилл помогает подключить сервер Bright Data через MCP, настроить список инструментов и направлять запросы к нужному скрейперу. Он описывает варианты Remote и Local.

Что нужно для работы brightdata-mcp?

Нужен API-ключ аккаунта Bright Data. Remote принимает ключ через URL либо OAuth 2.1, а Local использует переменную API_TOKEN.

Исходный текст

SKILL.md · MIT
---
name: brightdata-mcp
description: Bright Data's MCP server, the tool layer that gives an LLM agent live web access with no shell. Use when wiring Bright Data tools into an AI app or agent framework that picks its tools at run time, when connecting Claude, Cursor, or another MCP client to Bright Data, when choosing which MCP tools or groups to turn on, or when the user says MCP. Covers the Remote server hosted at mcp.brightdata.com and the Local self-hosted @brightdata/mcp package, and which tool each job should route to. Not for the agent doing the job itself from a shell, which is brightdata-cli. Not for fixed repeated code in an app, which is brightdata-sdk. Not for install or auth problems, which is agent-onboarding.
---

# Bright Data MCP

MCP is the interface for an AI app that decides at run time what to fetch. The
model reads a list of Bright Data tools and picks one per turn. There is no
shell to run and no code path to edit between turns, so the tool list you expose
and the routing rules you write are the entire product surface.

If a human or a coding agent is going to run the work from a terminal, that is
`brightdata-cli`. If the same job runs on a schedule from your own code, that is
`brightdata-sdk`. MCP is for run-time choice.

## Two variants that have drifted

Bright Data ships two, and the vendor calls them Remote (the hosted service at
`mcp.brightdata.com`) and Local (the self-hosted `@brightdata/mcp` package).

| | Remote | Local |
|---|---|---|
| Endpoint | `https://mcp.brightdata.com/mcp` (Streamable HTTP) or `/sse` | `npx @brightdata/mcp` over stdio |
| Auth | `?token=` on the URL for a client you control, or OAuth 2.1 (Bearer header, browser sign-in) when someone else runs the client | `API_TOKEN` env var |
| Tool config | URL query params `groups=` and `tools=` | env vars `GROUPS` and `TOOLS` |
| Default tool list | every tool on, 31 of them; `groups=` or `tools=` narrows it | every tool on, 32 of them; `GROUPS` or `TOOLS` narrows it |

The published package is `@brightdata/mcp`. Remote tracks its
own release line. Do not assume a tool name present in one is present in the
other, and do not carry a working config across. Confirm against the variant
actually in use.

## The key

Both `?token=` and `API_TOKEN` take the account API key. Find it the way the
CLI does: `BRIGHTDATA_API_KEY` if set, else `api_key` in the `credentials.json`
that `bdata login` writes (Linux `~/.config/brightdata-cli/`, macOS
`~/Library/Application Support/brightdata-cli/`, Windows
`%USERPROFILE%\AppData\Roaming\brightdata-cli\`). After login the variable is normally empty and
the key is only in the file: that is a logged-in machine, not a missing key,
so read it in code and never print it. To check that it exists, run
`node scripts/check-auth.mjs` from the `agent-onboarding` skill (it never
prints the key); never `cat`, `echo` or `jq` the file or the variable. To
pass it into a config or URL, read it inside the program or command that writes
the config, and keep it out of anything that prints (the shell-specific reads
are in that skill's `references/auth.md`). Neither exists: hand off to
`agent-onboarding`. Never ask the user to paste a key into chat.

## The routing default

Records from a site the agent can name go to a pre-built scraper:
`search_scrapers` to find it, `get_scraper_details` to see its inputs, then
`run_scraper`. Page content goes to `scrape_as_markdown`. Raw unlocked HTML through `scrape_as_html`
is the last resort, not the opening move. This is the misroute that burns the
most tokens and returns the worst data, so read the rule before writing prompts
or tool descriptions.

## References

- **references/setup.md** - open when connecting a client for the first time,
  when the agent sees the wrong number of tools, or when deciding between Remote
  and Local. Covers both installs, auth, zones, and the `GROUPS` and `TOOLS`
  filters.
- **references/choosing-tools.md** - open before writing the system prompt or
  tool guidance for an agent, or when an agent is scraping raw HTML for data a
  ready scraper already returns. Covers the full tool inventory and the routing
  table.

© brightdata · MIT · brightdata/skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
BrightData danielmiessler Скилл достаёт содержимое веб-страниц в markdown, поднимаясь от curl через браузер до Bright Data только там, где нужно. Умеет краулить целые сайты. CX Codex +1 ★ 19 959звёзд репо brightdata-local-search davila7 Скилл brightdata-local-search разворачивает локальный поисковик на базе Bright Data SERP API: расширение запроса, сбор выдачи, переранжирование RRF. CX Codex +1 625установок brightdata-web-mcp patchy631 Скилл brightdata-web-mcp для поиска в интернете, парсинга сайтов и извлечения данных через Bright Data. Обходит блокировки и CAPTCHA, работает с Amazon, eBay, LinkedIn, Instagram. CX Codex +1 ★ 42 059звёзд репо search davila7 Скилл search для Claude Code ищет страницы через SERP API Bright Data и возвращает структурированные результаты. Агент подключает его для поиска в Google. CX Codex +1 851установок SparkForge henry-ships MCP-сервер SparkForge с инструментами для скриншотов, скрейпинга, OCR и конвертации форматов. Ещё генерирует картинки и отдаёт крипто-данные. CX Codex +1 219 896установок llm-public-opinion-analytics reason-machines Скилл llm-public-opinion-analytics для сбора трендов из поисковых рейтингов 15 платформ, кластеризации тем и анализа тональности через LLM. Пригодится при настройке мониторинга инфополя с уведомлениями в мессенджеры. CX Codex +1 2 300установок

Из того же набора14

Весь набор →
scraper-builder Скилл scraper-builder ведёт от «хочу данные с сайта X» до рабочего скрапера: разбор страницы, выбор API Bright Data, селекторы, пагинация. CX Codex +1 415установок design-mirror Скилл design-mirror для Claude Code снимает визуальные особенности сайта по URL и переносит их в существующий код, чтобы интерфейс повторял стиль страницы. CX Codex +1 353установок fetch Скилл fetch для Claude Code забирает контент одной веб-страницы в виде Markdown, HTML или скриншота. Обходит защиту от ботов и статус 403 через Bright Data Web Unlocker. CX Codex +1 186установок billing Скилл billing для Claude Code и Codex помогает узнать баланс аккаунта Bright Data, траты по зонам и рассчитать примерную стоимость задач. CX Codex +1 185установок browser Скилл browser подключает существующие браузерные сценарии к облачной инфраструктуре. Он перенаправляет трафик драйверов типа Playwright, Puppeteer или Selenium через удалённый прокси-сервер. CX Codex +1 183установок instagram Собирает данные профилей, публикаций, Reels и комментариев Instagram в JSON. Запускается на запросы о подписчиках аккаунта, лайках или последних публикациях. CX Codex +1 182установок datasets Скилл datasets для Claude Code, который находит готовые наборы данных в маркетплейсе вместо запуска парсинга. Используется для получения огромных общих корпусов данных, если допустима их многомесячная давность. CX Codex +1 180установок brightdata-plugin Плагин brightdata-plugin для Claude Code ищет страницы через Google, собирает их содержимое и извлекает структурированные данные. Обеспечивает агента актуальными сведениями из интернета. ★ 272звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой