brightdata-sdk — скилл для Claude Code: что делает и как установить
Скилл brightdata-sdk для Claude Code помогает писать код на Python и Node.js для скрапинга страниц и SERP, Web Unlocker и Scraper Studio. Он помогает повторять задачи в репозитории.
MIT 466 установок ★ 272 обновлён 2026-10-15
npx skills add brightdata/skills --skill brightdata-sdk -a claude-codeЧто делает brightdata-sdk
brightdata-sdk подсказывает, как использовать пакеты Bright Data из прикладного кода. Python-пакет brightdata-sdk подходит для асинхронного кода, а пакет Node.js @brightdata/sdk использует camelCase и требует закрывать клиент через close() или await using.
Скилл охватывает загрузку страниц, поиск в SERP, платформенные скраперы, crawler, доступ к датасетам, Browser API и Scraper Studio. Он помогает выбрать справочник по файлам проекта: pyproject.toml и .py ведут к Python, а package.json, .js, .mjs и .ts — к Node.js. Оба SDK сначала читают BRIGHTDATA_API_TOKEN, затем BRIGHTDATA_API_KEY, а после используют сохранённые CLI-учётные данные.
При первом обращении SDK может создать зоны sdk_unlocker и sdk_serp в аккаунте. Для разовой проверки в терминале предназначен brightdata-cli, а выбор инструментов во время работы AI-приложения относится к brightdata-mcp.
Какие задачи решает
- написать повторяемый скрапер на Python или Node.js
- добавить поиск в SERP в серверный код
- собрать ETL-шаг с доступом к датасетам
- обернуть Bright Data в собственный API
- подключить Browser API или Scraper Studio
Примеры запросов агенту
- Напиши Python-код для регулярного сбора страниц через
brightdata-sdkи возьми токен из переменной окружения. - Добавь в сервис на Node.js поиск в SERP через
@brightdata/sdk, а клиент закрой после выполнения. - Разбери проект и выбери справочник SDK по его файлам, затем подключи вызов Bright Data к ETL-пайплайну.
Как установить brightdata-sdk
1Через Skills CLI (Vercel)
npx skills add brightdata/skills --skill brightdata-sdk -a claude-code2Вручную: положить файлы
~/.claude/skills/brightdata-sdk/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/brightdata-sdk/
1Через Skills CLI (Vercel)
npx skills add brightdata/skills --skill brightdata-sdk -a codex2Вручную: положить файлы
.agents/skills/brightdata-sdk/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add brightdata/skills --skill brightdata-sdk -a cursor2Вручную: положить файлы
.cursor/skills/brightdata-sdk/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install brightdata/skills skills/brightdata-sdk2Вручную: положить файлы
.github/skills/brightdata-sdk/SKILL.md1Через Skills CLI (Vercel)
npx skills add brightdata/skills --skill brightdata-sdk -a gemini-cli2Командой платформы
gemini skills install https://github.com/brightdata/skills --path skills/brightdata-sdkВручную: положить файлы
.devin/skills/brightdata-sdk/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add brightdata/skills --skill brightdata-sdk -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о brightdata-sdk
Как установить brightdata-sdk в Claude Code?
Выполните npx skills add brightdata/skills --skill brightdata-sdk -a claude-code, затем проверьте файл ~/.claude/skills/brightdata-sdk/SKILL.md.
Что делает brightdata-sdk?
Скилл помогает использовать Python- и Node.js-пакеты Bright Data в коде, который запускается повторно: в пайплайне, cron-задаче или сервере.
Какие переменные нужны для авторизации SDK?
Сначала SDK читают BRIGHTDATA_API_TOKEN, затем принимают BRIGHTDATA_API_KEY. Также они могут использовать учётные данные, сохранённые Bright Data CLI.
Исходный текст
SKILL.md · MIT
---
name: brightdata-sdk
description: Bright Data's Python and Node.js SDKs for calling Web Scraper API, SERP, Web Unlocker and Scraper Studio from application code. Use when the user is writing code they keep that calls Bright Data on a schedule or inside a pipeline, when the same job runs again and again, when a Bright Data package is imported in Python or Node.js, when the user wants their own API or service built on top of Bright Data ("build me a scraper API", "wrap this in an endpoint"), or when the user names the SDK. Not for one-off checks typed at a shell, which belong to brightdata-cli. Not for an AI app that chooses its tools at run time, which belongs to brightdata-mcp. Not for install, login or API key problems, which belong to agent-onboarding.
---
# Bright Data SDKs
Two published packages, one skill. The request is the same in both languages, so follow the language the repo already uses.
| Language | Package | Registry | Install |
|---|---|---|---|
| Python | `brightdata-sdk` | PyPI | `pip install brightdata-sdk` |
| Node.js | `@brightdata/sdk` | npm | `npm install @brightdata/sdk` |
## Which reference to open
- A `pyproject.toml`, a `requirements.txt` or `.py` files are in the project: open `references/python.md`.
- A `package.json` or `.js`, `.mjs` and `.ts` files are in the project: open `references/nodejs.md`.
- Both languages are present and neither clearly owns the job: ask which runtime will run it, then open that one file.
## When the SDK is the right surface
The user keeps the code. A cron job, a backend service, an ETL step, an enrichment pipeline: anything where the same call runs again and again from a file under version control. Reach for the SDK the moment a Bright Data call is going to live in a repo rather than in a terminal.
Two neighbours own the other cases. A one-off check typed at a shell is `brightdata-cli`. An AI app that picks its tools at run time is `brightdata-mcp`.
## Auth
Install, login and API key problems belong to `agent-onboarding`, which owns credential paths and what a refused call means. See its `references/auth.md`.
The one fact this skill needs: both SDKs read `BRIGHTDATA_API_TOKEN` first, accept `BRIGHTDATA_API_KEY` as an alternate, and fall back to the credentials the Bright Data CLI stored at login. Never write a key into source. Both reference files show the key coming from the environment. To check that a key exists, run `node scripts/check-auth.mjs` from the `agent-onboarding` skill; never `cat`, `echo` or `jq` the credentials file or the variable, because whatever a command prints lands in the conversation and its logs.
## What both packages cover
Page fetch, SERP search, per-platform scrapers, a crawler, dataset access, Browser API connect strings, and a Scraper Studio namespace. The shape differs by language: Python is async first and uses snake_case, Node.js uses camelCase and has to be closed, either with `close()` by hand or with `await using` on modern runtimes. Read the reference file rather than translating method names by hand.
By default both SDKs create the zones `sdk_unlocker` and `sdk_serp` in the account when they are missing: Python when the client opens, Node on the first call that uses each zone. Tell the user before running code that will do that. Each reference file shows how to turn auto-creation off and use the account's own zones.
© brightdata · MIT · brightdata/skills