이 글에서 배울 내용:
- Bright Data 스킬이란 무엇인지.
- 스킬이 유용한 이유와 AI 코딩 에이전트 및 어시스턴트를 어떻게 지원하는지.
- 웹 검색, 스크래핑 등을 위한 구체적인 스킬 목록.
skills, Bright Data CLI, 또는 수동으로 AI 에이전트 설정에 설치하는 방법.- 실용적인 프롬프트 예시로 최대한 활용하는 방법.
지금 바로 시작해봅시다!
Bright Data 스킬이란?
Bright Data 스킬은 AI 코딩 에이전트가 Bright Data의 제품 및 서비스에 대한 지식을 습득할 수 있도록 합니다.
이 스킬들은 Anthropic이 정의한 Agent Skills 표준 사양을 따르며 40개 이상의 AI 코딩 솔루션에서 지원됩니다. 스킬은 에이전트가 더 정확하고 효율적으로 작업을 수행할 수 있도록 발견하고 사용할 수 있는 지침, 스크립트, 리소스가 포함된 구조화된 폴더입니다.
공식 GitHub 저장소에 나와 있는 것처럼, Bright Data 스킬의 폴더 구조는 다음과 같습니다:
skills/
├── scrape/
│ ├── SKILL.md # Instructions + metadata loaded by the agent
│ └── scripts/
│ └── search.sh # Executable script that the agent can run
│
├── # other skills...
│
├── bright-data-mcp/
│ ├── SKILL.md
│ └── references/ # MCP tool reference docs
└── bright-data-best-practices/
├── SKILL.md # API selection guide + auth patterns + code examples
└── references/
├── web-unlocker.md # Full Web Unlocker API reference
├── serp-api.md # Full SERP API reference
├── scrapers.md # Full Web Scraping APIs reference
└── browser-api.md # Browser API reference스킬은 에이전트에게 모범 사례, 파라미터 지식, Bright Data 솔루션에 연결하기 위한 실행 가능한 셸 스크립트를 제공합니다.
Bright Data 스킬은 코딩 에이전트가 웹 스크래핑을 통해 웹 데이터에 접근하고, 인기 도메인에서 데이터 피드를 가져오고, 검색을 수행하고, 웹 페이지와 상호작용하는 등의 기능을 지원합니다.
코딩 에이전트에 웹 접근이 필요한 이유
AI 코딩 에이전트 뒤에 있는 LLM이 아무리 강력하더라도, 모든 언어 모델이 공유하는 근본적인 한계인 지식의 구식화 문제는 여전히 존재합니다. LLM은 학습된 데이터를 기반으로만 응답을 생성할 수 있으며, 이는 특정 시점의 고정된 스냅샷을 나타냅니다.
기술 환경이 빠르게 진화하는 만큼 이는 심각한 문제입니다. LLM이 구식 코딩 관행을 제안하거나, 더 이상 사용되지 않는 메서드에 의존하거나, 새로 출시된 기능을 놓치는 경우가 흔합니다.
이 한계를 극복하려면 AI 코딩 에이전트를 실시간 웹 접근으로 확장하세요. 이것이 바로 Bright Data 스킬이 제공하는 기능입니다. 통합되면 에이전트는 다음을 수행할 수 있습니다:
- 검색, 스크래핑, 구조화된 데이터 추출에 적합한 API를 식별합니다.
- Bright Data API에 연결할 때 인증하고 요청을 올바르게 구성합니다.
- 페이지네이션, 오류, 엣지 케이스를 효과적으로 처리합니다.
- 웹 검색 및 스크래핑과 같은 작업을 수행하는 실제 셸 스크립트를 실행합니다.
이를 통해 에이전트는 자율적으로 다음을 수행할 수 있게 됩니다:
- 문서 페이지, Stack Overflow, 포럼 등 적절한 온라인 소스에서 최신 정보를 검색합니다.
- 스크립트를 풍부하게 하기 위한 실제 웹 데이터를 검색합니다(예: 데이터베이스 채우기 또는 응답 모킹).
- 추가 읽기 자료나
README.md파일 지원을 위한 관련 링크를 제안합니다. - 다양한 실제 사용 사례를 처리합니다.
Bright Data가 특별한 이유는 4억 개 이상의 주거용 프록시 IP로 지원되는 강력한 네트워크 인프라를 기반으로 제품이 구축되었기 때문입니다. 이를 통해 99.99% 가동 시간과 99.95% 성공률을 달성하면서 무제한 확장성을 실현합니다.
Bright Data 스킬은 개방형 Agent Skills 생태계의 일부이며 40개 이상의 AI 코딩 어시스턴트에서 지원됩니다.
Bright Data 스킬: 전체 목록
다음 표에서 모든 Bright Data 스킬을 살펴보세요:
| 스킬 | 설명 | Bright Data 제품 |
|---|---|---|
search |
Google을 검색하고 Bright Data SERP API를 사용하여 제목, 링크, 설명이 포함된 구조화된 JSON 결과를 가져옵니다. 페이지네이션을 지원합니다. | SERP API |
scrape |
Web Unlocker API를 사용하여 자동 봇 탐지 우회, CAPTCHA 해결, JavaScript 렌더링으로 모든 웹페이지를 깔끔한 마크다운으로 스크래핑합니다. | Web Unlocker API |
data-feeds |
Amazon, LinkedIn, Instagram, TikTok, YouTube, eBay, Walmart 등 40개 이상의 웹사이트에서 자동 폴링으로 구조화된 데이터를 추출합니다. | Web Scraping APIs |
bright-data-mcp |
검색, 스크래핑, 구조화된 추출, 브라우저 자동화를 위한 60개 이상의 Bright Data MCP 도구를 조율합니다. | Web MCP |
scraper-builder |
사이트 분석, API 선택, 선택자 추출, 페이지네이션, 완전한 구현을 포함하여 프로덕션 수준의 스크래퍼를 구축하도록 에이전트를 안내합니다. | Web Scraper API/Python SDK |
bright-data-best-practices |
Web Unlocker, SERP API, Scraper API, Browser API에 대한 내장 참조. Claude가 Bright Data 코드를 생성할 때 자동으로 참조합니다. | , |
python-sdk-best-practices |
비동기/동기 클라이언트, 스크래퍼, SERP, 데이터셋, Browser API, 오류 처리, 일반적인 코딩 패턴을 포함한 brightdata-sdk Python 패키지 가이드. |
Python SDK |
brightdata-cli |
터미널에서 직접 스크래핑, 검색, 데이터 추출, 프록시 관리, 계정 사용량 모니터링을 위한 Bright Data CLI 사용 지침. | Bright Data CLI |
competitive-intel |
경쟁사 스냅샷, 가격 비교, 리뷰 분석, 채용 신호, 콘텐츠, SEO 인사이트, 시장 매핑을 통한 실시간 경쟁 인텔리전스를 제공합니다. | Bright Data CLI |
design-mirror |
일관되고 고품질의 사용자 인터페이스를 구축하는 데 도움이 되도록 디자인 시스템 패턴, 토큰, 컴포넌트를 복제합니다. | Web Unlocker API |
brd-browser-debug |
Browser Sessions API를 통해 장애 분류, 세션별 대역폭 추적, CAPTCHA 보고, 패턴 감지로 Bright Data Scraping Browser 세션을 디버그합니다. | Browser API |
중요: 각 스킬에 대해 자세히 알아보려면 공식 저장소를 확인하세요. 스타를 남겨 프로젝트를 지원하고 최신 업데이트를 받아보세요!
코딩 에이전트 및 어시스턴트에 Bright Data 스킬 추가하는 방법
각 코딩 에이전트마다 스킬을 로드하는 방식이 다를 수 있지만, 설치 과정을 간소화하는 방법이 있습니다. Bright Data 스킬을 추가하는 세 가지 주요 방법은 다음과 같습니다:
- Vercel
skills도구를 통해 (권장):skills는 Vercel이 개발한 스킬 설치 및 관리 CLI입니다. 안내형 설정을 제공하며 40개 이상의 AI 에이전트 프레임워크를 지원합니다. - Bright Data CLI를 통해: 지원되는 AI 코딩 도구에서 스킬 설치 및 구성을 간소화하는 전용 명령어를 포함합니다.
- 수동 구성을 통해: AI 코딩 에이전트에서 요구하는 디렉토리에 Bright Data 스킬 폴더를 복사하여 붙여넣습니다.
처음 두 가지 방법은 안내형이고 자동화되어 있어 사용하기 쉽지만 제어 범위가 제한됩니다. 수동 방법은 더 많은 노력이 필요하지만 설정에 대한 완전한 제어권을 제공합니다.
다음 섹션에서는 Claude Code에서 각 방법을 사용하는 방법을 설명합니다! (참고: 스킬을 지원하는 다른 AI 코딩 에이전트에서도 동일한 지침이 적용됩니다.)
공통 사전 요구사항
AI 코딩 에이전트에 Bright Data 스킬을 추가하는 방법에 관계없이 따라야 할 공통 단계가 있습니다. 살펴보겠습니다!
요구사항
선택한 AI 에이전트에서 Bright Data 스킬이 작동하려면 다음이 필요합니다:
.sh스크립트를 실행할 수 있는 Unix 기반 운영 체제(Linux, macOS 또는 WSL).- 필요한 존과 API 키가 설정된 Bright Data 계정. (다음 단계에서 안내됩니다.)
- Agent Skills를 지원하는 40개 이상의 AI 에이전트 중 하나에 대한 접근.
- 로컬에 설치된
jq패키지.
Debian 기반 시스템에서 jq(sed와 유사한 JSON 처리 도구)를 설치하려면 다음을 실행하세요:
sudo apt-get install curl jq또는 macOS에서 동일하게:
brew install curl jqBright Data 계정 설정
Bright Data 스킬이 사용하는 셸 스크립트에는 다음 두 가지 환경 변수가 필요합니다:
BRIGHTDATA_API_KEY: Bright Data API 인프라에 대한 HTTP 요청 인증에 사용됩니다.BRIGHTDATA_UNLOCKER_ZONE: 웹 스크래핑 기능을 활성화하는 Bright Data Web Unlocker API 존에 연결하는 데 사용됩니다(SERP API로도 작동하므로 웹 검색도 가능).
간단히 말해, 시작하려면 Bright Data 계정, Web Unlocker API 존, API 키가 필요합니다. 이 섹션에서 모두 설정하는 방법을 안내합니다.
빠른 설정을 위해 문서의 “첫 번째 Unlocker API 만들기” 가이드를 참조하세요. 또는 아래 지침을 따르세요.
Bright Data 계정이 없다면 계정을 만드세요. 있다면 로그인하세요. 제어판에 접속하여 “Proxies & Scraping” 페이지로 이동하고 “My Zones” 테이블을 확인하세요:
Web Unlocker API 존(예: 이 경우 web_unlocker)이 이미 존재하면 API 키 생성으로 넘어갈 준비가 된 것입니다.
존재하지 않는다면 생성하세요. “Unblocker API” 섹션으로 스크롤하여 “Create zone” 버튼을 클릭하세요:
존에 명확한 이름을 선택하고 존이 활성화될 때까지 마법사를 완료하세요.
마지막으로 공식 가이드에 따라 Bright Data API 키를 생성하세요.
존 이름과 API 키를 모두 확보했으면 Unix 기반 시스템에서 필요한 환경 변수를 정의하세요:
export BRIGHTDATA_API_KEY="<YOUR_BRIGHT_DATA_API_KEY>"
export BRIGHTDATA_UNLOCKER_ZONE="<YOUR_BRIGHT_DATA_WEB_UNLOCKER_API_ZONE_NAME>"플레이스홀더를 방금 검색하거나 구성한 값으로 교체하면 준비가 완료됩니다!
방법 #1: Vercel skills 도구를 통해
AI 코딩 에이전트(지원되는 40개 이상 중)에 Bright Data 스킬을 추가하는 권장 방법은 Vercel skills 패키지를 이용하는 것입니다. 활용 방법을 살펴보세요!
사전 요구사항
이 섹션을 따르려면 다음이 필요합니다:
- Node.js가 로컬에 설치되어 있어야 합니다.
단계 #1: 스킬 설치
프로젝트 디렉토리로 이동하세요. 아래 명령어를 실행하여 로컬 AI 코딩 에이전트에 Bright Data 스킬을 추가하는 마법사를 시작하세요:
npx skills add brightdata/skills이 명령어는 필요한 경우 설치하면서 skills npm 패키지를 실행하고 Agent Skills Directory에서 지정된 스킬을 검색합니다.
참고: brightdata/skills는 Agent Skills Directory에서 Bright Data 스킬의 이름입니다.
설치할 특정 스킬을 선택하라는 메시지가 표시됩니다:
스페이스바를 눌러 스킬을 하나씩 토글한 다음 Enter를 누르세요:
다음으로, 스킬을 설치할 AI 에이전트를 선택하라는 메시지가 표시됩니다:
기본적으로 Amp, Antigravity, Cline, Codex 등의 에이전트가 선택되어 있습니다. Claude Code에 설치하려면 스페이스바로 토글하고 Enter를 누르세요.
참고: 다음을 사용하여 Claude Code에 직접 스킬을 설치할 수 있습니다:
npx skills list -a claude-codeskills는 스킬을 프로젝트에 로컬로 설치할지 전역으로 설치할지 물어봅니다:
사용 사례에 맞는 옵션을 선택하세요.
설치 방법으로는 심볼릭 링크를 권장합니다:
이 옵션은 스킬을 공통 폴더에 추가하고 프로젝트에 링크하여, 원본 폴더를 단일 진실 소스로 유지합니다.
마지막으로 “Installation Summary” 및 “Security Risk Assessment” 섹션이 표시됩니다. 검토 후 “Yes”를 입력하여 계속하세요. 그러면 다음과 같은 확인 메시지가 표시됩니다:
축하합니다! Bright Data 스킬이 선택한 AI 코딩 에이전트 및 어시스턴트에 추가되었습니다.
단계 #2: 스킬 설치 확인
스킬이 Claude Code 로컬 설정에 성공적으로 추가되었는지 확인하려면 다음을 실행하세요:
npx skills list -a claude-code다음과 같은 목록이 표시됩니다:
이전에 선택한 모든 Bright Data 스킬이 포함되어 있음을 확인하세요.
또는 Claude Code를 열고 다음 명령어를 입력하세요:
/skills결과에 이전에 선택한 Bright Data 스킬 목록이 다시 표시됩니다:
훌륭합니다! Bright Data 스킬이 이제 Claude Code(또는 선호하는 AI 코딩 에이전트)에서 사용 가능합니다.
다음 단계: 스킬 업데이트
Bright Data 스킬은 향후 업데이트를 받을 가능성이 높습니다. 업데이트를 확인하려면 다음을 실행하세요:
npx skills check업데이트가 있는 경우(즉, npx skills add brightdata/skills로 마지막으로 클론한 이후 Bright Data 스킬 저장소가 변경된 경우), 다음으로 업데이트를 가져오세요:
npx skills update좋습니다! Bright Data 스킬이 이제 최신 버전으로 업데이트됩니다.
방법 #2: Bright Data CLI를 통해
Bright Data CLI는 전체 Bright Data 표면에 대한 간소화된 접근을 제공하는 올인원 터미널 도구입니다. 다양한 명령어 중에 스킬 설치를 위한 명령어도 포함되어 있습니다. 사용 방법을 알아보세요!
사전 요구사항
계속하기 전에 아래 요구사항을 충족하는지 확인하세요:
- Bright Data CLI가 로컬에 설치되고 계정에 연결되어 있어야 합니다.
스킬 설치
Bright Data CLI를 통해 대화형으로 스킬을 선택하고 설치하려면 다음을 실행하세요:
brightdata skill add설치할 스킬을 선택할 수 있는 대화형 선택기가 시작됩니다:
스페이스바로 토글하여 모든 스킬을 선택하세요:
다음으로, 스킬을 설치할 AI 에이전트를 선택하세요. 이 경우 Claude Code를 선택합니다:
토글된 스킬들이 하나씩 검색되어 선택한 코딩 에이전트에 설치됩니다:
훌륭합니다! 로컬 Claude Code 설정에 이제 Bright Data 스킬이 포함되었습니다.
방법 #3: 수동 구성을 통해
스킬은 단순한 폴더입니다. 따라서 구성을 위해 AI 코딩 에이전트의 필수 디렉토리에 수동으로 복사하여 붙여넣을 수 있습니다.
먼저 Bright Data 스킬의 GitHub 저장소를 클론하세요:
git clone https://github.com/brightdata/skillsskills/ 폴더에는 이제 다음이 포함됩니다:
skills/
├── .claude-plugin/
├── skills/
│ ├── bright-data-best-practices/
│ ├── bright-data-mcp/
│ ├── brightdata-cli/
│ ├── data-feeds/
│ ├── design-mirror/
│ ├── python-sdk-best-practices/
│ ├── scrape/
│ ├── scraper-builder/
│ └── search/
├── .gitignore
├── LICENSE
└── README.md다음으로, skills/skills/에서 스킬 폴더(예: bright-data-best-practices/, bright-data-mcp/ 등)를 AI 에이전트 구성에 필요한 디렉토리에 복사하세요.
예를 들어, Claude Code 프로젝트에 복사하려면 다음을 실행하세요:
cp -r skills/skills/* <PATH_TO_YOUR_PROJECT>/.claude/skills/다른 AI 코딩 에이전트를 사용하는 경우, Bright Data 스킬이 배치되어야 할 올바른 폴더를 찾기 위해 해당 공식 문서를 참조하세요. 완료!
Bright Data 스킬 활용 사례
이제 Bright Data 스킬 통합을 통해 AI 코딩 에이전트가 얻는 기능을 살펴볼 시간입니다. 지원되는 많은 사용 사례 중에서 주요 사례에 집중하고 프로젝트에서 실행할 수 있는 실제 프롬프트를 제시합니다.
웹 검색
AI 에이전트는 이제 search 스킬을 통해 실시간으로 웹을 검색하고 구조화된 결과를 검색할 수 있습니다.
샘플 프롬프트:
"Matplotlib을 사용한 데이터 시각화에 관한 최신 Python 튜토리얼을 찾아 data-analysis.ipynb 노트북의 차트를 개선하세요"."Python에서 API 인증 모범 사례에 관한 최근 기사를 검색하고 현재 인증 레이어의 핵심 단계를 요약하세요"."대화형 대시보드 구축을 위한 최신 JavaScript 프레임워크를 찾아 프로젝트에 통합할 수 있는 예제 코드 스니펫을 제공하세요".
웹 스크래핑
코딩 어시스턴트는 이제 scrape 스킬을 통해 모든 웹페이지를 스크래핑하고 깔끔한 마크다운 콘텐츠를 얻을 수 있습니다.
샘플 프롬프트:
"이 이커머스 페이지 'https://www.gucci.com/us/en/ca/women/handbags-c-women-handbags'에서 상품 목록을 스크래핑하고 추출된 데이터로 'products' 테이블을 채우는 SQL 쿼리를 생성하세요"."이 공식 Python 포럼 페이지 'https://python-forum.io/forum-44.html'에서 최근 게시물을 스크래핑하고 주요 토론을 요약하세요".
웹 데이터 피드
AI 에이전트는 data-feeds 스킬을 사용하여 40개 이상의 도메인에서 구조화된 JSON 데이터를 가져올 수 있습니다. 데이터베이스 채우기, 모의 응답 정의, 데이터 분석 파이프라인 지원에 이상적입니다.
샘플 프롬프트:
"이 Amazon 상품 페이지 'https://www.amazon.com/Apple-Bluetooth-Headphones-Personalized-Effortless/dp/B0DGHMNQ5Z/'에서 데이터를 가져와 /api/v1/products/B0DGHMNQ5Z 엔드포인트의 응답을 모킹하는 데 사용하세요"."이 YouTube 동영상 '<YOUTUBE_VIDEO_URL>'에서 동영상 통계와 댓글을 가져와 참여 지표를 계산하고 감성 분석을 수행하세요".
디자인 미러
AI 에이전트는 design-mirror 스킬을 통해 소스 자료에서 디자인 시스템 패턴, 토큰, UI 컴포넌트를 복제하여 일관된 UI 품질을 유지할 수 있습니다.
샘플 프롬프트:
"이 웹사이트 '<WEBSITE_URL>'에서 색상 팔레트, 타이포그래피, 버튼 스타일을 미러링하여 재사용 가능한 CSS/React 컴포넌트 라이브러리를 만드세요".주어진 Figma 프로젝트 '<PUBLIC_FIGMA_PROJECT_URL>'에서 디자인 토큰을 추출하고 웹 앱에서 재사용하기 위한 JSON 구성을 생성하세요".
웹 스크래퍼 구축
AI 에이전트는 scraper-builder 스킬을 사용하여 프로덕션 수준의 스크래퍼를 생성할 수 있습니다.
샘플 프롬프트:
"이 이커머스 사이트 '<WEBSITE_URL>'를 위한 스크래퍼를 구축하여 모든 상품에서 상품명, 가격, 재고 가용성을 추출하세요"."이 블로그 '<BLOG_URL>'에서 모든 기사를 스크래핑하고 제목, 작성자, 내용, 날짜를 추출하는 스크립트를 생성하세요".
고급 사용 사례
AI 에이전트는 여러 스킬(예: search + scrape)을 결합하여 복잡한 다단계 프롬프트를 처리할 수 있습니다.
샘플 프롬프트:
"AI 모델 보안에 관한 최근 기사를 검색하고 요약을 스크래핑하여 현재 프로젝트를 개선하기 위한 모범 사례를 제안하세요"."Amazon과 eBay에서 상품 목록을 수집하고 데이터를 병합하여 경쟁 분석을 위한 가격 차이를 강조하세요"."GitHub에서 인기 있는 Python 패키지를 찾아 README 파일을 가져와 사용 패턴을 요약하세요".
결론
이 블로그 포스트에서는 Bright Data 스킬이 제공하는 것, 중요한 이유, 설치 방법을 배웠습니다. 여기서 배운 내용을 바탕으로 AI 코딩 에이전트 및 어시스턴트를 엔터프라이즈 수준의 웹 데이터 접근 도구로 확장하는 방법을 알게 되었습니다. 이를 통해 정적 LLM 지식의 한계를 극복할 수 있습니다.
Bright Data 스킬을 통해 에이전트를 AI 기반 사용 사례를 위한 Bright Data 제품 및 서비스 전체 범위에 연결할 수 있습니다. 새로운 업데이트가 출시될 때 알림을 받으려면 공식 저장소에 스타를 남겨주세요!
오늘 무료로 Bright Data 계정을 만들고 AI 지원 웹 데이터 접근 솔루션으로 통합을 시작하세요!
FAQ
Bright Data 스킬이 지원하는 코딩 에이전트 및 어시스턴트는 무엇인가요?
Bright Data 스킬은 Anthropic의 Agent Skills 표준을 지원하는 모든 AI 에이전트 기술과 함께 사용할 수 있습니다. 여기에는 Amp, Kimi Code CLI, Replit, Universal, Antigravity, Augment, IBM Bob, Claude Code, OpenClaw, Cline, Warp, CodeBuddy, Codex, Command Code, Continue, Cortex Code, Crush, Cursor, Deep Agents, Droid, Firebender, Gemini CLI, GitHub Copilot, Goose, Junie, iFlow CLI, Kilo Code, Kiro CLI, Kode, MCPJam, Mistral Vibe, Mux, OpenCode, OpenHands, Pi, Qoder, Qwen Code, Roo Code, Trae, Trae CN, Windsurf, Zencoder, Neovate, Pochi, AdaL이 포함됩니다.
동일한 에이전트에서 스킬과 MCP를 함께 사용할 수 있나요?
물론입니다! AI 에이전트는 Bright Data Web MCP 서버에 연결하면서 Bright Data 스킬로 확장할 수 있습니다. Claude Desktop에서 이 설정을 구성하여 두 기능을 함께 사용하는 방법을 확인하세요. Bright Data 스킬에는 Web MCP 도구를 조율하여 더 나은 결과를 달성하기 위한 특정 bright-data-mcp 스킬이 포함되어 있습니다.
AI 코딩 에이전트 외부에서 Bright Data 스킬을 활용할 수 있나요?
네! 일부 스킬(예: scrape, search, data-feeds)은 직접 호출할 수 있는 전용 셸 스크립트와 함께 제공됩니다. GitHub 저장소를 클론하고, 클론된 폴더(cd skills/)로 이동하여 모든 사전 요구사항이 충족되었는지 확인하세요. 그런 다음 터미널에서 스크립트를 테스트하세요.
예를 들어 search 스킬을 직접 실행할 수 있습니다:
bash skills/search/scripts/search.sh "best chatgpt scrapers"결과는 SERP API를 통해 Google에서 스크래핑된 구조화된 SERP 데이터입니다:
공식 문서에서 추가 예시를 살펴보세요.
